seizu-cli 2.0.0__py3-none-any.whl

seizu_cli/main.py

@@ -0,0 +1,181 @@
+"""Seizu CLI entry point."""
+
+from pathlib import Path
+
+import typer
+
+from seizu_cli import auth, state
+from seizu_cli import config as cli_config
+from seizu_cli.commands import auth as auth_commands
+from seizu_cli.commands import reports, scheduled_queries, seed, skillsets, toolsets
+
+app = typer.Typer(
+    help="Seizu CLI — manage reports, scheduled queries, and toolsets via the Seizu API.",
+    no_args_is_help=True,
+)
+app.add_typer(reports.app, name="reports")
+app.add_typer(scheduled_queries.app, name="scheduled-queries")
+app.add_typer(toolsets.app, name="toolsets")
+app.add_typer(skillsets.app, name="skillsets")
+app.add_typer(auth_commands.app, name="auth")
+
+
+@app.callback()
+def main(
+    api_url: str | None = typer.Option(
+        None,
+        envvar="SEIZU_API_URL",
+        help=("Seizu API base URL. Overrides the 'api_url' setting in ~/.config/seizu/seizu.conf."),
+    ),
+    token: str | None = typer.Option(
+        None,
+        envvar="SEIZU_TOKEN",
+        help=("Bearer token for API authentication. If omitted, a stored token from 'seizu login' is used."),
+    ),
+    credentials_file: Path | None = typer.Option(
+        None,
+        envvar="SEIZU_CREDENTIALS_FILE",
+        help=("Path to a JSON credentials file. Forces file-based token storage even if an OS keyring is available."),
+    ),
+    config_file: Path | None = typer.Option(
+        None,
+        "--config-file",
+        envvar="SEIZU_CONFIG_FILE",
+        help=("Path to the CLI config file. Defaults to ~/.config/seizu/seizu.conf."),
+    ),
+) -> None:
+    """Seizu CLI — manage reports, scheduled queries, and toolsets via the Seizu API.
+
+    Configuration is read from ~/.config/seizu/seizu.conf (YAML).
+    CLI flags and environment variables take precedence over config-file values.
+
+    \b
+    Example ~/.config/seizu/seizu.conf:
+        api_url: https://seizu.example.com
+        seed_file: ~/dashboards/reporting.yaml
+
+    Authentication is handled via the Device Authorization Grant flow.
+    Run 'seizu login' once; credentials are stored in the OS-native keyring
+    and loaded automatically on every subsequent command.
+
+    \b
+    Quick start:
+        seizu login                    # authenticate (opens browser URL)
+        seizu reports list             # list reports
+        seizu reports clone <id> <name> # clone a report
+        seizu scheduled-queries list   # list scheduled queries
+        seizu toolsets list            # list toolsets
+        seizu toolsets tools list <toolset_id>
+        seizu toolsets tools call <toolset_id> <tool_id> --arg limit=10
+
+    \b
+    To use a different deployment:
+        seizu --api-url https://seizu.example.com login
+        seizu --api-url https://seizu.example.com reports list
+
+    \b
+    To generate client libraries in other languages from the OpenAPI spec:
+        make generate_openapi           # exports schema/openapi.json
+        make generate_client LANG=go    # generates a Go client
+        make generate_client LANG=typescript-fetch
+        make generate_client LANG=java
+
+    See https://openapi-generator.tech/docs/generators for all supported languages.
+    """
+    cfg = cli_config.load_config(config_file)
+
+    # Resolution order: CLI flag → env var → config file → built-in default
+    resolved_api_url = api_url or cfg.api_url or "http://localhost:8080"
+
+    state.api_url = resolved_api_url
+    state.credentials_file = credentials_file
+    state.seed_file = cfg.seed_file
+
+    if token:
+        # Explicit --token / SEIZU_TOKEN takes precedence over stored credentials.
+        state.token = token
+    else:
+        # Fall back to stored credentials for this API URL.
+        state.token = auth.load_token(resolved_api_url, credentials_file)
+
+    state.reset_client()
+
+
+@app.command("login")
+def login_cmd() -> None:
+    """Authenticate via the Device Authorization Grant (RFC 8628).
+
+    Fetches the OIDC configuration from the API, then starts a Device
+    Authorization flow.  A URL and short code are displayed; open the URL
+    in your browser, enter the code, and the CLI will receive an access
+    token automatically.
+
+    The token is stored in the OS-native keyring and loaded automatically on
+    subsequent commands. Pass --credentials-file PATH to store in a plain JSON
+    file instead.
+
+    \b
+    Example:
+        seizu login
+        seizu --api-url https://seizu.example.com login
+        seizu --credentials-file ~/seizu-creds.json login
+    """
+    auth_commands.login()
+
+
+@app.command("logout")
+def logout_cmd() -> None:
+    """Remove stored credentials for the current API URL."""
+    auth_commands.logout()
+
+
+@app.command("whoami")
+def whoami_cmd() -> None:
+    """Show the currently authenticated user."""
+    auth_commands.whoami()
+
+
+@app.command("seed")
+def seed_cmd(
+    config: str | None = typer.Option(
+        None,
+        envvar="REPORTING_CONFIG_FILE",
+        help=(
+            "Path to the YAML dashboard config file. "
+            "Defaults to 'seed_file' in ~/.config/seizu/seizu.conf, "
+            "then ~/.config/seizu/reporting-dashboard.yaml."
+        ),
+    ),
+    force: bool = typer.Option(
+        False,
+        help="Update existing records even if their content is unchanged.",
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        help="Preview what would be created or updated without writing anything.",
+    ),
+) -> None:
+    """Seed reports and scheduled queries from a YAML config file via the API."""
+    resolved_config = config or state.seed_file or cli_config.default_seed_file()
+    seed.seed_cmd(config=resolved_config, force=force, dry_run=dry_run)
+
+
+@app.command("export")
+def export_cmd(
+    config: str | None = typer.Option(
+        None,
+        envvar="REPORTING_CONFIG_FILE",
+        help=(
+            "Path to the YAML dashboard config file. "
+            "Defaults to 'seed_file' in ~/.config/seizu/seizu.conf, "
+            "then ~/.config/seizu/reporting-dashboard.yaml."
+        ),
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        help="Print the resulting YAML without overwriting the config file.",
+    ),
+) -> None:
+    """Export the latest version of every report from the API back into a YAML config file."""
+    resolved_config = config or state.seed_file or cli_config.default_seed_file()
+    seed.export_cmd(config=resolved_config, dry_run=dry_run)

seizu_cli/schema.py

@@ -0,0 +1,31 @@
+"""Re-exports from ``seizu_schema.reporting_config``.
+
+The authoritative model definitions live in the shared ``seizu_schema``
+package.  This module re-exports everything so that existing imports within
+``seizu_cli`` continue to work unchanged.
+"""
+
+from seizu_schema.reporting_config import (
+    BarPanelSettings,  # noqa: F401
+    GraphPanelSettings,  # noqa: F401
+    Input,  # noqa: F401
+    InputDefault,  # noqa: F401
+    Panel,  # noqa: F401
+    PanelParam,  # noqa: F401
+    PiePanelSettings,  # noqa: F401
+    Report,  # noqa: F401
+    ReportingConfig,  # noqa: F401
+    Row,  # noqa: F401
+    ScheduledQuery,  # noqa: F401
+    ScheduledQueryAction,  # noqa: F401
+    ScheduledQueryParam,  # noqa: F401
+    ScheduledQueryWatchScan,  # noqa: F401
+    SkillDef,  # noqa: F401
+    SkillsetDef,  # noqa: F401
+    ToolDef,  # noqa: F401
+    ToolParamDef,  # noqa: F401
+    ToolsetDef,  # noqa: F401
+    dump_yaml,  # noqa: F401
+    load_file,  # noqa: F401
+    output_json_schema,  # noqa: F401
+)

seizu_cli/state.py

@@ -0,0 +1,29 @@
+"""Global CLI state shared between the callback and command handlers."""
+
+from pathlib import Path
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from seizu_cli.client import SeizuClient
+
+api_url: str = "http://localhost:8080"
+token: str | None = None
+credentials_file: Path | None = None
+seed_file: str | None = None
+_client: Optional["SeizuClient"] = None
+
+
+def get_client() -> "SeizuClient":
+    """Return the shared API client, creating it lazily on first call."""
+    from seizu_cli.client import SeizuClient
+
+    global _client
+    if _client is None:
+        _client = SeizuClient(api_url, token)
+    return _client
+
+
+def reset_client() -> None:
+    """Drop the cached client so the next call to get_client() creates a fresh one."""
+    global _client
+    _client = None

seizu_cli-2.0.0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: seizu-cli
+Version: 2.0.0
+Summary: Command-line interface for the Seizu reporting platform
+License-Expression: Apache-2.0
+Requires-Python: >=3.12
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: pydantic>=2.13.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.33.0
+Requires-Dist: rich>=15.0.0
+Requires-Dist: shellingham>=1.5.0
+Requires-Dist: typer>=0.25.0

seizu_cli-2.0.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+seizu_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+seizu_cli/__main__.py,sha256=T9XdZWrZhGHwRh9xNJoSXve3_AniZiLC2NjHPLf6too,69
+seizu_cli/auth.py,sha256=6cHrMQWQCOJQpF5Onnrilde4surP2wCthzaChiJrV4A,12829
+seizu_cli/client.py,sha256=93hElrHvhECsPbvptlwwLLwdoyqMxuD85bPws7-f77Y,2169
+seizu_cli/config.py,sha256=YpAhQkfV2OvrFIV43PUtgsfooC_CTnVR6p8snltvjhY,1143
+seizu_cli/main.py,sha256=EgEuQbb1K0bPET_8iWX_krRfFVk54bBTJnmaqP4ysXc,6344
+seizu_cli/schema.py,sha256=T2gdaBQSo_Cyb6rzEWhVE-UfbgDfaNIZcHBAs4DE8Bw,1002
+seizu_cli/state.py,sha256=E3RFfiYVxpOLCfmS6DMZWVHhhoz_JyeRKg2nws16PXo,797
+seizu_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+seizu_cli/commands/auth.py,sha256=7mm2QjRU94UTcMXC-Ek_p_39DZ2tKCSWTeAyvOAOGmk,2506
+seizu_cli/commands/reports.py,sha256=3e_vq3ue9Va28peiyhTjn9PPMAsty8-GaxaA_q5Tr-g,6864
+seizu_cli/commands/scheduled_queries.py,sha256=Mf4w8WGX2njHoFAnl4OzlOA6MzpYYp42YRJtQqonBjQ,4974
+seizu_cli/commands/seed.py,sha256=UdIQqnJS-Leg8l1yHFzWLw3c76TxisWhSSyIXpB2lN8,31875
+seizu_cli/commands/skillsets.py,sha256=Wm3rb8xG46pSmj98TfqrkJd2uw6tcSli_-h4yACrSxc,13878
+seizu_cli/commands/toolsets.py,sha256=J229Ql5zfoYQC3ZSAlOrFnONJa4Ks-VjM3tFTtL9-UE,17052
+seizu_schema/__init__.py,sha256=fcClhxPFoodNdqaJA7tR9YwPuxYz-EKEWntmFnmizek,90
+seizu_schema/reporting_config.py,sha256=ZEggz6LZUtbW3EwUOylBj9JAvUF_enfvLD03YyEp9OY,26828
+seizu_cli-2.0.0.dist-info/METADATA,sha256=bQSaeCF83LGgTNiFyrOujTlnTP9gHsrLKVdlw-0Y7GU,388
+seizu_cli-2.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+seizu_cli-2.0.0.dist-info/entry_points.txt,sha256=gcy52hJBVowGqvk2E5LPlba2DWhNQRpBb94jZdcHs6s,45
+seizu_cli-2.0.0.dist-info/top_level.txt,sha256=gopt93v86vi8YhhlRs3kAYGksSBpIOX7eYplQWvTMbk,23
+seizu_cli-2.0.0.dist-info/RECORD,,

seizu_cli-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

seizu_cli-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+seizu = seizu_cli.main:app

seizu_cli-2.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+seizu_cli
+seizu_schema

seizu_schema/__init__.py

@@ -0,0 +1 @@
+"""seizu_schema — shared Pydantic models for the Seizu reporting YAML config format."""