strictcli 0.17.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.17.0.md

@@ -0,0 +1,9 @@
+## 0.17.0
+
+### Breaking
+
+- **Breaking.** Repeatable flag defaults are now validated at registration: must be a list, `default=[]` is rejected as redundant, and element types must match the flag type.
+
+### Features
+
+- **New.** Help text now displays non-empty repeatable flag defaults as `[default: a, b, c]`.

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

@@ -0,0 +1,4 @@
+{"commits":["ab63f2e29d95b834aef6e3307d23b53e3f845afe","fc7ae2927aa12b7627c3119c818d9a7e89209e39","db1924cbd143285c857324a8fcf2110718080bfa"],"user_facing":true,"description":"**New.** Public API for running checks programmatically: `App.run_checks()`, `format_check_results()`, `format_check_results_json()`, `CheckRunResult`.","type":"feature"}
+{"commits":["6407ea33c3a16a83dcd7c362cda8e98980074a73","edfcf45b0eb1ba4896fcff1d31ea9993c9b363a1","fcaae9bb7895805308a6b9299158ada7f6d45f3b","b6720d2dd1063bff0b49f6d5624608672c0cac33"],"user_facing":false}
+{"commits":["9cc04830fa5b7eef0d87b249e57248415fd769a5","4e89101a5fdb8c0a6f46b62829f22e09b79ec2d1"],"user_facing":false}
+{"commits":["67ee39ff3cdf4d09a9a29c0bdcb9853999878ee9"],"user_facing":false}

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

@@ -0,0 +1,5 @@
+## 0.18.0
+
+### Features
+
+- **New.** Public API for running checks programmatically: `App.run_checks()`, `format_check_results()`, `format_check_results_json()`, `CheckRunResult`.

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/releases/v0.18.0.toml

@@ -0,0 +1,8 @@
+# Version bump type: patch, minor, or major
+bump = "minor"
+# Short description of this release (required)
+description = "Public API for running checks programmatically"
+# Optional context explaining why these changes were made
+context = "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."
+include = ["pypi", "npm"]
+exclude = []

strictcli-0.19.0/.rlsbl/version

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

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

@@ -2,9 +2,28 @@
 
 # Changelog
 
-## 0.17.0
+## 0.19.0
+
+Renamed Tag to FlagSet
+
+<details>
+<summary>Context</summary>
+
+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
 
-Repeatable flag default validation and help text display
+- **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`.
+
+## 0.17.0
 
 ### Breaking
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.17.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.17.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.17.0 → strictcli-0.19.0}/package-lock.json

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

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

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

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

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

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

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-__version__ = "0.17.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",
+    "CheckResult", "CheckContext", "CheckRunResult",
+    "format_check_results", "format_check_results_json",
 ]
 
 import contextlib
@@ -676,7 +677,7 @@ class Arg:
 
 
 @dataclass
-class Tag:
+class FlagSet:
     """A reusable bundle of flags."""
 
     name: str
@@ -739,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
@@ -804,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,
@@ -817,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,
@@ -856,6 +857,14 @@ class CheckResult:
             raise ValueError("CheckResult.message must be a non-empty string")
 
 
+@dataclass(frozen=True)
+class CheckRunResult:
+    """A named check result returned by App.run_checks()."""
+
+    name: str
+    result: CheckResult
+
+
 @runtime_checkable
 class CheckContext(Protocol):
     """Minimal interface that tool-specific check contexts must satisfy."""
@@ -1001,6 +1010,38 @@ class App:
         """
         self._check_context_factory = factory
 
+    def run_checks(
+        self,
+        context: CheckContext,
+        *,
+        tag_expr: str | None = None,
+        name_glob: str | None = None,
+        run_all: bool = False,
+        ignore_warnings: bool = False,
+    ) -> tuple[list[CheckRunResult], int]:
+        """Run checks programmatically with filtering and dependency resolution.
+
+        Returns (results, exit_code) where results is a list of CheckRunResult
+        and exit_code is 0 if all pass (or all warn with ignore_warnings), else 1.
+        """
+        if not self._checks_enabled:
+            raise ValueError("checks are not enabled on this App")
+        err = self._validate_check_registrations()
+        if err:
+            raise ValueError(err)
+        selected = _filter_checks(self._check_defs, tag_expr, name_glob, run_all)
+        if not selected:
+            return ([], 0)
+        order = _resolve_check_order(self._check_defs, selected)
+        raw_results, exit_code = _run_checks(
+            self._check_defs, order, context, ignore_warnings,
+        )
+        results = [
+            CheckRunResult(name=name, result=result)
+            for name, result in raw_results
+        ]
+        return (results, exit_code)
+
     def _register_check_command(self) -> None:
         """Register the auto-generated 'check' command when checks.toml exists."""
         app_ref = self  # capture for closure
@@ -1048,14 +1089,19 @@ class App:
                 )
                 return 1
             context = app_ref._check_context_factory()
-            results, exit_code = _run_checks(
-                app_ref, order, context, ignore_warnings,
+            raw_results, exit_code = _run_checks(
+                app_ref._check_defs, order, context, ignore_warnings,
             )
 
+            results_wrapped = [
+                CheckRunResult(name=n, result=r) for n, r in raw_results
+            ]
             if json:
-                _check_format_json(results)
+                print(format_check_results_json(results_wrapped))
             else:
-                _check_format_human(results, verbose)
+                output = format_check_results(results_wrapped, verbose)
+                if output:
+                    print(output)
 
             return exit_code
 
@@ -1078,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,
@@ -1094,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,
@@ -1107,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,
@@ -2437,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,
@@ -2449,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(
@@ -2489,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 []
@@ -2517,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:
@@ -2699,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,
     )
@@ -3330,7 +3376,7 @@ def _find_cycle(
 
 
 def _run_checks(
-    app: "App",
+    check_defs: dict,
     check_names: list[str],
     context: CheckContext,
     ignore_warnings: bool,
@@ -3340,7 +3386,6 @@ def _run_checks(
     Returns (results_list, exit_code). exit_code is 0 if all pass (or all
     warn with ignore_warnings=True), 1 otherwise.
     """
-    check_defs = app._check_defs
     results: list[tuple[str, CheckResult]] = []
     failed_checks: set[str] = set()
     exit_code = 0
@@ -3440,39 +3485,43 @@ def _check_dry_run_mode(
             print(f"  {i}. {name}")
 
 
-def _check_format_human(
-    results: list[tuple[str, CheckResult]], verbose: bool,
-) -> None:
-    """Print check results in human-readable aligned format."""
+
+def format_check_results(
+    results: list[CheckRunResult], verbose: bool = False,
+) -> str:
+    """Format check results as a human-readable aligned string."""
     if not results:
-        return
+        return ""
 
-    name_width = max(len(name) for name, _ in results)
+    name_width = max(len(r.name) for r in results)
+    lines: list[str] = []
 
-    for name, result in results:
-        label = _CHECK_STATUS_LABELS[result.status]
-        print(f"{label}  {name:<{name_width}}    {result.message}")
+    for r in results:
+        label = _CHECK_STATUS_LABELS[r.result.status]
+        lines.append(f"{label}  {r.name:<{name_width}}    {r.result.message}")
 
-        show_details = result.details and (
-            verbose or result.status in ("fail", "warn", "skip")
+        show_details = r.result.details and (
+            verbose or r.result.status in ("fail", "warn", "skip")
         )
         if show_details:
-            for detail in result.details:
-                print(f"        {detail}")
+            for detail in r.result.details:
+                lines.append(f"        {detail}")
+
+    return "\n".join(lines)
 
 
-def _check_format_json(results: list[tuple[str, CheckResult]]) -> None:
-    """Print check results as JSON."""
+def format_check_results_json(results: list[CheckRunResult]) -> str:
+    """Format check results as a JSON string."""
     items = [
         {
-            "name": name,
-            "status": result.status,
-            "message": result.message,
-            "details": result.details,
+            "name": r.name,
+            "status": r.result.status,
+            "message": r.result.message,
+            "details": r.result.details if r.result.details is not None else [],
         }
-        for name, result in results
+        for r in results
     ]
-    print(json.dumps(items, separators=(",", ":")))
+    return json.dumps(items, separators=(",", ":"))
 
 
 # ---------------------------------------------------------------------------