code-standards 8.131.0__tar.gz → 8.131.2__tar.gz

{code_standards-8.131.0 → code_standards-8.131.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-standards
-Version: 8.131.0
+Version: 8.131.2
 Summary: One deterministic quality gate for Sarj Python, TypeScript, Swift, Kotlin, shell, SQL, IaC, and repository policy.
 Project-URL: Homepage, https://code-standards.sarj.ai/
 Project-URL: Documentation, https://code-standards.sarj.ai/cli/

{code_standards-8.131.0 → code_standards-8.131.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "code-standards"
-version = "8.131.0"
+version = "8.131.2"
 description = "One deterministic quality gate for Sarj Python, TypeScript, Swift, Kotlin, shell, SQL, IaC, and repository policy."
 readme = "README.md"
 requires-python = ">=3.14"

{code_standards-8.131.0 → code_standards-8.131.2}/src/sarj_standards/configs/cli-reference.v1.json

@@ -3316,6 +3316,6 @@
   },
   "program": "code-standards",
   "schemaVersion": 1,
-  "summary": "Adopt, check, fix, diagnose, and update sarj-ai standards (v8.131.0).",
-  "version": "8.131.0"
+  "summary": "Adopt, check, fix, diagnose, and update sarj-ai standards (v8.131.2).",
+  "version": "8.131.2"
 }

code_standards-8.131.2/src/sarj_standards/libs/repository/cli_examples.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from contextlib import redirect_stderr, redirect_stdout
+from io import StringIO
+import shlex
+import sys
+from typing import TYPE_CHECKING
+
+from sarj_standards.__main__ import main as cli_main
+from sarj_standards.libs.json_boundary import parse_json
+from sarj_standards.libs.typed_containers import is_object_list
+
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Sequence
+    from typing import TextIO
+
+
+def validate(examples: Sequence[object], *, invoke: Callable[[list[str]], int], output: TextIO) -> int:
+    for index, example in enumerate(examples):
+        output.write(f"{index}\n")
+        output.flush()
+        if not isinstance(example, str):
+            return 1
+        try:
+            command = shlex.split(example)
+        except ValueError:
+            return 1
+        if not command or command[0] != "code-standards":
+            return 1
+        with redirect_stdout(StringIO()), redirect_stderr(StringIO()):
+            status: int | str | None
+            try:
+                status = invoke([*command[1:], "--help"])
+            except SystemExit as exc:
+                status = exc.code
+        if status not in {0, None}:
+            return 1
+    return 0
+
+
+def main() -> int:
+    examples = parse_json(sys.stdin.read())
+    if not is_object_list(examples):
+        return 1
+    return validate(examples, invoke=cli_main, output=sys.stdout)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{code_standards-8.131.0 → code_standards-8.131.2}/src/sarj_standards/libs/repository/docs.py

@@ -1,10 +1,10 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+import json
 import os
 from pathlib import Path
 import re
-import shlex
 import subprocess  # ruff: ignore[suspicious-subprocess-import] -- validates fixed local CLI examples.
 import sys
 import tomllib
@@ -721,17 +721,28 @@ def _heading_slug(heading: str) -> str:
 
 
 def _validate_cli_examples(path: Path, source: str) -> None:
-    for match in _STANDARDS_COMMAND.finditer(source):
-        command = shlex.split(match.group(1))
-        completed = subprocess.run(  # ruff: ignore[subprocess-without-shell-equals-true] -- fixed interpreter and argv.
-            [sys.executable, "-m", "sarj_standards", *command[1:], "--help"],
-            check=False,
-            capture_output=True,
-            text=True,
-        )
-        if completed.returncode != 0:
-            msg = f"{path} contains an invalid command example: {match.group(1)!r}"
+    examples = [match.group(1) for match in _STANDARDS_COMMAND.finditer(source)]
+    if not examples:
+        return
+    completed = subprocess.run(
+        [sys.executable, "-m", "sarj_standards.libs.repository.cli_examples"],
+        input=json.dumps(examples),
+        check=False,
+        capture_output=True,
+        text=True,
+    )
+    attempted = completed.stdout.splitlines()
+    expected = [str(index) for index in range(len(examples))]
+    if not attempted or len(attempted) > len(expected) or attempted != expected[: len(attempted)]:
+        msg = f"{path}: command example validation failed"
+        raise ValueError(msg)
+    if completed.returncode == 0:
+        if attempted != expected:
+            msg = f"{path}: command example validation did not check every example"
             raise ValueError(msg)
+        return
+    msg = f"{path} contains an invalid command example: {examples[len(attempted) - 1]!r}"
+    raise ValueError(msg)
 
 
 def _manifest(path: Path) -> dict[str, object]: