strictcli 0.8.5__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.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.5 → strictcli-0.8.6}/.rlsbl/config.json

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

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.5 → strictcli-0.8.6}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 # 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.8.5
+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.5 → strictcli-0.8.6}/package-lock.json

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

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

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

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

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

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

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.8.5"
+__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.
@@ -999,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
@@ -1292,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:
@@ -1333,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):

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.5 → strictcli-0.8.6}/uv.lock

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

strictcli-0.8.5/.rlsbl/changes/.validated

@@ -1 +0,0 @@
-fd52271bcf11157ae4eb47ee9e63d6ed5d9000b9

strictcli-0.8.5/.rlsbl/version

@@ -1 +0,0 @@
-0.39.0