strictcli 0.8.4__tar.gz → 0.8.6__tar.gz

strictcli-0.8.6/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+c3a0fa4107268a0d0dae764c29358768d694199d

strictcli-0.8.6/.rlsbl/changes/0.8.5.jsonl

@@ -0,0 +1,7 @@
+{"commits":["eef4bcb494b80009b2e471f2b1465af98aa476e3"],"user_facing":true,"description":"**Fix.** Auto-registered `check` command no longer collides with app-level global flags (e.g., `--dry-run`).","type":"fix"}
+{"commits":["eef4bcb494b80009b2e471f2b1465af98aa476e3"],"user_facing":true,"description":"**New feature.** App-level and command-level help output now includes a 'Global flags' section.","type":"feature"}
+{"commits":["88d7f9e747085d7b1237e39e7f45ccec34c7a3bf","8facbdd35c2b52023005a051d0417ff62878b940"],"user_facing":false}
+{"commits":["00a96ace74f0ccadf55bd5cf6b820102ff504320"],"user_facing":false}
+{"commits":["5df4af02759154eb4cbf3abb2a47950a02b7d3ec"],"user_facing":false}
+{"commits":["b6f72994086bf8ed38dba1550cc1a977d12e988b"],"user_facing":false}
+{"commits":["e2e9804dd8b20925b04bdf7dc7ffbe774d7982df"],"user_facing":false}

strictcli-0.8.6/.rlsbl/changes/0.8.5.md

@@ -0,0 +1,9 @@
+## 0.8.5
+
+### Features
+
+- **New feature.** App-level and command-level help output now includes a 'Global flags' section.
+
+### Fixes
+
+- **Fix.** Auto-registered `check` command no longer collides with app-level global flags (e.g., `--dry-run`).

strictcli-0.8.6/.rlsbl/changes/0.8.6.jsonl

@@ -0,0 +1,6 @@
+{"commits":["81c9f3996c118362a9a3952eeddb3a12310479e0"],"user_facing":true,"description":"**New feature.** Parse error messages now suggest the correct subcommand help (e.g., `try 'app stream --help'` instead of `try 'app --help'`).","type":"feature"}
+{"commits":["8089797a28ed0dc23c6f1365df464d1b2d5a9e0f","dda8012e14645ac6653b1599e41a609ea8f77b42"],"user_facing":false}
+{"commits":["8f71653fe5d65a735aff24c5e5367b0227e93c1b"],"user_facing":false}
+{"commits":["f65b5a5859bb26db246b4b1e786eecf0ad78cd5e"],"user_facing":false}
+{"commits":["dda8012e14645ac6653b1599e41a609ea8f77b42","6e990245b1d0ef8cb056e71cc0fdda97229fd395","d21c48ee1cc8f02357dae2b9ed28c646c461760b","f67895e847ab4d19fc95c2c21a47d8b033d31370"],"user_facing":false}
+{"commits":["33cf59b2bc27d4bac9fc8dd820668d51a35cb9c6"],"user_facing":false}

strictcli-0.8.6/.rlsbl/changes/0.8.6.md

@@ -0,0 +1,5 @@
+## 0.8.6
+
+### Features
+
+- **New feature.** Parse error messages now suggest the correct subcommand help (e.g., `try 'app stream --help'` instead of `try 'app --help'`).

{strictcli-0.8.4 → strictcli-0.8.6}/.rlsbl/config.json

@@ -2,5 +2,6 @@
   "targets": [
     "pypi",
     "npm"
-  ]
+  ],
+  "private": false
 }

strictcli-0.8.6/.rlsbl/releases/v0.8.5.toml

@@ -0,0 +1,3 @@
+bump = "patch"
+include = ["pypi", "npm"]
+exclude = []

strictcli-0.8.6/.rlsbl/releases/v0.8.6.toml

@@ -0,0 +1,3 @@
+bump = "patch"
+include = ["pypi", "npm"]
+exclude = []

strictcli-0.8.6/.rlsbl/version

@@ -0,0 +1 @@
+0.41.4

{strictcli-0.8.4 → strictcli-0.8.6}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 # Changelog
 
+## 0.8.6
+
+### Features
+
+- **New feature.** Parse error messages now suggest the correct subcommand help (e.g., `try 'app stream --help'` instead of `try 'app --help'`).
+
+## 0.8.5
+
+### Features
+
+- **New feature.** App-level and command-level help output now includes a 'Global flags' section.
+
+### Fixes
+
+- **Fix.** Auto-registered `check` command no longer collides with app-level global flags (e.g., `--dry-run`).
+
 ## 0.8.4
 
 ### Fixes

{strictcli-0.8.4 → strictcli-0.8.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.8.4
+Version: 0.8.6
 Summary: A strict, zero-dependency CLI framework for Python
 Project-URL: Homepage, https://github.com/smm-h/strictcli
 Project-URL: Repository, https://github.com/smm-h/strictcli

{strictcli-0.8.4 → strictcli-0.8.6}/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "strictcli",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "strictcli",
-      "version": "0.8.4",
+      "version": "0.8.6",
       "hasInstallScript": true,
       "license": "MIT"
     }

{strictcli-0.8.4 → strictcli-0.8.6}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strictcli",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "A strict, zero-dependency CLI framework for Python (npm wrapper)",
   "main": "index.js",
   "scripts": {

{strictcli-0.8.4 → strictcli-0.8.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "strictcli"
-version = "0.8.4"
+version = "0.8.6"
 description = "A strict, zero-dependency CLI framework for Python"
 readme = "README.md"
 license = "MIT"

{strictcli-0.8.4 → strictcli-0.8.6}/strictcli/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.8.4"
+__version__ = "0.8.6"
 
 __all__ = [
     "App", "Flag", "Arg", "Tag", "MutexGroup", "CoRequired", "Requires",
@@ -223,6 +223,10 @@ class _DumpSchemaRequested(Exception):
 class _ParseError(Exception):
     """Raised for user-facing parse errors."""
 
+    def __init__(self, message: str, command_prefix: str | None = None):
+        super().__init__(message)
+        self.command_prefix = command_prefix
+
 
 def _strict_int(s: str) -> int:
     """Parse an integer string strictly -- no leading/trailing whitespace allowed.
@@ -714,6 +718,20 @@ class App:
 
             return exit_code
 
+        # Filter out extra flags that already exist as global flags to avoid
+        # collisions -- the handler receives global flag values automatically.
+        global_flag_names = {gf.name for gf in self._global_flags}
+        candidate_extra_flags = [
+            Flag(name="all", type=bool, help="Run all checks"),
+            Flag(name="tag", type=str, default="", help="Tag DSL expression to filter checks"),
+            Flag(name="name", type=str, default="", help="Glob pattern to filter by check name"),
+            Flag(name="list", type=bool, help="List all checks and their tags"),
+            Flag(name="json", type=bool, help="Output results as JSON"),
+            Flag(name="ignore-warnings", type=bool, help="Warn severity does not cause nonzero exit"),
+            Flag(name="verbose", type=bool, help="Show details for passing checks too"),
+            Flag(name="dry-run", type=bool, help="Show which checks would run without running them"),
+        ]
+        extra_flags = [f for f in candidate_extra_flags if f.name not in global_flag_names]
         check_cmd = _build_and_validate_command(
             "check",
             help="Run project checks",
@@ -725,16 +743,7 @@ class App:
             env_prefix=self.env_prefix,
             global_flags=self._global_flags,
             passthrough=None,
-            extra_flags=[
-                Flag(name="all", type=bool, help="Run all checks"),
-                Flag(name="tag", type=str, default="", help="Tag DSL expression to filter checks"),
-                Flag(name="name", type=str, default="", help="Glob pattern to filter by check name"),
-                Flag(name="list", type=bool, help="List all checks and their tags"),
-                Flag(name="json", type=bool, help="Output results as JSON"),
-                Flag(name="ignore-warnings", type=bool, help="Warn severity does not cause nonzero exit"),
-                Flag(name="verbose", type=bool, help="Show details for passing checks too"),
-                Flag(name="dry-run", type=bool, help="Show which checks would run without running them"),
-            ],
+            extra_flags=extra_flags,
         )
         self._commands["check"] = check_cmd
 
@@ -994,9 +1003,14 @@ class App:
             return cmd, rest
 
         # Step 3: parse remaining tokens for the resolved command
-        cmd, kwargs, post_global = _parse_command(
-            cmd, rest, self._global_flags, config_data=self._config_data,
-        )
+        try:
+            cmd, kwargs, post_global = _parse_command(
+                cmd, rest, self._global_flags, config_data=self._config_data,
+            )
+        except _ParseError as e:
+            prefix_parts = [self.name] + path + [cmd.name]
+            e.command_prefix = " ".join(prefix_parts)
+            raise
 
         # Step 4: merge global flag values into kwargs
         # Post-command global flags override pre-command ones
@@ -1287,7 +1301,8 @@ class App:
             sys.exit(0)
         except _ParseError as e:
             print(f"error: {e}", file=sys.stderr)
-            print(f"try '{self.name} --help'", file=sys.stderr)
+            prefix = e.command_prefix or self.name
+            print(f"try '{prefix} --help'", file=sys.stderr)
             sys.exit(1)
         else:
             if cmd.passthrough is not None:
@@ -1328,7 +1343,8 @@ class App:
             stdout_buf.write(path + "\n")
         except _ParseError as e:
             stderr_buf.write(f"error: {e}\n")
-            stderr_buf.write(f"try '{self.name} --help'\n")
+            prefix = e.command_prefix or self.name
+            stderr_buf.write(f"try '{prefix} --help'\n")
             exit_code = 1
         else:
             with contextlib.redirect_stdout(stdout_buf), contextlib.redirect_stderr(stderr_buf):
@@ -2100,6 +2116,20 @@ def _format_app_help(app: App) -> str:
             padding = max_len - len(name) + 4
             lines.append(f"  {name}{' ' * padding}{dep.message}")
 
+    if app._global_flags:
+        lines.append("")
+        lines.append("Global flags:")
+        flag_strs = []
+        for f in app._global_flags:
+            parts = [f"--{f.name}"]
+            if f.short:
+                parts.append(f"-{f.short}")
+            flag_strs.append((", ".join(parts), f.help))
+        max_flag_len = max(len(s[0]) for s in flag_strs)
+        for flag_str, help_text in flag_strs:
+            padding = max_flag_len - len(flag_str) + 4
+            lines.append(f"  {flag_str}{' ' * padding}{help_text}")
+
     lines.append("")
     lines.append(f"Use '{app.name} <command> --help' for more information.")
 

strictcli-0.8.6/tests/test_command_help_suggestion.py

@@ -0,0 +1,60 @@
+"""Tests for command-specific help suggestions in parse error messages."""
+
+import strictcli
+
+
+def _make_app():
+    """Helper: app with a command that has a required flag."""
+    app = strictcli.App(name="myapp", version="1.0.0", help="test app")
+
+    @app.command("stream", help="stream data")
+    @strictcli.flag("target", type=str, help="the target")
+    def stream(target):
+        print(f"target={target}")
+
+    return app
+
+
+def _make_group_app():
+    """Helper: app with a nested group command that has a required flag."""
+    app = strictcli.App(name="myapp", version="1.0.0", help="test app")
+    grp = app.group("config", help="manage configuration")
+
+    @grp.command("set", help="set a value")
+    @strictcli.flag("key", type=str, help="config key")
+    def set_(key):
+        print(f"key={key}")
+
+    return app
+
+
+def test_missing_required_arg_suggests_subcommand_help():
+    """Missing required flag on subcommand suggests 'myapp stream --help'."""
+    app = _make_app()
+    r = app.test(["stream"])
+    assert r.exit_code == 1
+    assert "try 'myapp stream --help'" in r.stderr
+
+
+def test_unknown_flag_suggests_subcommand_help():
+    """Unknown flag on subcommand suggests 'myapp stream --help'."""
+    app = _make_app()
+    r = app.test(["stream", "--bogus"])
+    assert r.exit_code == 1
+    assert "try 'myapp stream --help'" in r.stderr
+
+
+def test_unknown_toplevel_command_suggests_app_help():
+    """Unknown top-level command suggests 'myapp --help' (no command_prefix)."""
+    app = _make_app()
+    r = app.test(["nonexistent"])
+    assert r.exit_code == 1
+    assert "try 'myapp --help'" in r.stderr
+
+
+def test_nested_group_missing_arg_suggests_full_path():
+    """Missing required flag in group command suggests 'myapp config set --help'."""
+    app = _make_group_app()
+    r = app.test(["config", "set"])
+    assert r.exit_code == 1
+    assert "try 'myapp config set --help'" in r.stderr

{strictcli-0.8.4 → strictcli-0.8.6}/uv.lock

@@ -232,7 +232,7 @@ wheels = [
 
 [[package]]
 name = "strictcli"
-version = "0.8.4"
+version = "0.8.6"
 source = { editable = "." }
 
 [package.dev-dependencies]

strictcli-0.8.4/.rlsbl/changes/.validated

@@ -1 +0,0 @@
-33dcdaea5388ed23e7f3df7369bac01ae7a303e6

strictcli-0.8.4/.rlsbl/version

@@ -1 +0,0 @@
-0.38.2