fix(cli): render the literal [suffix] in --tag help and rejection message (#3800)

Both places a user learns the `specify self upgrade --tag` syntax silently drop
the `[suffix]` token, because Rich parses the literal square brackets as a
markup tag and discards them:

    rejected tag -> "Invalid --tag: expected vMAJOR.MINOR.PATCH"
    (constant is  "Invalid --tag: expected vMAJOR.MINOR.PATCH[suffix]")

    --help       -> "Pin the target version (vX.Y.Z). Without --tag, ..."

So the CLI implies a bare vX.Y.Z is the ONLY accepted form, when v1.0.0-rc1,
v0.8.0.dev0 and v0.8.0+build.42 are all valid -- and the shipped docs advertise
the suffix in four places (docs/upgrade.md x3, README.md x2).

Escape the rejection message at the PRINT site rather than baking `\[` into
_INVALID_TAG_MESSAGE: the same constant is raised through typer.BadParameter,
which Click renders without Rich, so it must stay plain text. Escape the literal
bracket in the option help, which Typer renders through Rich.

Same literal-bracket class as the existing precedents in workflows/_commands.py
(`\[disabled]`, `\[<type>]`). Static CLI text only -- no validation semantics
change and `_validate_tag` is untouched.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ali jawwad
2026-07-29 18:54:10 +05:00
committed by GitHub
parent b7b0e966cc
commit f4a9b890cc
2 changed files with 33 additions and 2 deletions

View File

@@ -472,6 +472,26 @@ class TestTagValidation:
output = strip_ansi(result.output)
assert "Invalid --tag" in output or "expected vMAJOR.MINOR.PATCH" in output
def test_rejection_message_keeps_the_suffix_token(
self, uv_tool_argv0, clean_environ
):
"""Rich must not swallow the literal `[suffix]`.
Unescaped it is parsed as a style tag and dropped, so the user is told
only "expected vMAJOR.MINOR.PATCH" -- implying a bare vX.Y.Z is the only
accepted form, when -rc1 / .dev0 / +build.42 are all valid and are
documented as such in docs/upgrade.md and README.md.
"""
result = runner.invoke(app, ["self", "upgrade", "--tag", "latest"])
assert result.exit_code == 1
assert "expected vMAJOR.MINOR.PATCH[suffix]" in strip_ansi(result.output)
def test_tag_option_help_keeps_the_suffix_token(self):
"""Typer renders option help through Rich, so `--help` dropped it too."""
result = runner.invoke(app, ["self", "upgrade", "--help"])
assert result.exit_code == 0
assert "[suffix]" in strip_ansi(result.output)
class TestUnknownCurrent:
"""'unknown' current version renders literally in notice and success message."""