Merge pull request #19 from CloudCannon/feat/port-placeholder

Add `toolproof_test_port` default placeholder

Author: bglw

CHANGELOG.md

@@ -9,6 +9,8 @@
 
 ## Unreleased
 
+* Added a `toolproof_test_port` default placeholder.
+
 ## v0.11.2 (March 20, 2025)
 
 * If the `I click {text}` action finds multiple options, but only one is an exact match, it will now click it rather than error.

docs/content/docs/_index.md

@@ -173,7 +173,8 @@ steps:
 
 Toolproof provides some placeholders by default:
 
-| placeholder                 | value                                                       |
-| --------------------------- | ----------------------------------------------------------- |
-| toolproof_process_directory | The working directory that you ran the Toolproof command in |
-| toolproof_test_directory    | The temporary directory that the current test is running in |
+| placeholder                 | value                                                            |
+| --------------------------- | ---------------------------------------------------------------- |
+| toolproof_process_directory | The working directory that you ran the Toolproof command in      |
+| toolproof_test_directory    | The temporary directory that the current test is running in      |
+| toolproof_test_port         | If serving files, the port that Toolproof is using for this test |

toolproof/src/segments.rs

@@ -165,6 +165,13 @@ impl<'a> SegmentArgs<'a> {
                     tmp_dir.path().to_string_lossy().into_owned(),
                 );
             }
+
+            if let Some(assigned_server_port) = &civ.assigned_server_port {
+                placeholders.insert(
+                    "toolproof_test_port".to_string(),
+                    assigned_server_port.to_string(),
+                );
+            }
         }
 
         if let Some(transient_placeholders) = transient_placeholders {