dhis2w-cli 0.5.2__tar.gz

dhis2w_cli-0.5.2/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: dhis2w-cli
+Version: 0.5.2
+Summary: dhis2 command-line interface (Typer) — mounts plugins from dhis2-core.
+Author: Morten Hansen
+Author-email: Morten Hansen <morten@winterop.com>
+Requires-Dist: dhis2w-core>=0.5.0,<0.6
+Requires-Dist: typer>=0.24
+Requires-Dist: rich>=15
+Requires-Dist: dhis2w-browser>=0.5.0,<0.6 ; extra == 'browser'
+Requires-Python: >=3.13
+Provides-Extra: browser
+Description-Content-Type: text/markdown
+

dhis2w_cli-0.5.2/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "dhis2w-cli"
+version = "0.5.2"
+description = "dhis2 command-line interface (Typer) — mounts plugins from dhis2-core."
+readme = "README.md"
+authors = [{ name = "Morten Hansen", email = "morten@winterop.com" }]
+requires-python = ">=3.13"
+dependencies = [
+  "dhis2w-core>=0.5.0,<0.6",
+  "typer>=0.24",
+  "rich>=15",
+]
+
+[project.optional-dependencies]
+browser = ["dhis2w-browser>=0.5.0,<0.6"]
+
+[project.scripts]
+dhis2 = "dhis2w_cli.main:main"
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.12.0"]
+build-backend = "uv_build"

dhis2w_cli-0.5.2/src/dhis2w_cli/__init__.py

@@ -0,0 +1 @@
+"""Typer console script entrypoint for dhis2."""

dhis2w_cli-0.5.2/src/dhis2w_cli/main.py

@@ -0,0 +1,106 @@
+"""Typer root for the `dhis2` CLI — discovers plugins and mounts them."""
+
+from __future__ import annotations
+
+import logging
+import os
+from typing import Annotated
+
+import typer
+from dhis2w_core.cli_errors import run_app
+from dhis2w_core.cli_output import JSON_OUTPUT
+from dhis2w_core.plugin import discover_plugins
+from dhis2w_core.rich_console import STDERR_CONSOLE
+from rich.logging import RichHandler
+
+
+def _enable_debug_logging() -> None:
+    """Turn on dhis2-client HTTP traces + dhis2-core debug logs on stderr.
+
+    Uses `rich.logging.RichHandler` tied to the shared `STDERR_CONSOLE` so log
+    lines render above any active Rich `Progress` / `Status` display instead
+    of tearing through it.
+    """
+    handler = RichHandler(
+        console=STDERR_CONSOLE,
+        show_path=False,
+        show_time=True,
+        markup=False,
+        rich_tracebacks=False,
+        log_time_format="%H:%M:%S",
+    )
+    handler.setLevel(logging.DEBUG)
+    root = logging.getLogger()
+    root.addHandler(handler)
+    for name in ("dhis2w_client", "dhis2w_core"):
+        logging.getLogger(name).setLevel(logging.DEBUG)
+
+
+def build_app() -> typer.Typer:
+    """Build a fresh Typer app with every discovered plugin mounted.
+
+    Every call returns a new app, which keeps unit tests hermetic and lets
+    callers introspect the mounted surface without side effects.
+
+    `pretty_exceptions_enable=False` so our `run_app` wrapper (invoked from
+    `main()` below) sees uncaught exceptions and can render them cleanly.
+    """
+    app = typer.Typer(
+        help="dhis2 — command-line interface for DHIS2 (discovers plugins from dhis2-core).",
+        no_args_is_help=True,
+        add_completion=False,
+        pretty_exceptions_enable=False,
+    )
+
+    @app.callback()
+    def _root(
+        profile: Annotated[
+            str | None,
+            typer.Option(
+                "--profile",
+                "-p",
+                help="DHIS2 profile name (overrides DHIS2_PROFILE env + TOML default).",
+            ),
+        ] = None,
+        debug: Annotated[
+            bool,
+            typer.Option(
+                "--debug",
+                "-d",
+                help="Verbose output on stderr — HTTP method/URL/status/elapsed for every request.",
+            ),
+        ] = False,
+        json_: Annotated[
+            bool,
+            typer.Option(
+                "--json",
+                "-j",
+                help="Emit raw JSON to stdout instead of Rich tables (uniform across all commands).",
+            ),
+        ] = False,
+    ) -> None:
+        """Set the active DHIS2 profile + optional debug logging + output mode for this invocation."""
+        if profile:
+            os.environ["DHIS2_PROFILE"] = profile
+        if debug:
+            _enable_debug_logging()
+        # Always set, not just when True — `CliRunner` reuses the same
+        # process across `invoke` calls, so a stale `True` from a previous
+        # invocation must not leak into the next one.
+        JSON_OUTPUT.set(json_)
+
+    for plugin in discover_plugins():
+        plugin.register_cli(app)
+    return app
+
+
+app = build_app()
+
+
+def main() -> None:
+    """Console-script entrypoint — wraps the Typer app with clean error rendering."""
+    run_app(app)
+
+
+if __name__ == "__main__":
+    main()