socaity-cli 0.1.1__tar.gz

socaity_cli-0.1.1/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: socaity-cli
+Version: 0.1.1
+Summary: Socaity platform CLI: login, catalog browsing, SDK installs and APIPod deployment commands.
+Author: SocAIty
+License: MIT
+Project-URL: Repository, https://github.com/SocAIty/socaity-cli
+Project-URL: Homepage, https://www.socaity.ai
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Requires-Dist: socaity-schemas>=0.0.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+
+# socaity-cli
+
+The command line for the [socaity.ai](https://www.socaity.ai) platform: login, catalog browsing,
+SDK installs, and APIPod deployment tooling. One `socaity` command, shared by the
+[socaity SDK](https://github.com/SocAIty/socaity) and [APIPod](https://github.com/SocAIty/apipod).
+
+The package is deliberately small: `httpx` and `socaity-schemas` are the only dependencies.
+Commands that need more (stub generation, container builds) delegate to the `socaity` or
+`apipod` package and tell you what to install when it is missing.
+
+## Install
+
+```bash
+pip install socaity-cli
+```
+
+You get `socaity-cli` as part of `pip install socaity` or `pip install apipod` as well.
+
+## Commands
+
+| Command | Needs | What it does |
+|---------|-------|--------------|
+| `socaity login` / `logout` / `whoami` | - | Browser login, credentials in `~/.config/socaity/` |
+| `socaity list services\|models` | - | Browse the AI catalog |
+| `socaity search "flux schnel"` | - | Typo-tolerant search (`--collections services,models,jobs`) |
+| `socaity jobs [job_id]` | login | List/search jobs; `--q`, `--expand data,files,billing,social`, `--visibility` |
+| `socaity projects [project_id]` | login | Your projects; `--expand jobs` embeds member jobs |
+| `socaity install <service>` | `socaity` | Generate an SDK stub for a service |
+| `socaity update` | `socaity` | Sync installed services with the platform |
+| `socaity scan` | `apipod` | Scan a project and generate `apipod.json` |
+| `socaity build [file]` | `apipod` | Build the deployment container |
+| `socaity start [entrypoint]` | `apipod` | Run an APIPod service locally |
+| `socaity deploy [target]` | `apipod` | Deploy to Socaity (wraps `apipod deploy`) |
+
+Use `-C DIR` with scan/build/start/deploy to point at a service project directory
+(e.g. `socaity -C simple_test_service deploy serverless-runpod --yes`).
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---------|---------|---------|
+| `SOCAITY_API_KEY` | from login | API key (wins over stored credentials) |
+| `SOCAITY_BACKEND_URL` | `https://webapi.socaity.ai` | Platform API |
+| `SOCAITY_FRONTEND_URL` | `https://socaity.ai` | Web UI for browser login |
+
+## Using it as a library
+
+`socaity` and `apipod` build on the same primitives this package exposes:
+
+```python
+from socaity_cli import SocaityBackendClient, get_api_key, requires
+```
+
+`SocaityBackendClient` covers catalog reads, search, and SDK install/update calls.
+`requires("apipod")` guards a function behind an optional package with a friendly
+install hint instead of an ImportError traceback.

socaity_cli-0.1.1/README.md

@@ -0,0 +1,56 @@
+# socaity-cli
+
+The command line for the [socaity.ai](https://www.socaity.ai) platform: login, catalog browsing,
+SDK installs, and APIPod deployment tooling. One `socaity` command, shared by the
+[socaity SDK](https://github.com/SocAIty/socaity) and [APIPod](https://github.com/SocAIty/apipod).
+
+The package is deliberately small: `httpx` and `socaity-schemas` are the only dependencies.
+Commands that need more (stub generation, container builds) delegate to the `socaity` or
+`apipod` package and tell you what to install when it is missing.
+
+## Install
+
+```bash
+pip install socaity-cli
+```
+
+You get `socaity-cli` as part of `pip install socaity` or `pip install apipod` as well.
+
+## Commands
+
+| Command | Needs | What it does |
+|---------|-------|--------------|
+| `socaity login` / `logout` / `whoami` | - | Browser login, credentials in `~/.config/socaity/` |
+| `socaity list services\|models` | - | Browse the AI catalog |
+| `socaity search "flux schnel"` | - | Typo-tolerant search (`--collections services,models,jobs`) |
+| `socaity jobs [job_id]` | login | List/search jobs; `--q`, `--expand data,files,billing,social`, `--visibility` |
+| `socaity projects [project_id]` | login | Your projects; `--expand jobs` embeds member jobs |
+| `socaity install <service>` | `socaity` | Generate an SDK stub for a service |
+| `socaity update` | `socaity` | Sync installed services with the platform |
+| `socaity scan` | `apipod` | Scan a project and generate `apipod.json` |
+| `socaity build [file]` | `apipod` | Build the deployment container |
+| `socaity start [entrypoint]` | `apipod` | Run an APIPod service locally |
+| `socaity deploy [target]` | `apipod` | Deploy to Socaity (wraps `apipod deploy`) |
+
+Use `-C DIR` with scan/build/start/deploy to point at a service project directory
+(e.g. `socaity -C simple_test_service deploy serverless-runpod --yes`).
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---------|---------|---------|
+| `SOCAITY_API_KEY` | from login | API key (wins over stored credentials) |
+| `SOCAITY_BACKEND_URL` | `https://webapi.socaity.ai` | Platform API |
+| `SOCAITY_FRONTEND_URL` | `https://socaity.ai` | Web UI for browser login |
+
+## Using it as a library
+
+`socaity` and `apipod` build on the same primitives this package exposes:
+
+```python
+from socaity_cli import SocaityBackendClient, get_api_key, requires
+```
+
+`SocaityBackendClient` covers catalog reads, search, and SDK install/update calls.
+`requires("apipod")` guards a function behind an optional package with a friendly
+install hint instead of an ImportError traceback.

socaity_cli-0.1.1/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "socaity-cli"
+version = "0.1.1"
+description = "Socaity platform CLI: login, catalog browsing, SDK installs and APIPod deployment commands."
+requires-python = ">=3.8"
+authors = [
+    { name = "SocAIty" }
+]
+license = { text = "MIT" }
+readme = "README.md"
+dependencies = [
+    "httpx",
+    "socaity-schemas>=0.0.1",
+]
+
+[project.scripts]
+socaity = "socaity_cli.cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "ruff",
+    "mypy",
+]
+
+[project.urls]
+Repository = "https://github.com/SocAIty/socaity-cli"
+Homepage = "https://www.socaity.ai"
+
+[tool.setuptools.packages.find]
+include = ["socaity_cli*"]
+
+[tool.pytest.ini_options]
+testpaths = ["test"]
+# Resolve in-repo package and sibling schemas in local dev (CI installs from pip).
+pythonpath = [".", "../socaity-schemas"]
+
+[tool.ruff]
+line-length = 120
+exclude = ["venv", "dist", "build", "*.egg-info"]
+
+[tool.ruff.lint]
+ignore = ["E203", "E261", "E501", "W293", "W291"]
+
+[tool.mypy]
+ignore_missing_imports = true
+follow_imports = "silent"
+warn_unused_ignores = false

socaity_cli-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

socaity_cli-0.1.1/socaity_cli/__init__.py

@@ -0,0 +1,30 @@
+"""Socaity platform CLI.
+
+Lightweight bundle of all Socaity CLI commands and the backend HTTP client
+(httpx + socaity-schemas only). Heavy features delegate to the optional
+``socaity`` (SDK installs) and ``apipod`` (deployment tooling) packages via
+the ``requires`` decorator.
+"""
+from socaity_cli.backend_client import SocaityBackendClient
+from socaity_cli.credentials import (
+    Credentials,
+    clear_credentials,
+    get_api_key,
+    load_credentials,
+    require_credentials,
+    save_credentials,
+)
+from socaity_cli.requires import requires
+from socaity_cli.prompts import input_yes_no
+
+__all__ = [
+    "SocaityBackendClient",
+    "Credentials",
+    "clear_credentials",
+    "get_api_key",
+    "load_credentials",
+    "require_credentials",
+    "save_credentials",
+    "requires",
+    "input_yes_no",
+]

socaity_cli-0.1.1/socaity_cli/__main__.py

@@ -0,0 +1,4 @@
+from socaity_cli.cli import main
+
+if __name__ == "__main__":
+    main()

socaity_cli-0.1.1/socaity_cli/apipod_commands.py

@@ -0,0 +1,82 @@
+"""Bridge to the APIPod CLI (requires ``pip install apipod``).
+
+Imports stay inside the functions: ``apipod`` is optional for the CLI and the
+``requires`` decorator guards each entry with a friendly install hint.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import List, Optional
+
+from socaity_cli.requires import requires
+
+
+def _with_project_dir(argv: List[str], project_dir: Optional[str]) -> List[str]:
+    if project_dir:
+        return ["-C", project_dir, *argv]
+    return argv
+
+
+@requires("apipod")
+def _run_apipod_argv(argv: List[str]) -> None:
+    import apipod.cli
+
+    previous = sys.argv
+    sys.argv = ["apipod", *argv]
+    try:
+        apipod.cli.main()
+    finally:
+        sys.argv = previous
+
+
+def run_scan(*, project_dir: Optional[str] = None) -> None:
+    _run_apipod_argv(_with_project_dir(["scan"], project_dir))
+
+
+def run_build(target_file: Optional[str], *, project_dir: Optional[str] = None) -> None:
+    argv = ["build"]
+    if target_file:
+        argv.append(target_file)
+    _run_apipod_argv(_with_project_dir(argv, project_dir))
+
+
+def run_start(
+    *,
+    entrypoint: Optional[str],
+    host: Optional[str],
+    port: Optional[int],
+    project_dir: Optional[str] = None,
+) -> None:
+    argv = ["start"]
+    if entrypoint:
+        argv.append(entrypoint)
+    if host:
+        argv.extend(["--host", host])
+    if port is not None:
+        argv.extend(["--port", str(port)])
+    _run_apipod_argv(_with_project_dir(argv, project_dir))
+
+
+def run_deploy(
+    *,
+    target: Optional[str] = None,
+    project_dir: Optional[str] = None,
+    resume: Optional[str] = None,
+    skip_build: bool = False,
+    push_only: bool = False,
+    yes: bool = False,
+) -> None:
+    """Wrap ``apipod deploy`` (analyze, build, push, provision)."""
+    argv = ["deploy"]
+    if target:
+        argv.append(target)
+    if resume:
+        argv.extend(["--resume", resume])
+    if skip_build:
+        argv.append("--skip-build")
+    if push_only:
+        argv.append("--push-only")
+    if yes:
+        argv.append("--yes")
+    _run_apipod_argv(_with_project_dir(argv, project_dir))

socaity_cli-0.1.1/socaity_cli/auth.py

@@ -0,0 +1,197 @@
+"""Browser-based CLI login (device authorization flow via web UI)."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import time
+import webbrowser
+from typing import Any, Dict, Optional
+from urllib.parse import urljoin
+
+import httpx
+
+from socaity_cli.credentials import (
+    Credentials,
+    DEFAULT_BACKEND_URL,
+    DEFAULT_FRONTEND_URL,
+    require_credentials,
+    save_credentials,
+)
+
+USER_AGENT = "socaity-cli/0.1.0"
+
+
+def _backend_base_url() -> str:
+    return os.environ.get("SOCAITY_BACKEND_URL", DEFAULT_BACKEND_URL).rstrip("/")
+
+
+def _frontend_base_url(frontend_url: Optional[str] = None) -> str:
+    if frontend_url is not None:
+        value = frontend_url.strip()
+        return value.rstrip("/") if value else DEFAULT_FRONTEND_URL
+    return os.environ.get("SOCAITY_FRONTEND_URL", DEFAULT_FRONTEND_URL).rstrip("/")
+
+
+def _web_api_url(base: str) -> str:
+    return urljoin(base + "/", "v1/")
+
+
+def open_login_url(url: str) -> bool:
+    try:
+        if webbrowser.open(url):
+            return True
+    except Exception:
+        pass
+    for cmd in ("wslview", "xdg-open"):
+        exe = shutil.which(cmd)
+        if not exe:
+            continue
+        try:
+            subprocess.run(
+                [exe, url],
+                check=False,
+                timeout=8,
+                stdout=subprocess.DEVNULL,
+                stderr=subprocess.DEVNULL,
+            )
+            return True
+        except Exception:
+            continue
+    return False
+
+
+def start_cli_login(
+    *,
+    backend_url: Optional[str] = None,
+    frontend_url: Optional[str] = None,
+    expires_in_seconds: int = 600,
+) -> Dict[str, Any]:
+    base = (backend_url or _backend_base_url()).rstrip("/")
+    payload: Dict[str, Any] = {"expires_in_seconds": expires_in_seconds}
+    payload["frontend_base_url"] = _frontend_base_url(frontend_url)
+    with httpx.Client(timeout=20.0) as client:
+        response = client.post(
+            _web_api_url(base) + "cli-auth/start",
+            json=payload,
+            headers={"User-Agent": USER_AGENT},
+        )
+        response.raise_for_status()
+        return response.json()
+
+
+def poll_cli_login(
+    *,
+    request_id: str,
+    poll_code: str,
+    backend_url: Optional[str] = None,
+) -> Dict[str, Any]:
+    base = (backend_url or _backend_base_url()).rstrip("/")
+    with httpx.Client(timeout=20.0) as client:
+        response = client.post(
+            _web_api_url(base) + "cli-auth/poll",
+            json={"request_id": request_id, "poll_code": poll_code},
+            headers={"User-Agent": USER_AGENT},
+        )
+        response.raise_for_status()
+        return response.json()
+
+
+def fetch_profile(*, api_key: str, backend_url: str) -> Dict[str, Any]:
+    base = backend_url.rstrip("/")
+    with httpx.Client(timeout=20.0) as client:
+        response = client.get(
+            _web_api_url(base) + "profile/profile",
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "User-Agent": USER_AGENT,
+            },
+        )
+        response.raise_for_status()
+        return response.json()
+
+
+def run_login(
+    *,
+    no_browser: bool = False,
+    timeout: int = 300,
+    backend_url: Optional[str] = None,
+    frontend_url: Optional[str] = None,
+) -> Credentials:
+    base = (backend_url or _backend_base_url()).rstrip("/")
+
+    print("Login to Socaity")
+    session = start_cli_login(
+        backend_url=base,
+        frontend_url=frontend_url,
+    )
+    verification_uri = session["verification_uri"]
+    request_id = session["request_id"]
+    poll_code = session["poll_code"]
+    interval = max(int(session.get("interval_seconds", 2)), 1)
+
+    print(f"Open this URL to authenticate:\n{verification_uri}")
+
+    if not no_browser:
+        if open_login_url(verification_uri):
+            print("Browser opened for login.")
+        else:
+            print("Could not open a browser automatically. Open the URL manually.")
+
+    print("Waiting for login confirmation...")
+    deadline = time.time() + max(timeout, 10)
+
+    while time.time() < deadline:
+        poll_response = poll_cli_login(
+            request_id=request_id,
+            poll_code=poll_code,
+            backend_url=base,
+        )
+        status = poll_response.get("status")
+
+        if status == "pending":
+            time.sleep(interval)
+            continue
+        if status == "expired":
+            print("Login request expired. Run: socaity login")
+            raise SystemExit(1)
+        if status == "approved":
+            api_key = (poll_response.get("api_key") or "").strip()
+            if not api_key:
+                print("Login failed: missing API key in response.")
+                raise SystemExit(1)
+            creds = Credentials(
+                api_key=api_key,
+                user_id=poll_response.get("user_id"),
+                user_email=poll_response.get("user_email"),
+                backend_url=base,
+            )
+            path = save_credentials(creds)
+            email = creds.user_email or "user"
+            print(f"Logged in as {email}")
+            print(f"Credentials saved to {path}")
+            return creds
+
+        print(f"Login failed: unexpected status '{status}'")
+        raise SystemExit(1)
+
+    print("Login timed out. Run: socaity login")
+    raise SystemExit(1)
+
+
+def run_whoami() -> None:
+    creds = require_credentials()
+    email = creds.user_email
+    user_id = creds.user_id
+    if not email or not user_id:
+        try:
+            profile = fetch_profile(api_key=creds.api_key, backend_url=creds.backend_url)
+            email = email or profile.get("email") or profile.get("user_email")
+            user_id = user_id or profile.get("id") or profile.get("user_id")
+        except Exception as exc:
+            print(f"Could not fetch profile: {exc}")
+            raise SystemExit(1) from exc
+    print(f"user_id: {user_id}")
+    print(f"email: {email}")
+    print(f"backend: {creds.backend_url}")

socaity_cli-0.1.1/socaity_cli/backend_client.py

@@ -0,0 +1,23 @@
+"""Composed platform backend client (catalog, jobs, projects, analytics, files, sdk, deployment)."""
+from socaity_cli.clients.analytics import AnalyticsClient
+from socaity_cli.clients.catalog import CatalogClient
+from socaity_cli.clients.deployment import DeploymentClient
+from socaity_cli.clients.files import FilesClient
+from socaity_cli.clients.jobs import JobsClient
+from socaity_cli.clients.projects import ProjectsClient
+from socaity_cli.clients.sdk_install import SdkInstallClient
+from socaity_cli.http import BackendHttp
+
+
+class SocaityBackendClient(
+    BackendHttp,
+    CatalogClient,
+    JobsClient,
+    ProjectsClient,
+    AnalyticsClient,
+    FilesClient,
+    SdkInstallClient,
+    DeploymentClient,
+):
+    """Facade over domain mixins. Prefer importing a domain client when you only need one surface."""
+    pass