strictcli 0.18.0__tar.gz → 0.19.0__tar.gz

strictcli-0.19.0/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+436f8a9ce1b048614cb66e929969dfbcb0791689

strictcli-0.19.0/.rlsbl/changes/0.19.0.jsonl

@@ -0,0 +1,2 @@
+{"commits":["03d0cd60c4d207b568a19bf6916f58aacdac1450","5a1368de51cbe0abe465f21f3a38f78ba1746fef"],"user_facing":true,"description":"**Breaking.** Renamed `Tag` to `FlagSet` and `tags=` parameter to `flag_sets=` across all API surfaces.","type":"breaking"}
+{"commits":["03782821de6b48073259aa3edb66b141ab70eb3b","232a6e47db207159abfdb81a5e1b93c1cfce82ea","fa29d925446a00a2bddec93cb949f91f13682704"],"user_facing":false}

strictcli-0.19.0/.rlsbl/changes/0.19.0.md

@@ -0,0 +1,5 @@
+## 0.19.0
+
+### Breaking
+
+- **Breaking.** Renamed `Tag` to `FlagSet` and `tags=` parameter to `flag_sets=` across all API surfaces.

strictcli-0.19.0/.rlsbl/version

@@ -0,0 +1 @@
+0.69.2

{strictcli-0.18.0 → strictcli-0.19.0}/CHANGELOG.md

@@ -2,17 +2,23 @@
 
 # Changelog
 
-## 0.18.0
+## 0.19.0
 
-Public API for running checks programmatically
+Renamed Tag to FlagSet
 
 <details>
 <summary>Context</summary>
 
-Adds App.run_checks(), format_check_results(), format_check_results_json(), and CheckRunResult — a stable public API replacing the private _filter_checks/_resolve_check_order/_run_checks/_check_format_human functions that consumers like rlsbl were forced to use.
+Breaking: Tag class renamed to FlagSet, tags= parameter renamed to flag_sets= across all API surfaces. The Tag name was misleading — it implied labeling/annotation, but the type is actually a reusable bundle of flags.
 
 </details>
 
+### Breaking
+
+- **Breaking.** Renamed `Tag` to `FlagSet` and `tags=` parameter to `flag_sets=` across all API surfaces.
+
+## 0.18.0
+
 ### Features
 
 - **New.** Public API for running checks programmatically: `App.run_checks()`, `format_check_results()`, `format_check_results_json()`, `CheckRunResult`.

{strictcli-0.18.0 → strictcli-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.18.0
+Version: 0.19.0
 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
@@ -222,12 +222,12 @@ Values resolve in this order: CLI argument > environment variable > default. If
 
 Bool flags from env vars accept `1`, `true`, `yes` (case-insensitive) for `True` and `0`, `false`, `no` for `False`. Any other value is an error.
 
-## Tags
+## FlagSets
 
-Tags are reusable bundles of flags that can be applied to multiple commands:
+FlagSets are reusable bundles of flags that can be applied to multiple commands:
 
 ```python
-auth_tag = strictcli.Tag(
+auth_flags = strictcli.FlagSet(
     name="auth",
     flags=[
         strictcli.Flag(name="token", type=str, help="auth token", env="MYAPP_TOKEN", default=""),
@@ -235,16 +235,16 @@ auth_tag = strictcli.Tag(
     ],
 )
 
-@app.command("deploy", help="deploy the app", tags=[auth_tag])
+@app.command("deploy", help="deploy the app", flag_sets=[auth_flags])
 def deploy(token, insecure):
     print(f"token={'set' if token else 'unset'}, insecure={insecure}")
 
-@app.command("status", help="check status", tags=[auth_tag])
+@app.command("status", help="check status", flag_sets=[auth_flags])
 def status(token, insecure):
     print(f"checking status")
 ```
 
-Both commands now have `--token` and `--insecure` flags. Tag flags appear in help output and are parsed like any other flag.
+Both commands now have `--token` and `--insecure` flags. FlagSet flags appear in help output and are parsed like any other flag.
 
 ## Mutex Groups
 

{strictcli-0.18.0 → strictcli-0.19.0}/README.md

@@ -204,12 +204,12 @@ Values resolve in this order: CLI argument > environment variable > default. If
 
 Bool flags from env vars accept `1`, `true`, `yes` (case-insensitive) for `True` and `0`, `false`, `no` for `False`. Any other value is an error.
 
-## Tags
+## FlagSets
 
-Tags are reusable bundles of flags that can be applied to multiple commands:
+FlagSets are reusable bundles of flags that can be applied to multiple commands:
 
 ```python
-auth_tag = strictcli.Tag(
+auth_flags = strictcli.FlagSet(
     name="auth",
     flags=[
         strictcli.Flag(name="token", type=str, help="auth token", env="MYAPP_TOKEN", default=""),
@@ -217,16 +217,16 @@ auth_tag = strictcli.Tag(
     ],
 )
 
-@app.command("deploy", help="deploy the app", tags=[auth_tag])
+@app.command("deploy", help="deploy the app", flag_sets=[auth_flags])
 def deploy(token, insecure):
     print(f"token={'set' if token else 'unset'}, insecure={insecure}")
 
-@app.command("status", help="check status", tags=[auth_tag])
+@app.command("status", help="check status", flag_sets=[auth_flags])
 def status(token, insecure):
     print(f"checking status")
 ```
 
-Both commands now have `--token` and `--insecure` flags. Tag flags appear in help output and are parsed like any other flag.
+Both commands now have `--token` and `--insecure` flags. FlagSet flags appear in help output and are parsed like any other flag.
 
 ## Mutex Groups
 

{strictcli-0.18.0 → strictcli-0.19.0}/package-lock.json

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

{strictcli-0.18.0 → strictcli-0.19.0}/package.json

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

{strictcli-0.18.0 → strictcli-0.19.0}/pyproject.toml

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

{strictcli-0.18.0 → strictcli-0.19.0}/strictcli/__init__.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-__version__ = "0.18.0"
+__version__ = "0.19.0"
 
 __all__ = [
-    "App", "Flag", "Arg", "Tag", "MutexGroup", "CoRequired", "Requires",
+    "App", "Flag", "Arg", "FlagSet", "MutexGroup", "CoRequired", "Requires",
     "Implies", "Passthrough", "DeprecatedCommand", "Result", "flag", "arg",
     "CheckResult", "CheckContext", "CheckRunResult",
     "format_check_results", "format_check_results_json",
@@ -677,7 +677,7 @@ class Arg:
 
 
 @dataclass
-class Tag:
+class FlagSet:
     """A reusable bundle of flags."""
 
     name: str
@@ -740,7 +740,7 @@ class Command:
     handler: Callable | None
     flags: list[Flag] = field(default_factory=list)
     args: list[Arg] = field(default_factory=list)
-    tags: list[Tag] = field(default_factory=list)
+    flag_sets: list[FlagSet] = field(default_factory=list)
     mutex: list[MutexGroup] = field(default_factory=list)
     dependencies: list[CoRequired | Requires | Implies] = field(default_factory=list)
     passthrough: Passthrough | None = None
@@ -805,7 +805,7 @@ class Group:
         *,
         help: str,
         args: list[Arg] | None = None,
-        tags: list[Tag] | None = None,
+        flag_sets: list[FlagSet] | None = None,
         mutex: list[MutexGroup] | None = None,
         dependencies: list[CoRequired | Requires | Implies] | None = None,
         passthrough: Passthrough | None = None,
@@ -818,7 +818,7 @@ class Group:
                     f'command "{name}" collides with an existing group'
                 )
             cmd = _build_and_validate_command(
-                name, help=help, handler=func, args=args, tags=tags, mutex=mutex,
+                name, help=help, handler=func, args=args, flag_sets=flag_sets, mutex=mutex,
                 dependencies=dependencies,
                 env_prefix=self.env_prefix,
                 global_flags=self._global_flags,
@@ -1124,7 +1124,7 @@ class App:
             help="Run project checks",
             handler=_check_handler,
             args=None,
-            tags=None,
+            flag_sets=None,
             mutex=None,
             dependencies=None,
             env_prefix=self.env_prefix,
@@ -1140,7 +1140,7 @@ class App:
         *,
         help: str,
         args: list[Arg] | None = None,
-        tags: list[Tag] | None = None,
+        flag_sets: list[FlagSet] | None = None,
         mutex: list[MutexGroup] | None = None,
         dependencies: list[CoRequired | Requires | Implies] | None = None,
         passthrough: Passthrough | None = None,
@@ -1153,7 +1153,7 @@ class App:
                 help=help,
                 handler=func,
                 args=args,
-                tags=tags,
+                flag_sets=flag_sets,
                 mutex=mutex,
                 dependencies=dependencies,
                 env_prefix=self.env_prefix,
@@ -2483,7 +2483,7 @@ def _build_and_validate_command(
     help: str,
     handler: Callable,
     args: list[Arg] | None,
-    tags: list[Tag] | None,
+    flag_sets: list[FlagSet] | None,
     mutex: list[MutexGroup] | None,
     dependencies: list[CoRequired | Requires | Implies] | None = None,
     env_prefix: str | None,
@@ -2495,22 +2495,22 @@ def _build_and_validate_command(
     if not help or not help.strip():
         raise ValueError(f'command "{name}": missing help text')
 
-    # Passthrough commands must not have flags, args, tags, or mutex groups
+    # Passthrough commands must not have flags, args, flag sets, or mutex groups
     if passthrough is not None:
         decorator_flags = list(getattr(handler, "_strictcli_flags", []))
         decorator_args = list(getattr(handler, "_strictcli_args", []))
         has_flags = bool(decorator_flags)
         has_args = bool(args) or bool(decorator_args)
-        has_tags = bool(tags)
+        has_flag_sets = bool(flag_sets)
         has_mutex = bool(mutex)
-        if has_flags or has_args or has_tags or has_mutex:
+        if has_flags or has_args or has_flag_sets or has_mutex:
             parts = []
             if has_flags:
                 parts.append("flags")
             if has_args:
                 parts.append("args")
-            if has_tags:
-                parts.append("tags")
+            if has_flag_sets:
+                parts.append("flag sets")
             if has_mutex:
                 parts.append("mutex groups")
             raise ValueError(
@@ -2535,11 +2535,11 @@ def _build_and_validate_command(
     all_args = list(args) if args else []
     all_args.extend(decorator_args)
 
-    # Merge tags into flags
-    resolved_tags = list(tags) if tags else []
-    tag_flags: list[Flag] = []
-    for tag in resolved_tags:
-        tag_flags.extend(tag.flags)
+    # Merge flag sets into flags
+    resolved_flag_sets = list(flag_sets) if flag_sets else []
+    flag_set_flags: list[Flag] = []
+    for flag_set in resolved_flag_sets:
+        flag_set_flags.extend(flag_set.flags)
 
     # Resolve mutex groups and merge their flags
     resolved_mutex = list(mutex) if mutex else []
@@ -2563,13 +2563,13 @@ def _build_and_validate_command(
                 )
             mutex_flag_names.add(f.name)
 
-    # All flags: decorator flags + tag flags + mutex flags + extra flags
-    all_flags = decorator_flags + tag_flags + mutex_flags
+    # All flags: decorator flags + flag set flags + mutex flags + extra flags
+    all_flags = decorator_flags + flag_set_flags + mutex_flags
     if extra_flags:
         all_flags.extend(extra_flags)
 
     # Validate: no duplicate flag names (catches mutex flags overlapping with
-    # regular flags or tag flags)
+    # regular flags or flag set flags)
     seen_flag_names: set[str] = set()
     for f in all_flags:
         if f.name in seen_flag_names:
@@ -2745,7 +2745,7 @@ def _build_and_validate_command(
         handler=handler,
         flags=all_flags,
         args=all_args,
-        tags=resolved_tags,
+        flag_sets=resolved_flag_sets,
         mutex=resolved_mutex,
         dependencies=resolved_dependencies,
     )

{strictcli-0.18.0 → strictcli-0.19.0}/tests/test_e2e.py

@@ -4,8 +4,8 @@ import strictcli
 
 
 def _build_rlsbl_app():
-    """Build a mini rlsbl-like CLI app with commands, groups, tags, and env vars."""
-    auth_tag = strictcli.Tag(
+    """Build a mini rlsbl-like CLI app with commands, groups, flag sets, and env vars."""
+    auth_flag_set = strictcli.FlagSet(
         name="auth",
         flags=[
             strictcli.Flag(
@@ -26,7 +26,7 @@ def _build_rlsbl_app():
     )
 
     # Top-level commands
-    @app.command("status", help="show release status", tags=[auth_tag])
+    @app.command("status", help="show release status", flag_sets=[auth_flag_set])
     def status(token):
         print(f"status: token={'set' if token else 'unset'}")
 
@@ -34,7 +34,7 @@ def _build_rlsbl_app():
         "release",
         help="create a new release",
         args=[strictcli.Arg(name="bump", help="version bump type")],
-        tags=[auth_tag],
+        flag_sets=[auth_flag_set],
     )
     @strictcli.flag("dry-run", type=bool, help="preview without making changes")
     @strictcli.flag("yes", type=bool, help="non-interactive mode")
@@ -264,9 +264,9 @@ def test_e2e_kwargs_handler_defaults():
     assert "replicas=1" in r.stdout
 
 
-def test_e2e_kwargs_handler_with_tags():
-    """Command with **kwargs handler and tags receives tag flag values."""
-    auth_tag = strictcli.Tag(
+def test_e2e_kwargs_handler_with_flag_sets():
+    """Command with **kwargs handler and flag sets receives flag set flag values."""
+    auth_flag_set = strictcli.FlagSet(
         name="auth",
         flags=[
             strictcli.Flag(name="token", type=str, help="auth token", default=""),
@@ -275,7 +275,7 @@ def test_e2e_kwargs_handler_with_tags():
 
     app = strictcli.App(name="kw", version="1.0.0", help="kwargs test app")
 
-    @app.command("push", help="push changes", tags=[auth_tag])
+    @app.command("push", help="push changes", flag_sets=[auth_flag_set])
     def push_handler(**kwargs):
         print(f"token={kwargs['token']}")
         return 0

strictcli-0.18.0/tests/test_tags.py → strictcli-0.19.0/tests/test_flag_sets.py

@@ -1,17 +1,17 @@
-"""Tests for the tag system."""
+"""Tests for the flag set system."""
 
 import strictcli
 
 
-def test_tag_with_single_flag():
-    """Tag with single flag applied to command."""
-    verbose_tag = strictcli.Tag(
+def test_flag_set_with_single_flag():
+    """FlagSet with single flag applied to command."""
+    verbose_flag_set = strictcli.FlagSet(
         name="verbose",
         flags=[strictcli.Flag(name="verbose", type=bool, help="verbose output")],
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("cmd", help="a command", tags=[verbose_tag])
+    @app.command("cmd", help="a command", flag_sets=[verbose_flag_set])
     def cmd(verbose):
         print(f"verbose={verbose}")
 
@@ -20,9 +20,9 @@ def test_tag_with_single_flag():
     assert "verbose=True" in r.stdout
 
 
-def test_tag_with_multiple_flags():
-    """Tag with multiple flags applied to command."""
-    output_tag = strictcli.Tag(
+def test_flag_set_with_multiple_flags():
+    """FlagSet with multiple flags applied to command."""
+    output_flag_set = strictcli.FlagSet(
         name="output",
         flags=[
             strictcli.Flag(name="format", type=str, help="output format", default="text"),
@@ -31,7 +31,7 @@ def test_tag_with_multiple_flags():
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("cmd", help="a command", tags=[output_tag])
+    @app.command("cmd", help="a command", flag_sets=[output_flag_set])
     def cmd(format, color):
         print(f"format={format} color={color}")
 
@@ -41,15 +41,15 @@ def test_tag_with_multiple_flags():
     assert "color=True" in r.stdout
 
 
-def test_tag_flags_in_command_flags():
-    """Tag flags appear in command's flags list."""
-    tag = strictcli.Tag(
+def test_flag_set_flags_in_command_flags():
+    """FlagSet flags appear in command's flags list."""
+    flag_set = strictcli.FlagSet(
         name="debug",
         flags=[strictcli.Flag(name="debug", type=bool, help="enable debug mode")],
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("cmd", help="a command", tags=[tag])
+    @app.command("cmd", help="a command", flag_sets=[flag_set])
     def cmd(debug):
         pass
 
@@ -57,15 +57,15 @@ def test_tag_flags_in_command_flags():
     assert app._commands["cmd"].flags[0].name == "debug"
 
 
-def test_tag_flags_in_help():
-    """Tag flags shown in help output."""
-    tag = strictcli.Tag(
+def test_flag_set_flags_in_help():
+    """FlagSet flags shown in help output."""
+    flag_set = strictcli.FlagSet(
         name="debug",
         flags=[strictcli.Flag(name="debug", type=bool, help="enable debug mode")],
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("cmd", help="a command", tags=[tag])
+    @app.command("cmd", help="a command", flag_sets=[flag_set])
     def cmd(debug):
         pass
 
@@ -75,9 +75,9 @@ def test_tag_flags_in_help():
     assert "enable debug mode" in r.stdout
 
 
-def test_tag_flag_values_parsed():
-    """Tag flag values parsed correctly through the full pipeline."""
-    auth_tag = strictcli.Tag(
+def test_flag_set_flag_values_parsed():
+    """FlagSet flag values parsed correctly through the full pipeline."""
+    auth_flag_set = strictcli.FlagSet(
         name="auth",
         flags=[
             strictcli.Flag(name="token", type=str, help="auth token", default="none"),
@@ -86,11 +86,11 @@ def test_tag_flag_values_parsed():
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("deploy", help="deploy the app", tags=[auth_tag])
+    @app.command("deploy", help="deploy the app", flag_sets=[auth_flag_set])
     def deploy(token, insecure):
         print(f"token={token} insecure={insecure}")
 
-    # Test with all tag flags provided
+    # Test with all flag set flags provided
     r = app.test(["deploy", "--token", "abc123", "--insecure"])
     assert r.exit_code == 0
     assert "token=abc123" in r.stdout

{strictcli-0.18.0 → strictcli-0.19.0}/tests/test_passthrough.py

@@ -190,22 +190,22 @@ class TestPassthroughWithArgsRaisesValueError:
             assert "args" in str(e)
 
 
-class TestPassthroughWithTagsRaisesValueError:
-    def test_tags(self):
+class TestPassthroughWithFlagSetsRaisesValueError:
+    def test_flag_sets(self):
         pt = strictcli.Passthrough(handler=lambda n, a, g: 0)
-        tag = strictcli.Tag(
+        flag_set = strictcli.FlagSet(
             name="auth",
             flags=[strictcli.Flag(name="token", type=str, help="token", default="")],
         )
         app = _build_app()
         try:
-            @app.command("exec", help="run", passthrough=pt, tags=[tag])
+            @app.command("exec", help="run", passthrough=pt, flag_sets=[flag_set])
             def exec_cmd(token):
                 pass
             assert False, "should have raised ValueError"
         except ValueError as e:
             assert "passthrough" in str(e)
-            assert "tags" in str(e)
+            assert "flag sets" in str(e)
 
 
 class TestPassthroughWithMutexRaisesValueError:

{strictcli-0.18.0 → strictcli-0.19.0}/tests/test_registration.py

@@ -115,14 +115,14 @@ def test_env_prefix_correct():
     assert app._commands["cmd"].flags[0].env == "MYAPP_TARGET"
 
 
-def test_tag_merging():
-    """Command inherits tag flags."""
-    verbose_tag = strictcli.Tag(
+def test_flag_set_merging():
+    """Command inherits flag set flags."""
+    verbose_flag_set = strictcli.FlagSet(
         name="verbose", flags=[strictcli.Flag(name="verbose", type=bool, help="verbose output")]
     )
     app = strictcli.App(name="test", version="1.0.0", help="test app")
 
-    @app.command("cmd", help="a command", tags=[verbose_tag])
+    @app.command("cmd", help="a command", flag_sets=[verbose_flag_set])
     def cmd(verbose):
         pass
 

{strictcli-0.18.0 → strictcli-0.19.0}/uv.lock

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

strictcli-0.18.0/.rlsbl/bases/.rlsbl/lint/go.toml

@@ -1,17 +0,0 @@
-[forbidden-imports]
-modules = [
-    "net/http",
-    "github.com/spf13/cobra",
-    "github.com/urfave/cli",
-]
-
-[stdout]
-enabled = true
-ignore = []
-
-[entry-point]
-enabled = true
-ignore = []
-
-[files]
-exclude = []

strictcli-0.18.0/.rlsbl/changes/.validated

@@ -1 +0,0 @@
-9fe0fe3a00effc0c9e39704a0bd0cc865542da83

strictcli-0.18.0/.rlsbl/lint/go.toml

@@ -1,17 +0,0 @@
-[forbidden-imports]
-modules = [
-    "net/http",
-    "github.com/spf13/cobra",
-    "github.com/urfave/cli",
-]
-
-[stdout]
-enabled = true
-ignore = []
-
-[entry-point]
-enabled = true
-ignore = []
-
-[files]
-exclude = []

strictcli-0.18.0/.rlsbl/version

@@ -1 +0,0 @@
-0.67.1