inspire-skill 2.0.0__tar.gz

inspire_skill-2.0.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: inspire-skill
+Version: 2.0.0
+Summary: CLI for the Inspire training platform: notebook lifecycle, distributed/HPC job submission, SSH tunneling, image and resource ops
+Author: Inspire Platform Team
+License-Expression: MIT
+Project-URL: Documentation, https://github.com/realZillionX/InspireSkill
+Project-URL: Repository, https://github.com/realZillionX/InspireSkill
+Keywords: inspire,hpc,training,cli,machine-learning
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: requests>=2.28.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: playwright>=1.57.0
+Requires-Dist: matplotlib>=3.8.0
+Requires-Dist: tomli>=1.2.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.0.280; extra == "dev"

inspire_skill-2.0.0/inspire/__init__.py

@@ -0,0 +1,3 @@
+"""Inspire Training Platform SDK."""
+
+__version__ = "2.0.0"

inspire_skill-2.0.0/inspire/accounts/__init__.py

@@ -0,0 +1,44 @@
+"""Account storage — one account = one isolated directory on disk.
+
+See :mod:`inspire.accounts.storage` for the rationale and layout. This
+package re-exports the storage helpers so callers can do
+``from inspire.accounts import current_account, account_config_path``.
+"""
+
+from inspire.accounts.storage import (
+    CONFIG_FILENAME,
+    AccountError,
+    account_config_path,
+    account_dir,
+    account_exists,
+    accounts_dir,
+    clear_current_account,
+    create_account,
+    current_account,
+    current_file,
+    ensure_inspire_home,
+    inspire_home,
+    list_accounts,
+    remove_account,
+    set_current_account,
+    validate_name,
+)
+
+__all__ = [
+    "CONFIG_FILENAME",
+    "AccountError",
+    "account_config_path",
+    "account_dir",
+    "account_exists",
+    "accounts_dir",
+    "clear_current_account",
+    "create_account",
+    "current_account",
+    "current_file",
+    "ensure_inspire_home",
+    "inspire_home",
+    "list_accounts",
+    "remove_account",
+    "set_current_account",
+    "validate_name",
+]

inspire_skill-2.0.0/inspire/accounts/storage.py

@@ -0,0 +1,141 @@
+"""File-based account storage.
+
+One account = one isolated directory under ``~/.inspire/accounts/<name>/``.
+The active account is named in a single line at ``~/.inspire/current``. No
+layered merge, no ``[accounts."<name>"]`` sections, no env-var precedence
+chains — every account's state (config.toml, bridges.json, web_session.json,
+rtunnel cache) lives inside its own directory and never leaks into another.
+
+All callers must resolve per-account paths through helpers here rather than
+hard-coding ``~/.inspire/accounts/<name>/...`` strings, so there is only one
+place to change when the on-disk layout evolves.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+from pathlib import Path
+
+CONFIG_FILENAME = "config.toml"
+
+
+def _atomic_write_text(target: Path, content: str) -> None:
+    """Write *content* to *target* atomically (temp file + ``os.replace``).
+
+    Matches the pattern already used by
+    ``inspire.platform.web.session.models.WebSession.save`` — keep partial
+    writes out of the target path so concurrent ``account use`` or a crash
+    mid-write never leaves a half-written ``current`` / ``config.toml``.
+    """
+    target.parent.mkdir(parents=True, exist_ok=True)
+    tmp = target.with_name(target.name + ".tmp")
+    with open(tmp, "w", encoding="utf-8") as f:
+        f.write(content)
+        f.flush()
+        os.fsync(f.fileno())
+    os.replace(tmp, target)
+
+_NAME_PATTERN = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$")
+
+
+class AccountError(Exception):
+    """Raised for account-related failures (not found, already exists, bad name)."""
+
+
+def validate_name(name: str) -> str:
+    candidate = (name or "").strip()
+    if not _NAME_PATTERN.match(candidate):
+        raise AccountError(
+            f"Invalid account name: {name!r}. Allowed: letters, digits, '.', '_', '-'; "
+            "must start with a letter or digit; 1-64 chars."
+        )
+    return candidate
+
+
+def inspire_home() -> Path:
+    return Path.home() / ".inspire"
+
+
+def accounts_dir() -> Path:
+    return inspire_home() / "accounts"
+
+
+def current_file() -> Path:
+    return inspire_home() / "current"
+
+
+def account_dir(name: str) -> Path:
+    return accounts_dir() / validate_name(name)
+
+
+def account_config_path(name: str) -> Path:
+    return account_dir(name) / CONFIG_FILENAME
+
+
+def ensure_inspire_home() -> None:
+    inspire_home().mkdir(parents=True, exist_ok=True)
+    accounts_dir().mkdir(parents=True, exist_ok=True)
+
+
+def list_accounts() -> list[str]:
+    root = accounts_dir()
+    if not root.exists():
+        return []
+    return sorted(
+        p.name
+        for p in root.iterdir()
+        if p.is_dir() and (p / CONFIG_FILENAME).exists()
+    )
+
+
+def account_exists(name: str) -> bool:
+    try:
+        return validate_name(name) in list_accounts()
+    except AccountError:
+        return False
+
+
+def current_account() -> str | None:
+    try:
+        raw = current_file().read_text(encoding="utf-8").strip()
+    except FileNotFoundError:
+        return None
+    return raw or None
+
+
+def set_current_account(name: str) -> None:
+    validated = validate_name(name)
+    if not account_exists(validated):
+        raise AccountError(f"Account not found: {validated}")
+    ensure_inspire_home()
+    _atomic_write_text(current_file(), validated + "\n")
+
+
+def clear_current_account() -> None:
+    try:
+        current_file().unlink()
+    except FileNotFoundError:
+        pass
+
+
+def create_account(name: str, config_content: str, *, overwrite: bool = False) -> Path:
+    validated = validate_name(name)
+    target = accounts_dir() / validated
+    if target.exists() and not overwrite:
+        raise AccountError(f"Account already exists: {validated}")
+    ensure_inspire_home()
+    target.mkdir(parents=True, exist_ok=overwrite)
+    _atomic_write_text(target / CONFIG_FILENAME, config_content)
+    return target
+
+
+def remove_account(name: str) -> None:
+    validated = validate_name(name)
+    target = accounts_dir() / validated
+    if not target.exists():
+        raise AccountError(f"Account not found: {validated}")
+    shutil.rmtree(target)
+    if current_account() == validated:
+        clear_current_account()

inspire_skill-2.0.0/inspire/bridge/__init__.py

@@ -0,0 +1 @@
+"""Bridge execution integrations (forge workflows, tunnels, SSH)."""