strictcli 0.4.1__tar.gz → 0.5.0__tar.gz

strictcli-0.5.0/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+d7f1969ff795da06e8ed45792a8508559487c830

strictcli-0.5.0/.rlsbl/changes/0.5.0.jsonl

@@ -0,0 +1,3 @@
+{"commits":["2a230acb24171d4d380ef4c499f20dc834db9aae"],"user_facing":true,"description":"**New feature.** `Implies` flag dependency type: when a trigger flag is set, automatically set a target bool flag to a specified value. Explicit contradictions are parse errors.","type":"feature"}
+{"commits":["8802c6d7d49c9d0243e29439ff0488db0d817caa"],"user_facing":false}
+{"commits":["af7f4514b16a02cb275b8cae467a6d6c9952c558"],"user_facing":false}

strictcli-0.5.0/.rlsbl/changes/0.5.0.md

@@ -0,0 +1,5 @@
+## 0.5.0
+
+### Features
+
+- **New feature.** `Implies` flag dependency type: when a trigger flag is set, automatically set a target bool flag to a specified value. Explicit contradictions are parse errors.

strictcli-0.5.0/.rlsbl/version

@@ -0,0 +1 @@
+0.32.0

{strictcli-0.4.1 → strictcli-0.5.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 # Changelog
 
+## 0.5.0
+
+### Features
+
+- **New feature.** `Implies` flag dependency type: when a trigger flag is set, automatically set a target bool flag to a specified value. Explicit contradictions are parse errors.
+
 ## 0.4.1
 
 ### Fixes

{strictcli-0.4.1 → strictcli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strictcli
-Version: 0.4.1
+Version: 0.5.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.4.1 → strictcli-0.5.0}/package.json

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

{strictcli-0.4.1 → strictcli-0.5.0}/pyproject.toml

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

{strictcli-0.4.1 → strictcli-0.5.0}/strictcli/__init__.py

@@ -2,11 +2,11 @@
 
 from __future__ import annotations
 
-__version__ = "0.4.1"
+__version__ = "0.5.0"
 
 __all__ = [
     "App", "Flag", "Arg", "Tag", "MutexGroup", "CoRequired", "Requires",
-    "Passthrough", "Result", "flag", "arg",
+    "Implies", "Passthrough", "Result", "flag", "arg",
 ]
 
 import contextlib
@@ -175,6 +175,15 @@ class Requires:
     depends_on: str
 
 
+@dataclass
+class Implies:
+    """When a trigger flag is provided, automatically set a target flag to a value."""
+
+    flag: str       # trigger flag name
+    implies: str    # target flag name
+    value: bool     # value to set on target when trigger is present
+
+
 @dataclass
 class Passthrough:
     """Marks a command as passthrough -- all tokens after the command name are
@@ -194,7 +203,7 @@ class Command:
     args: list[Arg] = field(default_factory=list)
     tags: list[Tag] = field(default_factory=list)
     mutex: list[MutexGroup] = field(default_factory=list)
-    dependencies: list[CoRequired | Requires] = field(default_factory=list)
+    dependencies: list[CoRequired | Requires | Implies] = field(default_factory=list)
     passthrough: Passthrough | None = None
 
     def __post_init__(self) -> None:
@@ -222,7 +231,7 @@ class Group:
         args: list[Arg] | None = None,
         tags: list[Tag] | None = None,
         mutex: list[MutexGroup] | None = None,
-        dependencies: list[CoRequired | Requires] | None = None,
+        dependencies: list[CoRequired | Requires | Implies] | None = None,
         passthrough: Passthrough | None = None,
     ) -> Callable:
         """Decorator to register a command within this group."""
@@ -281,7 +290,7 @@ class App:
         args: list[Arg] | None = None,
         tags: list[Tag] | None = None,
         mutex: list[MutexGroup] | None = None,
-        dependencies: list[CoRequired | Requires] | None = None,
+        dependencies: list[CoRequired | Requires | Implies] | None = None,
         passthrough: Passthrough | None = None,
     ) -> Callable:
         """Decorator to register a top-level command."""
@@ -849,6 +858,22 @@ def _parse_command(
             names = ", ".join(f"--{f.name}" for f in mg.flags)
             raise _ParseError(f"one of {names} is required")
 
+    # Step 4.55: resolve Implies dependencies (before dependency checks, so
+    # implied values participate in downstream CoRequired/Requires validation)
+    for dep in cmd.dependencies:
+        if isinstance(dep, Implies):
+            if dep.flag in cli_set:
+                if dep.implies in cli_set:
+                    if cli_set[dep.implies] != dep.value:
+                        neg = "no-" if not dep.value else ""
+                        explicit_neg = "" if not dep.value else "no-"
+                        raise _ParseError(
+                            f"flag '--{dep.flag}' implies '--{neg}{dep.implies}', "
+                            f"but '--{explicit_neg}{dep.implies}' was explicitly provided"
+                        )
+                else:
+                    cli_set[dep.implies] = dep.value
+
     # Step 4.6: enforce flag dependencies (before defaults, so cli_set only
     # contains values explicitly provided via CLI or env)
     for dep in cmd.dependencies:
@@ -974,7 +999,7 @@ def _build_and_validate_command(
     args: list[Arg] | None,
     tags: list[Tag] | None,
     mutex: list[MutexGroup] | None,
-    dependencies: list[CoRequired | Requires] | None = None,
+    dependencies: list[CoRequired | Requires | Implies] | None = None,
     env_prefix: str | None,
     global_flags: list[Flag] | None = None,
     passthrough: Passthrough | None = None,
@@ -1182,6 +1207,41 @@ def _build_and_validate_command(
                     f'command "{name}": Requires flag and depends_on cannot be '
                     f'the same ("{dep.flag}")'
                 )
+        elif isinstance(dep, Implies):
+            if dep.flag not in seen_flag_names:
+                raise ValueError(
+                    f'command "{name}": Implies references unknown flag '
+                    f'"{dep.flag}"'
+                )
+            if dep.implies not in seen_flag_names:
+                raise ValueError(
+                    f'command "{name}": Implies references unknown flag '
+                    f'"{dep.implies}"'
+                )
+            if dep.flag == dep.implies:
+                raise ValueError(
+                    f'command "{name}": Implies flag and implies cannot be '
+                    f'the same ("{dep.flag}")'
+                )
+            # Look up the actual Flag objects to validate types
+            all_flags_by_name = {f.name: f for f in all_flags}
+            trigger_flag = all_flags_by_name[dep.flag]
+            target_flag = all_flags_by_name[dep.implies]
+            if trigger_flag.type is not bool:
+                raise ValueError(
+                    f'command "{name}": Implies trigger flag "{dep.flag}" '
+                    f"must be type=bool"
+                )
+            if target_flag.type is not bool:
+                raise ValueError(
+                    f'command "{name}": Implies target flag "{dep.implies}" '
+                    f"must be type=bool"
+                )
+            if not isinstance(dep.value, bool):
+                raise ValueError(
+                    f'command "{name}": Implies value must be a bool, '
+                    f"got {type(dep.value).__name__!r}"
+                )
 
     return Command(
         name=name,

{strictcli-0.4.1 → strictcli-0.5.0}/tests/test_dependencies.py

@@ -1,4 +1,4 @@
-"""Tests for CoRequired and Requires flag dependencies."""
+"""Tests for CoRequired, Requires, and Implies flag dependencies."""
 
 import pytest
 
@@ -398,3 +398,271 @@ def test_corequired_duplicate_flag_error():
         @strictcli.flag("output", type=str, help="output path", default=None)
         def cmd(output):
             pass
+
+
+# ===========================================================================
+# Implies tests
+# ===========================================================================
+
+
+# ---------------------------------------------------------------------------
+# Implies: trigger set -> target auto-set to implied value
+# ---------------------------------------------------------------------------
+
+
+def test_implies_trigger_set_target_auto_set():
+    """Implies: when trigger is set, target is automatically set to implied value."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[strictcli.Implies(flag="fast", implies="embeddings", value=False)],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode")
+    @strictcli.flag("embeddings", type=bool, help="use embeddings")
+    def cmd(fast, embeddings):
+        print(f"fast={fast} embeddings={embeddings}")
+
+    r = app.test(["cmd", "--fast"])
+    assert r.exit_code == 0
+    assert "fast=True" in r.stdout
+    assert "embeddings=False" in r.stdout
+
+
+# ---------------------------------------------------------------------------
+# Implies: trigger not set -> target gets normal default
+# ---------------------------------------------------------------------------
+
+
+def test_implies_trigger_not_set_target_gets_default():
+    """Implies: when trigger is not set, target gets its normal default."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[strictcli.Implies(flag="fast", implies="embeddings", value=False)],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode")
+    @strictcli.flag("embeddings", type=bool, help="use embeddings", default=True)
+    def cmd(fast, embeddings):
+        print(f"fast={fast} embeddings={embeddings}")
+
+    r = app.test(["cmd"])
+    assert r.exit_code == 0
+    assert "fast=False" in r.stdout
+    assert "embeddings=True" in r.stdout
+
+
+# ---------------------------------------------------------------------------
+# Implies: explicit conflict -> parse error
+# ---------------------------------------------------------------------------
+
+
+def test_implies_explicit_conflict_error():
+    """Implies: trigger + contradicting explicit target -> error."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[strictcli.Implies(flag="fast", implies="embeddings", value=False)],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode")
+    @strictcli.flag("embeddings", type=bool, help="use embeddings")
+    def cmd(fast, embeddings):
+        pass
+
+    r = app.test(["cmd", "--fast", "--embeddings"])
+    assert r.exit_code == 1
+    assert "implies" in r.stderr
+    assert "--fast" in r.stderr
+    assert "--no-embeddings" in r.stderr
+    assert "explicitly provided" in r.stderr
+
+
+# ---------------------------------------------------------------------------
+# Implies: explicit agreement -> no error
+# ---------------------------------------------------------------------------
+
+
+def test_implies_explicit_agreement_ok():
+    """Implies: trigger + matching explicit target -> OK."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[strictcli.Implies(flag="fast", implies="embeddings", value=False)],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode")
+    @strictcli.flag("embeddings", type=bool, help="use embeddings")
+    def cmd(fast, embeddings):
+        print(f"fast={fast} embeddings={embeddings}")
+
+    r = app.test(["cmd", "--fast", "--no-embeddings"])
+    assert r.exit_code == 0
+    assert "fast=True" in r.stdout
+    assert "embeddings=False" in r.stdout
+
+
+# ---------------------------------------------------------------------------
+# Registration error: unknown trigger flag
+# ---------------------------------------------------------------------------
+
+
+def test_implies_unknown_trigger_flag_error():
+    """Implies: unknown trigger flag -> ValueError at registration."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    with pytest.raises(ValueError, match='Implies references unknown flag "nonexistent"'):
+
+        @app.command(
+            "cmd", help="a command",
+            dependencies=[strictcli.Implies(flag="nonexistent", implies="embeddings", value=False)],
+        )
+        @strictcli.flag("embeddings", type=bool, help="use embeddings")
+        def cmd(embeddings):
+            pass
+
+
+# ---------------------------------------------------------------------------
+# Registration error: unknown target flag
+# ---------------------------------------------------------------------------
+
+
+def test_implies_unknown_target_flag_error():
+    """Implies: unknown target flag -> ValueError at registration."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    with pytest.raises(ValueError, match='Implies references unknown flag "nonexistent"'):
+
+        @app.command(
+            "cmd", help="a command",
+            dependencies=[strictcli.Implies(flag="fast", implies="nonexistent", value=False)],
+        )
+        @strictcli.flag("fast", type=bool, help="fast mode")
+        def cmd(fast):
+            pass
+
+
+# ---------------------------------------------------------------------------
+# Registration error: self-implication
+# ---------------------------------------------------------------------------
+
+
+def test_implies_self_implication_error():
+    """Implies: flag == implies -> ValueError at registration."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    with pytest.raises(ValueError, match="cannot be the same"):
+
+        @app.command(
+            "cmd", help="a command",
+            dependencies=[strictcli.Implies(flag="fast", implies="fast", value=True)],
+        )
+        @strictcli.flag("fast", type=bool, help="fast mode")
+        def cmd(fast):
+            pass
+
+
+# ---------------------------------------------------------------------------
+# Registration error: trigger flag is not bool
+# ---------------------------------------------------------------------------
+
+
+def test_implies_trigger_not_bool_error():
+    """Implies: trigger flag not type=bool -> ValueError at registration."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    with pytest.raises(ValueError, match='trigger flag "name" must be type=bool'):
+
+        @app.command(
+            "cmd", help="a command",
+            dependencies=[strictcli.Implies(flag="name", implies="embeddings", value=False)],
+        )
+        @strictcli.flag("name", type=str, help="a name", default="")
+        @strictcli.flag("embeddings", type=bool, help="use embeddings")
+        def cmd(name, embeddings):
+            pass
+
+
+# ---------------------------------------------------------------------------
+# Registration error: target flag is not bool
+# ---------------------------------------------------------------------------
+
+
+def test_implies_target_not_bool_error():
+    """Implies: target flag not type=bool -> ValueError at registration."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    with pytest.raises(ValueError, match='target flag "name" must be type=bool'):
+
+        @app.command(
+            "cmd", help="a command",
+            dependencies=[strictcli.Implies(flag="fast", implies="name", value=False)],
+        )
+        @strictcli.flag("fast", type=bool, help="fast mode")
+        @strictcli.flag("name", type=str, help="a name", default="")
+        def cmd(fast, name):
+            pass
+
+
+# ---------------------------------------------------------------------------
+# Env var trigger: trigger set via env var also triggers implication
+# ---------------------------------------------------------------------------
+
+
+def test_implies_env_var_trigger(monkeypatch):
+    """Implies: trigger set via env var -> target auto-set."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[strictcli.Implies(flag="fast", implies="embeddings", value=False)],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode",
+                    env="TEST_IMPLIES_FAST", prefixed=False)
+    @strictcli.flag("embeddings", type=bool, help="use embeddings")
+    def cmd(fast, embeddings):
+        print(f"fast={fast} embeddings={embeddings}")
+
+    monkeypatch.setenv("TEST_IMPLIES_FAST", "true")
+    r = app.test(["cmd"])
+    assert r.exit_code == 0
+    assert "fast=True" in r.stdout
+    assert "embeddings=False" in r.stdout
+
+
+# ---------------------------------------------------------------------------
+# Interaction: Implies + Requires on same command
+# ---------------------------------------------------------------------------
+
+
+def test_implies_with_requires_interaction():
+    """Implies + Requires on same command work together."""
+    app = strictcli.App(name="test", version="1.0.0", help="test app")
+
+    @app.command(
+        "cmd", help="a command",
+        dependencies=[
+            strictcli.Implies(flag="fast", implies="embeddings", value=False),
+            strictcli.Requires(flag="output", depends_on="fast"),
+        ],
+    )
+    @strictcli.flag("fast", type=bool, help="fast mode")
+    @strictcli.flag("embeddings", type=bool, help="use embeddings")
+    @strictcli.flag("output", type=str, help="output path", default=None)
+    def cmd(fast, embeddings, output):
+        print(f"fast={fast} embeddings={embeddings} output={output}")
+
+    # --fast --output works (Requires satisfied, Implies sets embeddings=False)
+    r = app.test(["cmd", "--fast", "--output", "file.txt"])
+    assert r.exit_code == 0
+    assert "fast=True" in r.stdout
+    assert "embeddings=False" in r.stdout
+    assert "output=file.txt" in r.stdout
+
+    # --output without --fast -> error (Requires violation)
+    r = app.test(["cmd", "--output", "file.txt"])
+    assert r.exit_code == 1
+    assert "requires" in r.stderr
+    assert "--output" in r.stderr
+    assert "--fast" in r.stderr

{strictcli-0.4.1 → strictcli-0.5.0}/uv.lock

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

strictcli-0.4.1/.rlsbl/changes/.validated

@@ -1 +0,0 @@
-9f2ad6a550f949c15aeb8301b16a999601dd3a79

strictcli-0.4.1/.rlsbl/version

@@ -1 +0,0 @@
-0.31.0