Merge branch 'update-readme'

This commit is contained in:
Chris Wanstrath 2026-03-12 14:26:34 -07:00
commit 10e98e2dc5
2 changed files with 6 additions and 1 deletions

View File

@ -85,6 +85,7 @@ Options:
--path <path> Prepend <path> to PATH (repeatable) --path <path> Prepend <path> to PATH (repeatable)
--timeout <dur> Per-command timeout (default: "10s") --timeout <dur> Per-command timeout (default: "10s")
-v, --verbose Print each command as it runs -v, --verbose Print each command as it runs
--port-from <n> Auto-assign $PORT starting from n (default: "5400")
--parallel Run files in parallel --parallel Run files in parallel
-h, --help display help for command -h, --help display help for command
``` ```
@ -97,7 +98,9 @@ Options:
|---|---| |---|---|
| `HOME` | Path to the temp directory created for the test | | `HOME` | Path to the temp directory created for the test |
| `SHOUT_DIR` | Same as `HOME` — the temp directory for the test | | `SHOUT_DIR` | Same as `HOME` — the temp directory for the test |
| `PORT` | Auto-assigned when `--port-from <n>` is used (increments per file). Not set if `PORT` is already defined via `@env` or `@setup`. | | `SHOUT_SOURCE_DIR` | Directory containing the `.shout` file being run |
| `SHOUT_PROJECT_DIR` | The `cwd` where `shout` was invoked |
| `PORT` | Auto-assigned starting from `5400` (or the value of `--port-from`), increments per file. Not set if `PORT` is already defined via `@env` or `@setup`. |
### Inherited ### Inherited

View File

@ -229,6 +229,7 @@ Options:
--path &lt;path&gt; Prepend &lt;path&gt; to PATH (repeatable) --path &lt;path&gt; Prepend &lt;path&gt; to PATH (repeatable)
--timeout &lt;dur&gt; Per-command timeout (default: "10s") --timeout &lt;dur&gt; Per-command timeout (default: "10s")
-v, --verbose Print each command as it runs -v, --verbose Print each command as it runs
--port-from &lt;n&gt; Auto-assign $PORT starting from n (default: "5400")
--parallel Run files in parallel --parallel Run files in parallel
-h, --help display help for command</span></code></pre> -h, --help display help for command</span></code></pre>
</section> </section>
@ -240,6 +241,7 @@ Options:
<span class="bright">SHOUT_DIR</span> <span class="dim"></span> <span class="output">same temp directory</span> <span class="bright">SHOUT_DIR</span> <span class="dim"></span> <span class="output">same temp directory</span>
<span class="bright">SHOUT_SOURCE_DIR</span> <span class="dim"></span> <span class="output">directory containing the .shout file</span> <span class="bright">SHOUT_SOURCE_DIR</span> <span class="dim"></span> <span class="output">directory containing the .shout file</span>
<span class="bright">SHOUT_PROJECT_DIR</span> <span class="dim"></span> <span class="output">directory where shout was invoked</span> <span class="bright">SHOUT_PROJECT_DIR</span> <span class="dim"></span> <span class="output">directory where shout was invoked</span>
<span class="bright">PORT</span> <span class="dim"></span> <span class="output">auto-assigned from 5400 (or --port-from), increments per file</span>
<span class="bright">PATH</span> <span class="dim"></span> <span class="output">prepended with --path dirs, if any</span></code></pre> <span class="bright">PATH</span> <span class="dim"></span> <span class="output">prepended with --path dirs, if any</span></code></pre>
<p>Each file runs in its own temp directory. <code>--clean-env</code> starts with an empty environment instead of inheriting yours.</p> <p>Each file runs in its own temp directory. <code>--clean-env</code> starts with an empty environment instead of inheriting yours.</p>
</section> </section>