dhis2w-cli 0.5.2__py3-none-any.whl

dhis2w_cli/__init__.py

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

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()

dhis2w_cli-0.5.2.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,7 @@
+dhis2w_cli/__init__.py,sha256=4xN3K6yiHOJeA7Aj-NXOEUEtu-YxGlLGjqzRAFKn0zg,49
+dhis2w_cli/main.py,sha256=kqNmOVJohf0Ny8NVRKJ4p7wKERwED-9I2RXnz36IJ-I,3293
+dhis2w_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dhis2w_cli-0.5.2.dist-info/WHEEL,sha256=iCTolw4aw2dP3yfM-EQCGTDsFCXL_ymmbYnBRVH7plA,81
+dhis2w_cli-0.5.2.dist-info/entry_points.txt,sha256=OthGyrDED7-XfwCJVrlMlmvruO1kaqLLJGAF91Lfi6g,48
+dhis2w_cli-0.5.2.dist-info/METADATA,sha256=f9zgk6llv2Ols13AJVyGczyC7BSae3BSAkkd7Nl7pCI,450
+dhis2w_cli-0.5.2.dist-info/RECORD,,

dhis2w_cli-0.5.2.dist-info/WHEEL

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

dhis2w_cli-0.5.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dhis2 = dhis2w_cli.main:main
+