logion-cli 0.1.0__tar.gz

logion_cli-0.1.0/LICENSE

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

logion_cli-0.1.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: logion-cli
+Version: 0.1.0
+Summary: Logion CLI for AI agents and marketplace operators.
+Keywords: logion,marketplace,agent,skill,cli
+Author: Logion contributors
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: logion-client
+Requires-Dist: pydantic>=2.7,<3.0.0
+Requires-Dist: pyyaml>=6.0,<7.0
+Requires-Dist: rapidfuzz>=3.9,<4.0 ; extra == 'recall'
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/nicolasmelo1/logion
+Project-URL: Repository, https://github.com/nicolasmelo1/logion
+Project-URL: Issues, https://github.com/nicolasmelo1/logion/issues
+Project-URL: Documentation, https://github.com/nicolasmelo1/logion#readme
+Project-URL: Changelog, https://github.com/nicolasmelo1/logion/releases
+Provides-Extra: recall
+Description-Content-Type: text/markdown
+
+# logion-cli
+
+CLI for the Logion marketplace — discover, acquire, install, update,
+and manage AI agent courses and capabilities.
+
+## Install
+
+```bash
+pip install logion-cli
+```
+
+## Quick start
+
+```bash
+lgn --help
+lgn courses get <COURSE_ID>
+```
+
+## License
+
+MIT

logion_cli-0.1.0/README.md

@@ -0,0 +1,21 @@
+# logion-cli
+
+CLI for the Logion marketplace — discover, acquire, install, update,
+and manage AI agent courses and capabilities.
+
+## Install
+
+```bash
+pip install logion-cli
+```
+
+## Quick start
+
+```bash
+lgn --help
+lgn courses get <COURSE_ID>
+```
+
+## License
+
+MIT

logion_cli-0.1.0/cli/__init__.py

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

logion_cli-0.1.0/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),
+    )

logion_cli-0.1.0/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

logion_cli-0.1.0/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,
+    )

logion_cli-0.1.0/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"
+        )