strictcli 0.8.5__tar.gz → 0.8.7__tar.gz

strictcli-0.8.7/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+cb4155e0427b58ad57b6684d038a8ec780101d5b

strictcli-0.8.7/.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.7/.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.7/.rlsbl/changes/0.8.7.jsonl

@@ -0,0 +1,5 @@
+{"commits":["40478a9bc123d086ade4d0838d3fcb95918ff562"],"user_facing":true,"description":"**New feature.** Go implementation now includes subcommand name in parse error help suggestions, matching Python.","type":"feature"}
+{"commits":["9e2a6468ee2e82338ccec5131f9aac83483c2c7d"],"user_facing":true,"description":"**Fix.** Unknown subcommand errors in groups now suggest group-level help (e.g., `try 'myapp config --help'`).","type":"fix"}
+{"commits":["cde530a82247eb67190fed61a35fc688eb6192b0","1ebf9fba80adee78890f15c2ca9c4db518677092","16abca558f7d9616b74f1be92cf7f78625dbf21f"],"user_facing":false}
+{"commits":["c33baefc772e1ada47d927423ad48d1556d13f53"],"user_facing":false}
+{"commits":["4e19e432ae7f209c109db64f8ee233556ec37e0e","f8c7b3859ac51b2567f075b23651f771211f7066","2764197393cb7d2031e926ed29c920a24f6c8214"],"user_facing":false}

strictcli-0.8.7/.rlsbl/changes/0.8.7.md

@@ -0,0 +1,9 @@
+## 0.8.7
+
+### Features
+
+- **New feature.** Go implementation now includes subcommand name in parse error help suggestions, matching Python.
+
+### Fixes
+
+- **Fix.** Unknown subcommand errors in groups now suggest group-level help (e.g., `try 'myapp config --help'`).

{strictcli-0.8.5 → strictcli-0.8.7}/.rlsbl/config.json

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

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

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

strictcli-0.8.7/.rlsbl/releases/v0.8.7.toml

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

strictcli-0.8.7/.rlsbl/version

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

strictcli-0.8.7/.strictcli/schema.json

@@ -0,0 +1,19 @@
+{
+  "commands": {
+    "greet": {
+      "args": [],
+      "flags": [],
+      "help": "say hello",
+      "name": "greet",
+      "passthrough": false
+    }
+  },
+  "config": false,
+  "deprecated": {},
+  "env_prefix": null,
+  "global_flags": [],
+  "groups": {},
+  "help": "test app",
+  "name": "myapp",
+  "version": "1.0.0"
+}

{strictcli-0.8.5 → strictcli-0.8.7}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 # Changelog
 
+## 0.8.7
+
+### Features
+
+- **New feature.** Go implementation now includes subcommand name in parse error help suggestions, matching Python.
+
+### Fixes
+
+- **Fix.** Unknown subcommand errors in groups now suggest group-level help (e.g., `try 'myapp config --help'`).
+
+## 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.7}/PKG-INFO

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

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

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

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

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

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

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

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.8.5"
+__version__ = "0.8.7"
 
 __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.
@@ -979,7 +983,8 @@ class App:
             # Unknown command -- include path in error message
             if path:
                 raise _ParseError(
-                    f"unknown command '{token}' in '{' '.join(path)}'"
+                    f"unknown command '{token}' in '{' '.join(path)}'",
+                    command_prefix=f"{self.name} {' '.join(path)}",
                 )
             raise _ParseError(f"unknown command '{token}'")
         else:
@@ -999,9 +1004,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 +1302,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 +1344,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.7/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.7}/uv.lock

@@ -232,7 +232,7 @@ wheels = [
 
 [[package]]
 name = "strictcli"
-version = "0.8.5"
+version = "0.8.7"
 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