strictcli 0.12.0__tar.gz → 0.14.0__tar.gz

strictcli-0.14.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+permissions:
+  contents: read
+  id-token: write
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+    - run: uv build
+    - uses: pypa/gh-action-pypi-publish@release/v1
+  npm:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v6
+      with:
+        node-version: 24
+        registry-url: https://registry.npmjs.org
+    - run: npm publish --provenance --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

strictcli-0.14.0/.npmignore

@@ -0,0 +1,34 @@
+# Development and CI
+tests/
+test/
+__tests__/
+.github/
+scripts/
+docs/
+todo/
+e2e/
+
+# rlsbl metadata
+.rlsbl/
+.rlsbl-monorepo/
+
+# Python artifacts (for multi-target projects)
+__pycache__/
+*.pyc
+*.py
+*.toml
+.venv/
+
+# Build/cache
+coverage/
+.nyc_output/
+
+# Editor/OS
+.DS_Store
+*.log
+.env
+.env.local
+
+# Selfdoc
+.selfdoc/
+selfdoc.json

strictcli-0.14.0/.rlsbl/bases/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+permissions:
+  contents: read
+  id-token: write
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: astral-sh/setup-uv@v7
+    - run: uv build
+    - uses: pypa/gh-action-pypi-publish@release/v1
+  npm:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v6
+      with:
+        node-version: 24
+        registry-url: https://registry.npmjs.org
+    - run: npm publish --provenance --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

strictcli-0.14.0/.rlsbl/bases/.npmignore

@@ -0,0 +1,34 @@
+# Development and CI
+tests/
+test/
+__tests__/
+.github/
+scripts/
+docs/
+todo/
+e2e/
+
+# rlsbl metadata
+.rlsbl/
+.rlsbl-monorepo/
+
+# Python artifacts (for multi-target projects)
+__pycache__/
+*.pyc
+*.py
+*.toml
+.venv/
+
+# Build/cache
+coverage/
+.nyc_output/
+
+# Editor/OS
+.DS_Store
+*.log
+.env
+.env.local
+
+# Selfdoc
+.selfdoc/
+selfdoc.json

strictcli-0.14.0/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+caba81b23948f3b79c908ccd06ed76596881c075

strictcli-0.14.0/.rlsbl/changes/0.13.0.jsonl

@@ -0,0 +1,3 @@
+{"commits":["12ad7c022938b07cf1f44b20bdbe9de0ae6a84be"],"user_facing":true,"description":"**New feature.** Schema dump (--dump-schema) now includes a project_id field read from pyproject.toml, providing provenance for schema validation.","type":"feature"}
+{"commits":["a50cf7899c938974b12e8e74201bdf58c0205a55"],"user_facing":false}
+{"commits":["214721745a82a47189a13b2443fb9ddc59826347"],"user_facing":false}

strictcli-0.14.0/.rlsbl/changes/0.13.0.md

@@ -0,0 +1,5 @@
+## 0.13.0
+
+### Features
+
+- **New feature.** Schema dump (--dump-schema) now includes a project_id field read from pyproject.toml, providing provenance for schema validation.

strictcli-0.14.0/.rlsbl/changes/0.14.0.jsonl

@@ -0,0 +1,3 @@
+{"commits":["f2f2de83edc0b7fe24f46744201e8be1407f28a3"],"user_facing":false}
+{"commits":["a2e1d64fb5f695169fafa63e5d1b69fe5c4e043d"],"user_facing":true,"description":"**New feature.** `checks_embed` parameter accepts raw TOML bytes, enabling inline checks configuration without a file on disk.","type":"feature"}
+{"commits":["09799755dc2ef93a088f739a46001102bcb2aa5e"],"user_facing":false}

strictcli-0.14.0/.rlsbl/changes/0.14.0.md

@@ -0,0 +1,5 @@
+## 0.14.0
+
+### Features
+
+- **New feature.** `checks_embed` parameter accepts raw TOML bytes, enabling inline checks configuration without a file on disk.

{strictcli-0.12.0 → strictcli-0.14.0}/.rlsbl/hashes.json

@@ -1,6 +1,6 @@
 {
   ".github/workflows/ci.yml": "b4e075171b131d25f9cce55a3e3a30732e95a2a794af00f354ee3200626d6a04",
-  ".github/workflows/publish.yml": "8befe0164321eb68e9465c634aa15d6ccb30d46fa669f7d30bf3ed064ad258ba",
+  ".github/workflows/publish.yml": "e77dcd0b5d1c1abae5424e5f3b73862f44f06b5d46209cbe71bc04d6baa6b5be",
   "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
   ".gitignore": "c89d76c6c43e7f0897b3472a15b7c0103e0be5b3a04c2b44e585fa48bdcda2bb",
   "LICENSE": "e958892abc1dd5d991fca6d528e695d335f25773d373d2e0be5f4a9507d8f8d5",
@@ -11,5 +11,6 @@
   ".rlsbl/hooks/pre-checks.sh": "60c57d4563263124530e6f33aca77550ea2161ad3b33b3ba6ad1c03fea9eb6e2",
   ".rlsbl/lint/python.toml": "9cfbcef2e010d5fad243437bf2fd8df54a1fae70ee0762f9d11da70fe207501c",
   ".rlsbl/lint/go.toml": "807d5cf760baad6d571a5bfd43cb163efe356f7462ba9f1918d72de45f62339f",
-  ".rlsbl/lint/npm.toml": "baa36014e65923d8cc5c8b83c77fa651da79351627570476402da66840027645"
+  ".rlsbl/lint/npm.toml": "baa36014e65923d8cc5c8b83c77fa651da79351627570476402da66840027645",
+  ".npmignore": "7c0eea9785c0318aeb39bf8b670ce8384f4a5b812fde69ce23d7d018057325a3"
 }

strictcli-0.14.0/.rlsbl/releases/v0.13.0.toml

@@ -0,0 +1,4 @@
+# Version bump type: patch, minor, or major
+bump = "minor"
+include = ["pypi", "npm"]
+exclude = []

strictcli-0.14.0/.rlsbl/version

@@ -0,0 +1 @@
+0.60.1

{strictcli-0.12.0 → strictcli-0.14.0}/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 # Changelog
 
+## 0.14.0
+
+checks_embed for inline TOML data
+
+<details>
+<summary>Context</summary>
+
+Adds checks_embed parameter as an alternative to checks_path, allowing TOML bytes to be passed directly without requiring a file on disk.
+
+</details>
+
+### Features
+
+- **New feature.** `checks_embed` parameter accepts raw TOML bytes, enabling inline checks configuration without a file on disk.
+
+## 0.13.0
+
+### Features
+
+- **New feature.** Schema dump (--dump-schema) now includes a project_id field read from pyproject.toml, providing provenance for schema validation.
+
 ## 0.12.0
 
 ### Breaking

{strictcli-0.12.0 → strictcli-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.12.0
+Version: 0.14.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.12.0 → strictcli-0.14.0}/package-lock.json

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

{strictcli-0.12.0 → strictcli-0.14.0}/package.json

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

{strictcli-0.12.0 → strictcli-0.14.0}/pyproject.toml

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

{strictcli-0.12.0 → strictcli-0.14.0}/strictcli/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.12.0"
+__version__ = "0.14.0"
 
 __all__ = [
     "App", "Flag", "Arg", "Tag", "MutexGroup", "CoRequired", "Requires",
@@ -130,37 +130,32 @@ _CHECK_REQUIRED_FIELDS = {"tags", "severity", "fast", "pure", "needs_network", "
 _CHECK_VALID_SEVERITIES = {"error", "warn"}
 
 
-def _load_checks_toml(path: str | Path) -> tuple[str, dict[str, _CheckDef]]:
-    """Parse and validate a checks.toml file, returning (app_name, check_defs).
+def _parse_checks_toml(data: bytes) -> tuple[str, dict[str, _CheckDef]]:
+    """Parse and validate checks TOML data, returning (app_name, check_defs).
 
-    Raises ValueError on any schema violation, file error, or invalid TOML.
+    Raises ValueError on any schema violation or invalid TOML.
     """
-    path = Path(path)
-    try:
-        raw = path.read_bytes()
-    except OSError as exc:
-        raise ValueError(f"checks.toml: {exc}") from exc
     try:
-        data = tomllib.loads(raw.decode())
+        parsed = tomllib.loads(data.decode())
     except (tomllib.TOMLDecodeError, UnicodeDecodeError) as exc:
         raise ValueError(f"checks.toml: {exc}") from exc
 
     # Only "app" and [checks] are allowed at the top level
-    for key in data:
+    for key in parsed:
         if key not in ("app", "checks"):
             raise ValueError(f'checks.toml: unknown top-level key "{key}"')
 
     # Validate required "app" field
-    if "app" not in data:
+    if "app" not in parsed:
         raise ValueError('checks.toml: missing required top-level key "app"')
-    if not isinstance(data["app"], str) or not data["app"]:
+    if not isinstance(parsed["app"], str) or not parsed["app"]:
         raise ValueError('checks.toml: "app" must be a non-empty string')
-    app_name = data["app"]
+    app_name = parsed["app"]
 
-    if "checks" not in data:
+    if "checks" not in parsed:
         return (app_name, {})
 
-    checks_section = data["checks"]
+    checks_section = parsed["checks"]
     if not isinstance(checks_section, dict):
         raise ValueError("checks.toml: [checks] must be a table")
 
@@ -253,6 +248,19 @@ def _load_checks_toml(path: str | Path) -> tuple[str, dict[str, _CheckDef]]:
     return (app_name, result)
 
 
+def _load_checks_toml(path: str | Path) -> tuple[str, dict[str, _CheckDef]]:
+    """Read and parse a checks.toml file, returning (app_name, check_defs).
+
+    Raises ValueError on any file error, schema violation, or invalid TOML.
+    """
+    path = Path(path)
+    try:
+        raw = path.read_bytes()
+    except OSError as exc:
+        raise ValueError(f"checks.toml: {exc}") from exc
+    return _parse_checks_toml(raw)
+
+
 class _HelpRequested(Exception):
     """Raised when --help or -h is encountered."""
 
@@ -675,6 +683,7 @@ class App:
     config_path: str | None = None
     config_format: str = "json"
     checks_path: str | Path | None = None
+    checks_embed: bytes | None = None
     flags: list[Flag] = field(default_factory=list)
     _commands: dict[str, Command] = field(default_factory=dict)
     _groups: dict[str, Group] = field(default_factory=dict)
@@ -712,6 +721,8 @@ class App:
             self._register_config_group()
         # Discover checks TOML
         self._check_context_factory: Callable | None = None
+        if self.checks_path is not None and self.checks_embed is not None:
+            raise ValueError("cannot use both checks_path and checks_embed")
         if self.checks_path is not None:
             checks_toml_path = Path(self.checks_path).resolve()
             if not checks_toml_path.is_file():
@@ -723,6 +734,14 @@ class App:
                 )
             self._checks_enabled = True
             self._register_check_command()
+        elif self.checks_embed is not None:
+            app_name, self._check_defs = _parse_checks_toml(self.checks_embed)
+            if app_name != self.name:
+                raise ValueError(
+                    f'checks.toml: app "{app_name}" does not match app name "{self.name}"'
+                )
+            self._checks_enabled = True
+            self._register_check_command()
         else:
             self._check_defs: dict[str, _CheckDef] = {}
             self._checks_enabled = False
@@ -1460,7 +1479,11 @@ class App:
             print(_format_version(self))
             sys.exit(0)
         except _DumpSchemaRequested:
-            path = _write_schema(self)
+            try:
+                path = _write_schema(self)
+            except RuntimeError as e:
+                print(f"error: {e}", file=sys.stderr)
+                sys.exit(1)
             print(path)
             sys.exit(0)
         except _ParseError as e:
@@ -1503,8 +1526,13 @@ class App:
         except _VersionRequested:
             stdout_buf.write(_format_version(self) + "\n")
         except _DumpSchemaRequested:
-            path = _write_schema(self)
-            stdout_buf.write(path + "\n")
+            try:
+                path = _write_schema(self)
+            except RuntimeError as e:
+                stderr_buf.write(f"error: {e}\n")
+                exit_code = 1
+            else:
+                stdout_buf.write(path + "\n")
         except _ParseError as e:
             stderr_buf.write(f"error: {e}\n")
             prefix = e.command_prefix or self.name
@@ -3087,14 +3115,35 @@ def _build_schema_defaults() -> dict:
     }
 
 
+def _read_project_id() -> str:
+    """Read project name from pyproject.toml in the current working directory."""
+    pyproject_path = Path(os.getcwd()) / "pyproject.toml"
+    if not pyproject_path.exists():
+        raise RuntimeError(
+            "Cannot determine project_id: pyproject.toml not found "
+            "or missing [project].name"
+        )
+    with open(pyproject_path, "rb") as f:
+        data = tomllib.load(f)
+    project_name = data.get("project", {}).get("name")
+    if not project_name:
+        raise RuntimeError(
+            "Cannot determine project_id: pyproject.toml not found "
+            "or missing [project].name"
+        )
+    return project_name
+
+
 def _dump_schema(app: App) -> dict:
     """Produce a JSON-serializable dict representing the app's command tree.
 
     Fields whose values match the schema defaults are omitted.
     The top-level ``defaults`` key documents what each missing field means.
     """
+    project_id = _read_project_id()
     schema: dict = {
         "defaults": _build_schema_defaults(),
+        "project_id": project_id,
         "name": app.name,
         "version": app.version,
         "help": app.help,

{strictcli-0.12.0 → strictcli-0.14.0}/tests/test_check_discovery.py

@@ -293,3 +293,54 @@ depends_on = []
                 name="testapp", version="1.0.0", help="test app",
                 checks_path=str(toml_file),
             )
+
+
+class TestChecksEmbed:
+    def test_checks_embed_enables_checks(self, tmp_path, monkeypatch):
+        """checks_embed with valid TOML bytes enables checks."""
+        monkeypatch.chdir(tmp_path)
+
+        app = strictcli.App(
+            name="testapp", version="1.0.0", help="test app",
+            checks_embed=VALID_TOML.encode(),
+        )
+        assert app._checks_enabled is True
+        assert "lint-code" in app._check_defs
+        assert "check-deps" in app._check_defs
+
+    def test_checks_embed_and_checks_path_raises(self, tmp_path, monkeypatch):
+        """Using both checks_path and checks_embed raises ValueError."""
+        monkeypatch.chdir(tmp_path)
+        toml_file = tmp_path / "checks.toml"
+        toml_file.write_text(VALID_TOML)
+
+        with pytest.raises(ValueError, match="cannot use both checks_path and checks_embed"):
+            strictcli.App(
+                name="testapp", version="1.0.0", help="test app",
+                checks_path=str(toml_file),
+                checks_embed=VALID_TOML.encode(),
+            )
+
+    def test_checks_embed_invalid_toml(self, tmp_path, monkeypatch):
+        """checks_embed with garbage bytes raises ValueError."""
+        monkeypatch.chdir(tmp_path)
+
+        with pytest.raises(ValueError, match="checks.toml:"):
+            strictcli.App(
+                name="testapp", version="1.0.0", help="test app",
+                checks_embed=b"\x80\x81 not valid toml {{{{",
+            )
+
+    def test_checks_embed_wrong_app_name(self, tmp_path, monkeypatch):
+        """checks_embed with mismatched app name raises ValueError."""
+        monkeypatch.chdir(tmp_path)
+        wrong_toml = 'app = "wrong"\n'
+
+        with pytest.raises(
+            ValueError,
+            match=r'checks.toml: app "wrong" does not match app name "testapp"',
+        ):
+            strictcli.App(
+                name="testapp", version="1.0.0", help="test app",
+                checks_embed=wrong_toml.encode(),
+            )

{strictcli-0.12.0 → strictcli-0.14.0}/tests/test_check_schema.py

@@ -2,9 +2,16 @@
 
 import json
 
+import pytest
 import strictcli
 
 
+@pytest.fixture(autouse=True)
+def _pyproject_in_tmp(tmp_path):
+    """Ensure every test that uses tmp_path has a pyproject.toml for project_id."""
+    (tmp_path / "pyproject.toml").write_text('[project]\nname = "testproject"\n')
+
+
 CHECKS_TOML = """\
 app = "testapp"
 

{strictcli-0.12.0 → strictcli-0.14.0}/tests/test_dump_schema.py

@@ -5,8 +5,17 @@ from __future__ import annotations
 import json
 import os
 
+import pytest
 import strictcli
 
+_PYPROJECT_TOML = '[project]\nname = "testproject"\n'
+
+
+@pytest.fixture(autouse=True)
+def _pyproject_in_tmp(tmp_path):
+    """Ensure every test that uses tmp_path has a pyproject.toml for project_id."""
+    (tmp_path / "pyproject.toml").write_text(_PYPROJECT_TOML)
+
 
 def _make_app(**kwargs):
     """Create a minimal app for testing."""
@@ -662,3 +671,60 @@ class TestSchemaNonDefaultValues:
         app.test(["--dump-schema"])
         data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
         assert data["config"] is True
+
+
+class TestSchemaProjectId:
+    """Schema contains project_id from pyproject.toml."""
+
+    def test_project_id_present(self, tmp_path, monkeypatch):
+        monkeypatch.chdir(tmp_path)
+        app = _make_app()
+
+        @app.command("noop", help="Does nothing")
+        def noop():
+            pass
+
+        app.test(["--dump-schema"])
+        data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
+        assert data["project_id"] == "testproject"
+
+    def test_project_id_custom_name(self, tmp_path, monkeypatch):
+        (tmp_path / "pyproject.toml").write_text(
+            '[project]\nname = "my-custom-tool"\n'
+        )
+        monkeypatch.chdir(tmp_path)
+        app = _make_app()
+
+        @app.command("noop", help="Does nothing")
+        def noop():
+            pass
+
+        app.test(["--dump-schema"])
+        data = json.loads((tmp_path / ".strictcli" / "schema.json").read_text())
+        assert data["project_id"] == "my-custom-tool"
+
+    def test_project_id_error_no_pyproject(self, tmp_path, monkeypatch):
+        os.remove(tmp_path / "pyproject.toml")
+        monkeypatch.chdir(tmp_path)
+        app = _make_app()
+
+        @app.command("noop", help="Does nothing")
+        def noop():
+            pass
+
+        result = app.test(["--dump-schema"])
+        assert result.exit_code != 0
+        assert "project_id" in result.stderr
+
+    def test_project_id_error_no_project_name(self, tmp_path, monkeypatch):
+        (tmp_path / "pyproject.toml").write_text("[tool.something]\nkey = 1\n")
+        monkeypatch.chdir(tmp_path)
+        app = _make_app()
+
+        @app.command("noop", help="Does nothing")
+        def noop():
+            pass
+
+        result = app.test(["--dump-schema"])
+        assert result.exit_code != 0
+        assert "project_id" in result.stderr

{strictcli-0.12.0 → strictcli-0.14.0}/uv.lock

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

strictcli-0.12.0/.github/workflows/publish.yml

@@ -1,32 +0,0 @@
-name: Publish
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-  pypi:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-      - run: uv build
-      - uses: pypa/gh-action-pypi-publish@release/v1
-
-  npm:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24
-          registry-url: https://registry.npmjs.org
-      - run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

strictcli-0.12.0/.rlsbl/bases/.github/workflows/publish.yml

@@ -1,32 +0,0 @@
-name: Publish
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-  pypi:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-      - run: uv build
-      - uses: pypa/gh-action-pypi-publish@release/v1
-
-  npm:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24
-          registry-url: https://registry.npmjs.org
-      - run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

strictcli-0.12.0/.rlsbl/changes/.validated

@@ -1 +0,0 @@
-c161283293520cc94f39d9cfec589f6f4cf5a352

strictcli-0.12.0/.rlsbl/version

@@ -1 +0,0 @@
-0.45.0