strictcli 0.41.1__tar.gz → 0.41.2__tar.gz

{strictcli-0.41.1 → strictcli-0.41.2}/PKG-INFO

@@ -1,16 +1,21 @@
 Metadata-Version: 2.5
 Name: strictcli
-Version: 0.41.1
-Summary: A strict CLI framework for Python
-Project-URL: Homepage, https://github.com/smm-h/strictcli
+Version: 0.41.2
+Summary: A strict CLI framework for Python, Go and TypeScript that makes you declare every command, flag, argument and help string, and errors at registration time on anything left unstated (Python implementation)
+Project-URL: Homepage, https://smmh.dev/strictcli/
+Project-URL: Documentation, https://smmh.dev/strictcli/
 Project-URL: Repository, https://github.com/smm-h/strictcli
+Project-URL: Issues, https://github.com/smm-h/strictcli/issues
+Project-URL: Changelog, https://github.com/smm-h/strictcli/blob/main/CHANGELOG.md
 Author-email: "S. M. Hosseini" <m.hosseini@veliu.com>
 License-Expression: MIT
 License-File: LICENSE
-Keywords: argparse,cli,command-line,framework,rlsbl,strictcli
+Keywords: argparse,argument-parser,cli,cli-framework,command-line,framework,rlsbl,strictcli
 Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
@@ -19,7 +24,7 @@ Description-Content-Type: text/markdown
 
 # strictcli
 
-A strict CLI framework for Python.
+A strict CLI framework for Python, Go and TypeScript that makes you declare every command, flag, argument and help string, and errors at registration time on anything left unstated (Python implementation).
 
 strictcli makes you declare everything -- every command, flag, argument, and environment variable must have help text or the framework errors at registration time. Four types only: `str`, `bool`, `int`, `float`. No magic type inference, no implicit defaults.
 

{strictcli-0.41.1 → strictcli-0.41.2}/README.md

@@ -1,6 +1,6 @@
 # strictcli
 
-A strict CLI framework for Python.
+A strict CLI framework for Python, Go and TypeScript that makes you declare every command, flag, argument and help string, and errors at registration time on anything left unstated (Python implementation).
 
 strictcli makes you declare everything -- every command, flag, argument, and environment variable must have help text or the framework errors at registration time. Four types only: `str`, `bool`, `int`, `float`. No magic type inference, no implicit defaults.
 

{strictcli-0.41.1 → strictcli-0.41.2}/pyproject.toml

@@ -4,17 +4,28 @@ build-backend = "hatchling.build"
 
 [project]
 name = "strictcli"
-version = "0.41.1"
-description = "A strict CLI framework for Python"
+version = "0.41.2"
+description = "A strict CLI framework for Python, Go and TypeScript that makes you declare every command, flag, argument and help string, and errors at registration time on anything left unstated (Python implementation)"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.11"
 authors = [{ name = "S. M. Hosseini", email = "m.hosseini@veliu.com" }]
-keywords = ["strictcli", "cli", "argparse", "command-line", "framework", "rlsbl"]
+keywords = [
+    "strictcli",
+    "cli",
+    "cli-framework",
+    "command-line",
+    "argument-parser",
+    "argparse",
+    "framework",
+    "rlsbl",
+]
 classifiers = [
     "Development Status :: 3 - Alpha",
+    "Environment :: Console",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
@@ -29,5 +40,8 @@ dev = ["pytest", "allpairspy", "jsonschema"]
 testpaths = ["tests"]
 
 [project.urls]
-Homepage = "https://github.com/smm-h/strictcli"
+Homepage = "https://smmh.dev/strictcli/"
+Documentation = "https://smmh.dev/strictcli/"
 Repository = "https://github.com/smm-h/strictcli"
+Issues = "https://github.com/smm-h/strictcli/issues"
+Changelog = "https://github.com/smm-h/strictcli/blob/main/CHANGELOG.md"

{strictcli-0.41.1 → strictcli-0.41.2}/strictcli/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.41.1"
+__version__ = "0.41.2"
 
 __all__ = [
     "App", "Flag", "Arg", "FlagSet",
@@ -8978,6 +8978,12 @@ class App:
             # recorder and the check provider use these absolute paths so that
             # tests which chdir still record into the repo, and a check evaluated
             # from a foreign cwd reads the app's own repo state.
+            #
+            # Only the PATHS are computed here. The directory itself is created
+            # lazily by _record_coverage, immediately before the first shard
+            # write: shards are written only on the test-harness paths (test()
+            # and call()), so a plain CLI invocation must leave no .strictcli/
+            # behind in whatever directory it was run from.
             self._coverage_dir = os.path.abspath(
                 os.path.join(".strictcli", "coverage")
             )
@@ -8988,7 +8994,6 @@ class App:
                 self._coverage_dir,
                 f"{os.getpid()}.jsonl",
             )
-            os.makedirs(self._coverage_dir, exist_ok=True)
             self.register_check_provider(self._test_coverage_provider)
 
     def _validate_flag_infra_marker(self, f: Flag) -> None:

{strictcli-0.41.1 → strictcli-0.41.2}/tests/test_coverage.py

@@ -206,6 +206,7 @@ class TestCoverageCheck:
         when NEITHER a manifest NOR any shards exist."""
         app = _make_app(tmp_path)
         manifest_path = tmp_path / ".strictcli" / "test-coverage.json"
+        manifest_path.parent.mkdir(parents=True, exist_ok=True)
         manifest_path.write_text("[]\n")
 
         results, _, code = app.run_checks(
@@ -296,6 +297,7 @@ class TestManifestUnionVerdict:
         with no shard files (the machine never ran the suite)."""
         app = _make_app(tmp_path)
         manifest_path = tmp_path / ".strictcli" / "test-coverage.json"
+        manifest_path.parent.mkdir(parents=True, exist_ok=True)
         manifest_path.write_text(
             json.dumps(["build", "deploy", "status"], indent=2) + "\n"
         )
@@ -312,6 +314,7 @@ class TestManifestUnionVerdict:
         (anchored manifest), not the foreign directory."""
         app = _make_app(tmp_path)
         manifest_path = tmp_path / ".strictcli" / "test-coverage.json"
+        manifest_path.parent.mkdir(parents=True, exist_ok=True)
         manifest_path.write_text(
             json.dumps(["build", "deploy", "status"], indent=2) + "\n"
         )
@@ -330,6 +333,7 @@ class TestManifestUnionVerdict:
         """A run recording only a subset keeps prior commands covered (union)."""
         app = _make_app(tmp_path)
         manifest_path = tmp_path / ".strictcli" / "test-coverage.json"
+        manifest_path.parent.mkdir(parents=True, exist_ok=True)
         manifest_path.write_text(
             json.dumps(["build", "deploy", "status"], indent=2) + "\n"
         )
@@ -374,3 +378,35 @@ class TestCoverageDisabled:
 
         coverage_dir = tmp_path / ".strictcli" / "coverage"
         assert not coverage_dir.exists()
+
+
+class TestCoverageDirectoryIsLazy:
+    def test_construction_leaves_no_directory(self, tmp_path):
+        """Constructing an app with test_coverage=True must not create
+        .strictcli/ -- a plain CLI invocation never records coverage, so it must
+        not plant an empty directory in whatever cwd it was run from."""
+        app = _make_app(tmp_path)
+        assert app is not None
+        assert not (tmp_path / ".strictcli").exists()
+
+    def test_recording_creates_the_directory(self, tmp_path):
+        """The recorder creates the coverage directory immediately before the
+        first shard write."""
+        app = _make_app(tmp_path)
+        app.test(["deploy"])
+
+        shard = tmp_path / ".strictcli" / "coverage" / f"{os.getpid()}.jsonl"
+        assert shard.is_file()
+
+    def test_check_skips_when_directory_absent(self, tmp_path):
+        """The provider reads a coverage root that does not exist without
+        raising -- it reports the subject-matter SKIP."""
+        app = _make_app(tmp_path)
+        assert not (tmp_path / ".strictcli").exists()
+
+        results, _, _code = app.run_checks(
+            SimpleCtx(project_root=tmp_path),
+            run_all=True,
+        )
+        cov_result = next(r for r in results if r.name == "cli-test-coverage")
+        assert cov_result.status == "skip"

{strictcli-0.41.1 → strictcli-0.41.2}/uv.lock

@@ -232,7 +232,7 @@ wheels = [
 
 [[package]]
 name = "strictcli"
-version = "0.41.1"
+version = "0.41.2"
 source = { editable = "." }
 dependencies = [
     { name = "tomlkit" },