Skip to content

test: run the README's own commands through the parser, and fix one it caught - #7

Merged
tactino merged 1 commit into
mainfrom
test/documented-commands
Sep 12, 2026
Merged

tactino merged 1 commit into
mainfrom
test/documented-commands

Conversation

@tactino

@tactino tactino commented Sep 12, 2026

Copy link
Copy Markdown
Member

The same guard as PlugRL/plugrl-server#10, and it earned its place immediately.

What it found

The README documented --log-level debug on the env client. That flag has never existed here. It exists on plugrl-run-server, and the line was copied across. There is no verbosity mechanism on this side at all — grep -rn "log_level\|configure_logging" src/ returns nothing.

The site-wide audit had already gone through this repository and missed it, because reading a flag does not tell you whether it parses.

The README is corrected and says what happened, rather than quietly dropping the flag.

The guard

Every bash block is scanned for env-client invocations, continuations joined, each command handed to cli() with sys.argv patched. Environments behind an optional extra are skipped from the registry rather than from the error text.

It asserts up front that the regex matched at least three commands. That is not decoration: the first version of the pattern matched zero, because this README writes uv run plugrl-run-env-client and the pattern looked for the bare executable. The assertion is what surfaced that instead of reporting a clean pass over nothing.

🤖 Generated with Claude Code

…t caught

The same guard as plugrl-server's, and it earned its place immediately: the
README documented `--log-level debug` on the env client, which has never had
that flag. It exists on plugrl-run-server, and the line was copied from there.
The site audit had gone through this repository and missed it, because reading
a flag does not tell you whether it parses.

The README is corrected and says what happened rather than quietly dropping
the flag.

The test asserts up front that its regex matched at least three commands, since
one that matched nothing would make every case below pass - which is not
hypothetical here: the first version of the pattern missed every command in
this file, because they are written `uv run plugrl-run-env-client` and it
looked for the bare executable.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
@tactino
tactino merged commit 7192331 into main Sep 12, 2026
2 checks passed
@tactino
tactino deleted the test/documented-commands branch September 12, 2026 02:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant