logion-cli 0.1.0__py3-none-any.whl

cli/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: MIT
+"""Logion CLI package."""

cli/_config.py

@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: MIT
+"""CLI configuration — env-var resolution and defaults."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+
+DEFAULT_BASE_URL = "https://api.logion.sh"
+
+
+@dataclass(frozen=True)
+class CliConfig:
+    """Resolved CLI configuration."""
+
+    api_key: str | None
+    base_url: str
+    json_output: bool
+    timeout: float | None
+    max_retries: int | None
+
+
+def is_truthy(value: str | None) -> bool:
+    """Return True if *value* looks like a truthy env-var string."""
+    return value is not None and value.lower() in {"1", "true", "yes", "on"}
+
+
+def is_admin_enabled() -> bool:
+    """Return True if ``LOGION_ENABLE_ADMIN`` is set to a truthy value."""
+    return is_truthy(os.getenv("LOGION_ENABLE_ADMIN"))
+
+
+def resolve_config_from_args(
+    args: object,
+) -> CliConfig:
+    """Build a CliConfig from parsed argparse args + env vars."""
+    api_key: str | None = getattr(args, "api_key", None)
+    if api_key is None:
+        api_key = os.getenv("LOGION_API_KEY")
+
+    base_url: str | None = getattr(args, "base_url", None)
+    if base_url is None:
+        base_url = os.getenv("LOGION_BASE_URL", DEFAULT_BASE_URL)
+
+    return CliConfig(
+        api_key=api_key,
+        base_url=base_url,
+        json_output=getattr(args, "json_output", False),
+        timeout=getattr(args, "timeout", None),
+        max_retries=getattr(args, "max_retries", None),
+    )

cli/_confirm.py

@@ -0,0 +1,16 @@
+# SPDX-License-Identifier: MIT
+"""Confirmation helper — require --yes for destructive actions."""
+
+from __future__ import annotations
+
+from cli._errors import print_err
+
+
+def require_yes(yes: bool, action: str) -> int | None:
+    """Return ``None`` if *yes* is True, otherwise print a refusal and
+    return exit code 2.
+    """
+    if yes:
+        return None
+    print_err(f"This is a destructive action. Re-run with --yes to {action}.")
+    return 2

cli/_context.py

@@ -0,0 +1,17 @@
+# SPDX-License-Identifier: MIT
+"""CLI context — builds a LogionClient from CliConfig."""
+
+from __future__ import annotations
+
+from cli._config import CliConfig
+from logion import LogionClient
+
+
+def make_client(config: CliConfig) -> LogionClient:
+    """Create a LogionClient from resolved CLI configuration."""
+    return LogionClient(
+        api_key=config.api_key,
+        base_url=config.base_url,
+        timeout=config.timeout,
+        max_retries=config.max_retries,
+    )

cli/_course_bundle.py

@@ -0,0 +1,46 @@
+# SPDX-License-Identifier: MIT
+"""Validation helpers for publishable course bundles."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+REQUIRED_BUNDLE_FILES = ("SKILL.md", "LICENSE", "course/capabilities.yaml")
+LOGION_STANDARD_COURSE_LICENSE_NAME = "Logion Standard Course License v1.0"
+
+
+class CourseBundleError(ValueError):
+    """Raised when a bundle is missing publish-time metadata."""
+
+
+def read_bundle_license_text(bundle_dir: Path) -> str:
+    """Return the stripped bundle LICENSE text."""
+    return (bundle_dir / "LICENSE").read_text(encoding="utf-8").strip()
+
+
+def is_logion_standard_course_license(license_text: str) -> bool:
+    """Return whether *license_text* is the Logion paid-course license."""
+    return LOGION_STANDARD_COURSE_LICENSE_NAME in license_text
+
+
+def validate_course_bundle(bundle_dir: Path, *, paid: bool = False) -> None:
+    """Require the bundle files Logion needs before publication/install."""
+    missing = [
+        name
+        for name in REQUIRED_BUNDLE_FILES
+        if not (bundle_dir / name).is_file()
+    ]
+    if missing:
+        missing_csv = ", ".join(missing)
+        raise CourseBundleError(
+            "bundle is missing required file(s): "
+            f"{missing_csv}. "
+            "Every publishable course bundle must ship its own LICENSE file."
+        )
+    license_text = read_bundle_license_text(bundle_dir)
+    if not license_text:
+        raise CourseBundleError("LICENSE exists but is empty")
+    if paid and not is_logion_standard_course_license(license_text):
+        raise CourseBundleError(
+            "paid courses must ship the Logion Standard Course License v1.0"
+        )