strictcli 0.16.1__tar.gz → 0.18.0__tar.gz

strictcli-0.18.0/.rlsbl/changes/.validated

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

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

@@ -0,0 +1,6 @@
+## 0.16.1
+
+### Fixes
+
+- **Fix.** `config set` mutex error messages now include the `config set:` prefix for consistency.
+- **Fix.** Config set help text now mentions backslash escaping for values containing commas in repeatable flags.

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

@@ -0,0 +1,3 @@
+{"commits":["5660d554d8a5dbb47bb6872d8513ba497fb04e7f"],"user_facing":false}
+{"commits":["ba0ca0dd03644fa63f6ca6525ce81d814100a7a1"],"user_facing":true,"description":"**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.","type":"breaking"}
+{"commits":["47de2e49ebd7248a5b16a54860ec9cdf1e5e98e9"],"user_facing":true,"description":"**New.** Help text now displays non-empty repeatable flag defaults as `[default: a, b, c]`.","type":"feature"}

strictcli-0.18.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.18.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.18.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.18.0/.rlsbl/releases/v0.17.0.toml

@@ -0,0 +1,8 @@
+# Version bump type: patch, minor, or major
+bump = "minor"
+# Short description of this release (required)
+description = "Repeatable flag default validation and help text display"
+# Optional context explaining why these changes were made
+context = ""
+include = ["pypi", "npm"]
+exclude = []

strictcli-0.18.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.18.0/.rlsbl/version

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

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

@@ -2,9 +2,32 @@
 
 # Changelog
 
-## 0.16.1
+## 0.18.0
+
+Public API for running checks programmatically
+
+<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.
+
+</details>
+
+### Features
+
+- **New.** Public API for running checks programmatically: `App.run_checks()`, `format_check_results()`, `format_check_results_json()`, `CheckRunResult`.
 
-Error message fixes and help text improvements
+## 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]`.
+
+## 0.16.1
 
 ### Fixes
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.16.1
+Version: 0.18.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

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

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

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

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

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

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

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

@@ -2,12 +2,13 @@
 
 from __future__ import annotations
 
-__version__ = "0.16.1"
+__version__ = "0.18.0"
 
 __all__ = [
     "App", "Flag", "Arg", "Tag", "MutexGroup", "CoRequired", "Requires",
     "Implies", "Passthrough", "DeprecatedCommand", "Result", "flag", "arg",
-    "CheckResult", "CheckContext",
+    "CheckResult", "CheckContext", "CheckRunResult",
+    "format_check_results", "format_check_results_json",
 ]
 
 import contextlib
@@ -588,6 +589,38 @@ class Flag:
                     raise ValueError(
                         f'Flag "{self.name}": choice {c!r} is not of type {self.type.__name__}'
                     )
+        # Validate repeatable flag defaults
+        if self.repeatable and not isinstance(self.default, _MissingSentinel):
+            if self.default is not None:
+                if not isinstance(self.default, list):
+                    raise ValueError(
+                        f'Flag "{self.name}": repeatable flag default must be a list'
+                    )
+                if len(self.default) == 0:
+                    raise ValueError(
+                        f'Flag "{self.name}": explicit empty default is redundant '
+                        f"for repeatable flags, omit the default"
+                    )
+                # Validate element types
+                type_name = {str: "str", int: "int", float: "float"}[self.type]
+                for i, elem in enumerate(self.default):
+                    if self.type is str:
+                        if not isinstance(elem, str):
+                            raise ValueError(
+                                f'Flag "{self.name}": default element {i} is not of type {type_name}'
+                            )
+                    elif self.type is int:
+                        if not isinstance(elem, int) or isinstance(elem, bool):
+                            raise ValueError(
+                                f'Flag "{self.name}": default element {i} is not of type {type_name}'
+                            )
+                    elif self.type is float:
+                        if not isinstance(elem, (int, float)) or isinstance(elem, bool):
+                            raise ValueError(
+                                f'Flag "{self.name}": default element {i} is not of type {type_name}'
+                            )
+                        if isinstance(elem, int):
+                            self.default[i] = float(elem)
         # Validate default type for int flags
         if self.type is int and not isinstance(self.default, _MissingSentinel) and self.default is not None:
             if not self.repeatable and not isinstance(self.default, int):
@@ -824,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."""
@@ -969,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
@@ -1016,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
 
@@ -2904,8 +2982,10 @@ def _build_flag_meta(f: Flag) -> str:
     if f.type is bool:
         meta_parts.append(f"default: {'true' if f.default else 'false'}")
     elif f.repeatable:
-        # Repeatable flags are never required; no default shown
-        pass
+        # Repeatable flags are never required; show default only if non-empty
+        if f.default:
+            joined = ", ".join(_format_value_for_error(elem) for elem in f.default)
+            meta_parts.append(f"default: {joined}")
     elif f.default is not None:
         meta_parts.append(f"default: {f.default}")
     else:
@@ -3296,7 +3376,7 @@ def _find_cycle(
 
 
 def _run_checks(
-    app: "App",
+    check_defs: dict,
     check_names: list[str],
     context: CheckContext,
     ignore_warnings: bool,
@@ -3306,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
@@ -3406,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=(",", ":"))
 
 
 # ---------------------------------------------------------------------------