determa 0.1.0__tar.gz

determa-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# Python
+__pycache__/
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+
+# Rust
+/rust/target/
+Cargo.lock
+
+# Node
+node_modules/
+*.tgz

determa-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian-Manuel Butzke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

determa-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: determa
+Version: 0.1.0
+Summary: Umbrella launcher for the Determa family — git-style dispatch to determa-<product> commands
+Project-URL: Homepage, https://github.com/fruwehq/determa
+Project-URL: Repository, https://github.com/fruwehq/determa
+Project-URL: Issues, https://github.com/fruwehq/determa/issues
+Author: Christian-Manuel Butzke
+License: MIT License
+        
+        Copyright (c) 2026 Christian-Manuel Butzke
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cli,determa,dispatcher,launcher,statechart
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Provides-Extra: all
+Requires-Dist: determa-state; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: state
+Requires-Dist: determa-state; extra == 'state'
+Description-Content-Type: text/markdown
+
+# determa
+
+The **umbrella launcher** for the [Determa](https://github.com/fruwehq/determa) family.
+
+`determa` is a thin, git-style dispatcher: `determa <product> …` finds and runs the
+`determa-<product>` command on your `PATH`.
+
+```console
+$ pip install "determa[state]"     # launcher + the statechart engine
+$ determa state run machine.yaml   # → determa-state run machine.yaml
+$ determa list                     # installed products
+$ determa --version
+```
+
+- `pip install determa` — just the launcher.
+- `pip install "determa[state]"` — launcher + [`determa-state`](https://pypi.org/project/determa-state/).
+- `pip install "determa[all]"` — launcher + the whole family.
+
+The launcher is language-agnostic: it dispatches to whichever `determa-state` is on
+`PATH`, be it the Python or the Rust build. It ships no `determa/__init__.py`, so it
+coexists cleanly with `determa.state` as a PEP 420 namespace.
+
+## License
+
+MIT

determa-0.1.0/README.md

@@ -0,0 +1,25 @@
+# determa
+
+The **umbrella launcher** for the [Determa](https://github.com/fruwehq/determa) family.
+
+`determa` is a thin, git-style dispatcher: `determa <product> …` finds and runs the
+`determa-<product>` command on your `PATH`.
+
+```console
+$ pip install "determa[state]"     # launcher + the statechart engine
+$ determa state run machine.yaml   # → determa-state run machine.yaml
+$ determa list                     # installed products
+$ determa --version
+```
+
+- `pip install determa` — just the launcher.
+- `pip install "determa[state]"` — launcher + [`determa-state`](https://pypi.org/project/determa-state/).
+- `pip install "determa[all]"` — launcher + the whole family.
+
+The launcher is language-agnostic: it dispatches to whichever `determa-state` is on
+`PATH`, be it the Python or the Rust build. It ships no `determa/__init__.py`, so it
+coexists cleanly with `determa.state` as a PEP 420 namespace.
+
+## License
+
+MIT

determa-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "determa"
+version = "0.1.0"
+description = "Umbrella launcher for the Determa family — git-style dispatch to determa-<product> commands"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+authors = [{ name = "Christian-Manuel Butzke" }]
+keywords = ["determa", "cli", "launcher", "statechart", "dispatcher"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development",
+]
+
+[project.optional-dependencies]
+# Convenience installs: `pip install "determa[state]"` gets the launcher + the
+# statechart engine; `determa[all]` gets the whole family.
+state = ["determa-state"]
+all = ["determa-state"]
+dev = ["pytest>=8", "ruff"]
+
+[project.urls]
+Homepage = "https://github.com/fruwehq/determa"
+Repository = "https://github.com/fruwehq/determa"
+Issues = "https://github.com/fruwehq/determa/issues"
+
+[project.scripts]
+determa = "determa._cli:main"
+
+# `determa` is a PEP 420 namespace root (no determa/__init__.py) so it can coexist
+# with determa-state's `determa.state` package. Ship only the launcher module.
+[tool.hatch.build.targets.wheel]
+sources = ["src"]
+only-include = ["src/determa/_cli.py"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "W", "C4"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

determa-0.1.0/src/determa/_cli.py

@@ -0,0 +1,110 @@
+"""determa — umbrella launcher for the Determa family.
+
+A thin, git-style dispatcher: ``determa <product> [args…]`` finds and executes the
+``determa-<product>`` command on ``PATH`` (e.g. ``determa state run m.yaml`` →
+``determa-state run m.yaml``). It is language-agnostic — it dispatches to whichever
+``determa-state`` is installed, be it the Python or the Rust build.
+
+This distribution intentionally ships **no** ``determa/__init__.py`` so ``determa``
+stays a PEP 420 namespace root shared with ``determa.state`` and future ``determa.*``
+packages. The launcher lives here as a plain module in that namespace.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+
+PREFIX = "determa-"
+
+
+def _version() -> str:
+    try:
+        from importlib.metadata import version
+
+        return version("determa")
+    except Exception:
+        return "0+unknown"
+
+
+def _discover() -> list[str]:
+    """Product subcommands available as ``determa-<name>`` executables on ``PATH``."""
+    exts = [e for e in os.environ.get("PATHEXT", "").split(os.pathsep) if e] or [""]
+    found: set[str] = set()
+    for directory in os.environ.get("PATH", "").split(os.pathsep):
+        if not directory or not os.path.isdir(directory):
+            continue
+        try:
+            entries = os.listdir(directory)
+        except OSError:
+            continue
+        for name in entries:
+            if not name.startswith(PREFIX):
+                continue
+            stem = name
+            for ext in exts:
+                if ext and stem.lower().endswith(ext.lower()):
+                    stem = stem[: -len(ext)]
+                    break
+            sub = stem[len(PREFIX):]
+            if sub:
+                found.add(sub)
+    return sorted(found)
+
+
+def _help() -> str:
+    lines = [
+        f"determa {_version()} — umbrella launcher for the Determa family",
+        "",
+        "usage: determa <product> [args…]",
+        "       determa list        list installed products",
+        "       determa --version   show this launcher's version",
+        "",
+        "'determa <product> …' runs the 'determa-<product>' command on PATH,",
+        "e.g. 'determa state run m.yaml' → 'determa-state run m.yaml'.",
+        "",
+    ]
+    products = _discover()
+    if products:
+        lines.append("installed products:")
+        lines += [f"  {p}" for p in products]
+    else:
+        lines += [
+            "no products found on PATH. install one, e.g.:",
+            "  pip install determa-state",
+        ]
+    return "\n".join(lines)
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if not args or args[0] in ("-h", "--help", "help"):
+        print(_help())
+        return 0
+    if args[0] in ("-V", "--version", "version"):
+        print(f"determa {_version()}")
+        return 0
+    if args[0] == "list":
+        for product in _discover():
+            print(product)
+        return 0
+
+    sub, rest = args[0], args[1:]
+    exe = shutil.which(f"{PREFIX}{sub}")
+    if exe is None:
+        sys.stderr.write(
+            f"determa: unknown product '{sub}' — '{PREFIX}{sub}' not found on PATH.\n"
+            f"try 'determa list', or install it (e.g. 'pip install {PREFIX}{sub}').\n"
+        )
+        return 127
+    try:
+        return subprocess.call([exe, *rest])
+    except OSError as exc:  # pragma: no cover - defensive
+        sys.stderr.write(f"determa: failed to run {exe}: {exc}\n")
+        return 126
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

determa-0.1.0/tests/test_cli.py

@@ -0,0 +1,63 @@
+"""Unit tests for the determa launcher (dispatch, discovery, help/version)."""
+
+from __future__ import annotations
+
+import os
+import sys
+
+import pytest
+
+import determa._cli as cli
+
+
+def test_help_shows_usage(capsys):
+    assert cli.main(["--help"]) == 0
+    out = capsys.readouterr().out
+    assert "umbrella launcher for the Determa family" in out
+    assert "determa <product>" in out
+
+
+def test_no_args_is_help(capsys):
+    assert cli.main([]) == 0
+    assert "usage: determa" in capsys.readouterr().out
+
+
+def test_version(capsys):
+    assert cli.main(["--version"]) == 0
+    assert capsys.readouterr().out.startswith("determa ")
+
+
+def test_unknown_product_exits_127(capsys):
+    assert cli.main(["definitely-not-real"]) == 127
+    assert "not found on PATH" in capsys.readouterr().err
+
+
+@pytest.mark.skipif(sys.platform == "win32", reason="uses a POSIX shell stub")
+def test_dispatches_to_product_on_path(tmp_path, monkeypatch, capfd):
+    exe = tmp_path / "determa-echo"
+    exe.write_text('#!/bin/sh\necho "echo-product: $*"\nexit 0\n')
+    exe.chmod(0o755)
+    monkeypatch.setenv("PATH", str(tmp_path) + os.pathsep + os.environ.get("PATH", ""))
+
+    assert cli.main(["echo", "hello", "world"]) == 0
+    assert "echo-product: hello world" in capfd.readouterr().out
+
+
+@pytest.mark.skipif(sys.platform == "win32", reason="uses a POSIX shell stub")
+def test_dispatch_propagates_exit_code(tmp_path, monkeypatch):
+    exe = tmp_path / "determa-boom"
+    exe.write_text("#!/bin/sh\nexit 3\n")
+    exe.chmod(0o755)
+    monkeypatch.setenv("PATH", str(tmp_path) + os.pathsep + os.environ.get("PATH", ""))
+    assert cli.main(["boom"]) == 3
+
+
+@pytest.mark.skipif(sys.platform == "win32", reason="uses a POSIX shell stub")
+def test_list_discovers_products(tmp_path, monkeypatch, capsys):
+    (tmp_path / "determa-alpha").write_text("#!/bin/sh\n")
+    (tmp_path / "determa-beta").write_text("#!/bin/sh\n")
+    for f in ("determa-alpha", "determa-beta"):
+        (tmp_path / f).chmod(0o755)
+    monkeypatch.setenv("PATH", str(tmp_path))  # isolate PATH to the stub dir
+    assert cli.main(["list"]) == 0
+    assert capsys.readouterr().out.split() == ["alpha", "beta"]