dockflow-cli 0.1.0__py3-none-any.whl

dockflow_cli/__init__.py

@@ -0,0 +1 @@
+"""Dockflow's lightweight command host; importing this module has no effects."""

dockflow_cli/main.py

@@ -0,0 +1,93 @@
+"""Installed-distribution extension discovery and the shared command boundary."""
+
+import re
+import sys
+from importlib import metadata
+
+import typer
+from typer.main import get_command
+
+
+def _provider(entry) -> str:
+    dist = getattr(entry, "dist", None)
+    return f"{dist.name} ({entry.value})" if dist else entry.value
+
+
+def create_app() -> typer.Typer:
+    app = typer.Typer(
+        add_completion=False,
+        no_args_is_help=False,
+        help="Dockflow — installed workflow tools.",
+        pretty_exceptions_enable=False,
+    )
+    entries = sorted(
+        metadata.entry_points(group="dockflow_cli.modules"),
+        key=lambda entry: (entry.name, _provider(entry)),
+    )
+    seen = {}
+    for entry in entries:
+        if not re.fullmatch(r"[a-z][a-z0-9]*(?:-[a-z0-9]+)*", entry.name):
+            raise RuntimeError(f"Invalid module {entry.name!r} from {_provider(entry)}")
+        if entry.name in {"help", "version"} or entry.name in seen:
+            other = _provider(seen[entry.name]) if entry.name in seen else "built-in"
+            raise RuntimeError(
+                f"Module {entry.name!r} conflicts: {_provider(entry)} and {other}"
+            )
+        seen[entry.name] = entry
+    for entry in entries:
+        try:
+            plugin = entry.load()
+            if not isinstance(plugin, typer.Typer):
+                raise TypeError("entry point must export a typer.Typer instance")
+            get_command(plugin)
+            app.add_typer(plugin, name=entry.name)
+        except Exception as exc:
+            raise RuntimeError(
+                f"Cannot load module {entry.name!r} from {_provider(entry)}: {exc}"
+            ) from exc
+
+    @app.callback(invoke_without_command=True)
+    def root(
+        ctx: typer.Context,
+        version: bool = typer.Option(
+            False, "--version", help="Show the installed Dockflow version."
+        ),
+    ):
+        if ctx.invoked_subcommand is None:
+            typer.echo(ctx.get_help())
+            if not entries:
+                typer.echo(
+                    "Install a Dockflow feature package in this Python environment "
+                    "to add command groups."
+                )
+
+    return app
+
+
+def main() -> None:
+    """Run the console host, preserving deliberate command exit statuses."""
+    # Root options precede module words. Never discover providers for --version.
+    root_args = sys.argv[1:]
+    if root_args and root_args[0] == "--version":
+        if len(root_args) != 1:
+            typer.echo("--version does not accept command arguments", err=True)
+            raise SystemExit(2)
+        try:
+            typer.echo(f"dockflow {metadata.version('dockflow-cli')}")
+        except metadata.PackageNotFoundError:
+            typer.echo(
+                "dockflow-cli metadata is missing; reinstall dockflow-cli", err=True
+            )
+            raise SystemExit(1) from None
+        return
+    try:
+        create_app()()
+    except (SystemExit, KeyboardInterrupt):
+        raise
+    except Exception as exc:
+        typer.echo(f"Dockflow: {exc}", err=True)
+        raise SystemExit(1) from None
+
+
+if __name__ == "__main__":
+    main()

dockflow_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: dockflow-cli
+Version: 0.1.0
+Summary: Dockflow extensible command host
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: typer>=0.27.3,<0.28.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/dockflow-project/dockflow
+Project-URL: Documentation, https://github.com/dockflow-project/dockflow/blob/main/docs/README.md
+Project-URL: Issues, https://github.com/dockflow-project/dockflow/issues
+Project-URL: Changelog, https://github.com/dockflow-project/dockflow/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# Dockflow CLI
+
+`dockflow-cli` supplies the shared `dockflow` executable. Installed feature
+packages register Typer applications through the `dockflow_cli.modules` Python
+entry-point group; `dockflow-pipelines` supplies the `pipelines` commands.
+
+```text
+dockflow --help
+dockflow --version
+dockflow pipelines --help
+```
+
+Help/version requests are offline. Installing this package alone does not start
+services, install feature modules or contact a registry. The command host reports
+invalid or conflicting plugin registrations rather than silently omitting them.
+
+Install the command host with Python 3.12 or newer:
+
+```bash
+pip install dockflow-cli==0.1.0
+```
+
+Installing `dockflow-pipelines==0.1.0` also installs this matching host.
+MIT licensed. See [installation](https://github.com/dockflow-project/dockflow/blob/main/docs/installation.md),
+[CLI usage](https://github.com/dockflow-project/dockflow/blob/main/docs/cli.md) and the [contribution guide](https://github.com/dockflow-project/dockflow/blob/main/CONTRIBUTING.md).

dockflow_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+dockflow_cli/__init__.py,sha256=jl7k7JP7yrWqG8clLU8GHAYbNEMYxbvufmDAo-aDKQc,81
+dockflow_cli/main.py,sha256=wVPii88KL5hex7VkCr_ohCG-JvYvsnztC6zDFsbSP_E,3154
+dockflow_cli-0.1.0.dist-info/licenses/LICENSE,sha256=uIXEE60dM30LHZXUm4HhF2tw0Zy02FRsqdapPi9x1tI,1078
+dockflow_cli-0.1.0.dist-info/WHEEL,sha256=a0ta4TK7UKMB0EbDesmi2mn0Djkly7aj_7Tu2R7SseE,81
+dockflow_cli-0.1.0.dist-info/entry_points.txt,sha256=o8Jo9AwxBGao5sxg8VnzckRbt1RQc5Wq3ODQ71w6tDM,53
+dockflow_cli-0.1.0.dist-info/METADATA,sha256=XzjN1fgx-aY0c3QDeQ203af_wKU2C_avgw2wAx_AbAA,1605
+dockflow_cli-0.1.0.dist-info/RECORD,,

dockflow_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.33
+Root-Is-Purelib: true
+Tag: py3-none-any

dockflow_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dockflow = dockflow_cli.main:main
+

dockflow_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dockflow contributors
+
+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.