sovaria-cli 0.2.0__py3-none-any.whl

apps/cli/tests/test_main_startup.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import subprocess
+import sys
+
+
+def test_cli_module_help() -> None:
+    result = subprocess.run(
+        [sys.executable, "-m", "apps.cli.src.main", "--help"],
+        check=False,
+        capture_output=True,
+        text=True,
+    )
+
+    assert result.returncode == 0
+    assert "Sovaria BaaS command-line interface" in result.stdout
+    assert "login" in result.stdout
+
+
+def test_sov_console_script_help() -> None:
+    result = subprocess.run(
+        [sys.executable, "-m", "apps.cli.src.main", "--version"],
+        check=False,
+        capture_output=True,
+        text=True,
+    )
+
+    assert result.returncode == 0
+    assert "sov version 0.2.0" in result.stdout

apps/cli/tests/test_project_and_commands.py

@@ -0,0 +1,196 @@
+"""Tests for project context resolution and new CLI command paths."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+import pytest
+
+from apps.cli.src.utils import project_context
+
+
+def test_resolve_scope_prefers_explicit_flags(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    config = {
+        "project": {"name": "demo"},
+        "gateway": {"url": "http://localhost:8000"},
+        "scope": {"org_id": "org-local", "project_id": "proj-local", "env_id": ""},
+        "features": {"realtime": True, "functions": True, "storage": True},
+    }
+    config_path = tmp_path / "sovaria.config.json"
+    config_path.write_text(json.dumps(config))
+
+    monkeypatch.chdir(tmp_path)
+    monkeypatch.setattr(
+        project_context,
+        "get_scope",
+        lambda profile=None: {"org_id": "org-profile", "project_id": "proj-profile", "env_id": ""},
+    )
+
+    org, project, env = project_context.resolve_scope(
+        profile=None,
+        org_id="org-flag",
+        project_id=None,
+        env_id=None,
+    )
+    assert org == "org-flag"
+    assert project == "proj-local"
+    assert env == ""
+
+
+def test_resolve_scope_requires_linked_project(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(project_context, "linked_scope", lambda profile=None: {"org_id": "", "project_id": "", "env_id": ""})
+    monkeypatch.setattr(
+        project_context,
+        "get_scope",
+        lambda profile=None: {"org_id": "", "project_id": "", "env_id": ""},
+    )
+    with pytest.raises(ValueError, match="Missing project scope"):
+        project_context.resolve_scope(
+            profile=None,
+            org_id=None,
+            project_id=None,
+            env_id=None,
+            require=True,
+        )
+
+
+def test_sim_discover_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import sim
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> dict[str, Any]:
+        captured.update(kwargs)
+        return {"scenarios": []}
+
+    monkeypatch.setattr(sim, "call_api", _fake_call_api)
+    sim.discover(profile=None, org_id=None, project_id=None, env_id=None)
+
+    assert captured["method"] == "POST"
+    assert captured["path"] == "/api/v1/sim/discover"
+    assert captured["require_scope"] is True
+
+
+def test_keys_list_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import keys
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> list[dict[str, Any]]:
+        captured.update(kwargs)
+        return []
+
+    monkeypatch.setattr(keys, "call_api", _fake_call_api)
+    keys.list_keys(profile=None, org_id="org-1", project_id="proj-1", env_id=None)
+
+    assert captured["method"] == "GET"
+    assert captured["path"] == "/api/v1/apikeys"
+    assert captured["require_scope"] is True
+
+
+def test_policy_simulate_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import policy
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> dict[str, Any]:
+        captured.update(kwargs)
+        return {"allowed": True}
+
+    monkeypatch.setattr(policy, "call_api", _fake_call_api)
+    policy.simulate_policy(
+        spl_source="allow all",
+        context="{}",
+        profile="dev",
+        org_id="org-1",
+        project_id="proj-1",
+        env_id=None,
+    )
+
+    assert captured["method"] == "POST"
+    assert captured["path"] == "/api/v1/policies/simulate"
+    assert captured["body"] == {"spl_source": "allow all", "context": {}}
+
+
+def test_db_tx_begin_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import db
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> dict[str, Any]:
+        captured.update(kwargs)
+        return {"txid": 1, "snapshot_txid": 1}
+
+    monkeypatch.setattr(db, "call_api", _fake_call_api)
+    db.tx_begin(profile=None, org_id="org-1", project_id="proj-1", env_id=None)
+
+    assert captured["method"] == "POST"
+    assert captured["path"] == "/api/v1/data/rel/transaction/begin"
+    assert captured["require_scope"] is True
+
+
+def test_fn_logs_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import deploy
+    from apps.cli.src.utils import api_client
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> list[dict[str, Any]]:
+        captured.update(kwargs)
+        return []
+
+    monkeypatch.setattr(api_client, "call_api", _fake_call_api)
+    monkeypatch.setattr(deploy.typer, "echo", lambda *args, **kwargs: None)
+    deploy.logs(
+        function_name="hello",
+        limit=10,
+        offset=0,
+        status=None,
+        profile=None,
+        org_id=None,
+        project_id="proj-1",
+        env_id=None,
+    )
+
+    assert captured["path"] == "/api/v1/fn/functions/hello/logs"
+    assert captured["require_scope"] is True
+
+
+def test_auth_sessions_path_smoke(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import login
+    from apps.cli.src.utils import api_client
+
+    captured: dict[str, Any] = {}
+
+    def _fake_call_api(**kwargs: Any) -> list[dict[str, Any]]:
+        captured.update(kwargs)
+        return []
+
+    monkeypatch.setattr(api_client, "call_api", _fake_call_api)
+    monkeypatch.setattr(login.typer, "echo", lambda *args, **kwargs: None)
+    login.list_sessions(profile="dev")
+
+    assert captured["method"] == "GET"
+    assert captured["path"] == "/api/v1/auth/sessions"
+
+
+def test_storage_buckets_uses_call_api(monkeypatch: pytest.MonkeyPatch) -> None:
+    from apps.cli.src.commands import storage
+
+    captured: dict[str, Any] = {}
+    output: list[str] = []
+
+    def _fake_call_api(**kwargs: Any) -> list[dict[str, Any]]:
+        captured.update(kwargs)
+        return [{"name": "bucket-a", "public": False, "object_count": 1}]
+
+    monkeypatch.setattr(storage, "call_api", _fake_call_api)
+    monkeypatch.setattr(storage.typer, "echo", lambda message, err=False: output.append(str(message)))
+
+    storage.list_buckets(project_id="proj-1", org_id=None, env_id=None, profile=None)
+
+    assert captured["path"] == "/api/v1/store/buckets"
+    assert captured["require_scope"] is True
+    assert any("bucket-a" in line for line in output)

sovaria_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,170 @@
+Metadata-Version: 2.5
+Name: sovaria-cli
+Version: 0.2.0
+Summary: Sovaria BaaS command-line interface (sov)
+Project-URL: Homepage, https://sovaria.in
+Project-URL: Documentation, https://docs.sovaria.in/cli
+Project-URL: Repository, https://github.com/sovaria/sovaria-cli
+Author: Sovaria Team
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: keyring>=25.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: sovaria-sdk>=0.2.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: typer>=0.17.4
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Requires-Dist: twine>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Sovaria CLI
+
+Operator CLI for gateway-backed Sovaria project and platform workflows.
+
+## Run
+
+Examples below use `sov ...` command syntax.
+
+If `sov` is installed on your PATH:
+
+```bash
+sov --help
+```
+
+From repo root without installation:
+
+```bash
+python -m apps.cli.src.main --help
+```
+
+## Cross-SDK Happy Path Smoke
+
+Use the repository smoke script to validate one shared happy path across:
+
+- CLI auth + scoped SQL call
+- TypeScript SDK SQL + engine health
+- Python SDK SQL + engine health
+
+```bash
+SOVARIA_URL=http://localhost:8000 \
+SOVARIA_ORG_ID=<org_uuid> \
+SOVARIA_PROJECT_ID=<project_uuid> \
+SOVARIA_EMAIL=<owner_email> \
+SOVARIA_PASSWORD='<owner_password>' \
+scripts/cli_sdk_happy_path.sh
+```
+
+If you already have valid CLI tokens, omit `SOVARIA_EMAIL` and `SOVARIA_PASSWORD`.
+
+## Core Command Groups
+
+- `sov auth ...` auth login/logout
+- `sov scope ...` default org/project/env scope
+- `sov data ...` Atlas-Doc and Atlas-Rel
+- `sov realtime ...` Pulse realtime and e2ee
+- `sov policy ...` Guard policy management
+- `sov audit ...` Echo audit and simulation
+- `sov chrono ...` Chrono timeline/snapshot operations
+- `sov fn ...` Forge function deploy/status/invoke
+- `sov project ...` project config template + scaffold creation
+- `sov api call ...` raw gateway API request
+
+## Project Bootstrap (Config JSON)
+
+Create a template config file:
+
+```bash
+sov project init-config my-app --output sovaria.config.json
+```
+
+Then scaffold a project from that config:
+
+```bash
+sov project create --config sovaria.config.json --dir .
+```
+
+## Function Sandbox Flow
+
+Deploy a function bundle (zipped from local folder):
+
+```bash
+sov fn deploy ./my-function --name hello --project <project_id> --note "add audit logging"
+```
+
+Poll deployment status:
+
+```bash
+sov fn status <deploy_id> --project <project_id>
+```
+
+Invoke the deployed function in its project sandbox:
+
+```bash
+sov fn invoke hello --project <project_id> --data '{"message":"hi"}'
+```
+
+Run a simulation invocation (tracked separately from normal invoke):
+
+```bash
+sov fn invoke hello --project <project_id> --simulate --data '{"message":"dry-run"}'
+```
+
+Queue heavy async invocation and wait for completion:
+
+```bash
+sov fn invoke hello --project <project_id> --execution-profile heavy --async --wait --data-file payload.json
+```
+
+List function versions:
+
+```bash
+sov fn versions hello --project <project_id>
+```
+
+List functions with active versions + queue depth:
+
+```bash
+sov fn functions --project <project_id>
+```
+
+List invocation history:
+
+```bash
+sov fn history hello --project <project_id> --mode invoke
+```
+
+List durable async jobs:
+
+```bash
+sov fn jobs hello --project <project_id> --status QUEUED
+```
+
+Promote a specific function version:
+
+```bash
+sov fn promote hello --project <project_id> --version 3 --reason "promote stable release"
+```
+
+Rollback to previous active version:
+
+```bash
+sov fn rollback hello --project <project_id> --reason "rollback regression"
+```
+
+Diff two simulation invocations:
+
+```bash
+sov fn sim-diff hello <left_invocation_id> <right_invocation_id> --project <project_id>
+```
+
+## Scope Requirement
+
+Realtime and relational routes require org/project scope. You can pass scope per command (`--org --project --env`) or set defaults:
+
+```bash
+sov scope set <org_id> <project_id> --env <env_id>
+```

sovaria_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+apps/cli/README.md,sha256=vsb2FKzgRUGbaKuejsYwewPhNkPdMIQSQJALwp_6UYo,3293
+apps/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+apps/cli/src/__init__.py,sha256=6s9YuL853tUZg-e54W3cpk4yElFhN4D1fQxS3FHMFc0,58
+apps/cli/src/main.py,sha256=Rnf9SDJvlhniHUMhTsb4HK7722hbQ0VBA8ATlF0Ci7A,8063
+apps/cli/src/commands/__init__.py,sha256=eMuQR40Ye6ei4XbISb4dO1BwFk5RRqKIKGMxrztVu9Y,28
+apps/cli/src/commands/admin.py,sha256=hvYxkeb7pc_B3MInPFlgDeVv5w-MmVqXwfGSV3n_4pM,5380
+apps/cli/src/commands/api.py,sha256=OVVeIsAF4aorrQe6as6QKblEg_hGyzb0rBvXa9n8izk,1868
+apps/cli/src/commands/audit.py,sha256=ltQhP2hu489RQhYkwFrc5nS4FU1klwzk1k91EpqZess,6306
+apps/cli/src/commands/auth_product.py,sha256=fmgtCZNSmmGyrbu_xVIVOz-ffj1wU2G-34QTXC28wU0,6539
+apps/cli/src/commands/billing.py,sha256=10dV8V7HRW6Yo0wBurZPK-FWhay5DpKz3_L5jS6t1RA,16019
+apps/cli/src/commands/chrono.py,sha256=1Kn3W1tZORyK0ViD6QLpBy2P-FGi3lytHZeJydCrzxE,7693
+apps/cli/src/commands/context.py,sha256=wEOkSGKueF5YQLHK-SwTVL54WDJSr6UN3c_L-sFSmBA,3342
+apps/cli/src/commands/data.py,sha256=mwwAmuugZg6LjZveZdVkZCS8dN2L2dKUc6oWhpd_dNI,9090
+apps/cli/src/commands/db.py,sha256=CpBWlCLW3xepqbQxXqOhyi3QktjZ1MJryqpvXM6r3DA,18223
+apps/cli/src/commands/deploy.py,sha256=NC1ETm-7a4D5UPZ7OpwavbqnebrAQ8WDJs83ZVZUXyc,37767
+apps/cli/src/commands/governance.py,sha256=FvjDbb5vH1yRa5KUD9kKJBYndIiywwTG_s_QlK2X_RQ,16032
+apps/cli/src/commands/iam.py,sha256=MDfZMmk1c8nWdKlOjFdGOjpW06iCQ8nagsOo0v9ZohY,14038
+apps/cli/src/commands/init_cmd.py,sha256=1DTSSRAjuQbvUTApBGRq4x5LxR-R-qTi0_OVVCA4ROc,6788
+apps/cli/src/commands/keys.py,sha256=47ny4SEI38GHSM5kBGAEuFH0M8uCssXAA5gp0ZA7U90,4084
+apps/cli/src/commands/login.py,sha256=nh2JYTpe1ihtX0gJ9vh4LRrIBY-rSIjdYSq6GVr4Ejk,30419
+apps/cli/src/commands/org.py,sha256=AntqUHtfvep1aKE1kBbyplPh0B7Lm7B3zSA3PYGAxGc,4827
+apps/cli/src/commands/policy.py,sha256=HGFMOwtLhchMCwZS23b24KGR-J6O64JF1LzJcnpGdAM,10747
+apps/cli/src/commands/project.py,sha256=IXX8fDnabgaW4F6JojUPaStszxzHQkAI4i5Y2fb2ZGo,4222
+apps/cli/src/commands/realtime.py,sha256=XgQ2jpsp5Z1edklwjJX46BlQTe4NQi5lOmoATf8kBic,12761
+apps/cli/src/commands/scope.py,sha256=l8IEZHII4ljpY6BC1AF7lRwpV50WNWBufFzaZJGexaw,1383
+apps/cli/src/commands/shell.py,sha256=UXwo9lts5lQAFUH8o_dFcOKYkiELPSgi2UxRN6S55uk,14006
+apps/cli/src/commands/sim.py,sha256=wRj-DXkoGVs1SepJ77I1zl7JVXNEYLkQfZJJU2nNTlQ,6082
+apps/cli/src/commands/storage.py,sha256=IugNew6VISsGqI4X1zh8fed8i2NnE_BZ-USxa1ZSWWU,14385
+apps/cli/src/commands/vector.py,sha256=LubqnUbQKCYbvqN_qU9FYZ9MF0W99eaPUf5OKU5lOdQ,6953
+apps/cli/src/utils/__init__.py,sha256=vYKSJLLcdWMtOyf5KHVMFNEzHnFG5WTSOz4ymu9JwBk,29
+apps/cli/src/utils/api_client.py,sha256=KfFgJCunCq6yf83gdlQCAogC0r8WRffVVBJ6Lwh63Qs,11836
+apps/cli/src/utils/auth_store.py,sha256=vVyowWnOSCjp6sYgTK1OQBcV_4u853bqMj-ySwsp21Y,9766
+apps/cli/src/utils/config.py,sha256=TudlrHWdrW0h0Qt_vIYy6m238qS1JesL5lV_0Xs-Po8,5718
+apps/cli/src/utils/display.py,sha256=43AShOIyUtOBBWe2TjCjA3oTCQ6DLqXbp-OEab35EPo,1803
+apps/cli/src/utils/migrations.py,sha256=snEw1a7c_3XalJ5Aabz1jexaQOo6xsTwXTyl0MpObKQ,2251
+apps/cli/src/utils/project_context.py,sha256=QMctOGrcHR0JmMbXRyj-ivja4tbIrzx8wkCLHURBgvc,4156
+apps/cli/tests/test_auth_store_profiles.py,sha256=YGedg1XQt5N3WYc23aybrElTbpBnthqPMYXHU4j2w-A,4026
+apps/cli/tests/test_cli_security.py,sha256=4V8i3piABmntJ1d_FFxZLSs91CiJDUIU-Vymi37dqp0,3801
+apps/cli/tests/test_cli_smoke_paths.py,sha256=d8-7bgCjGDJandTZDvkoRvED6KGmAgZ7VWx9aktDCoo,9629
+apps/cli/tests/test_config_profiles.py,sha256=ERUpTOyZ9U8AtA3hIcO_wNlbvP0dGMgDdvMNf__vDlM,1594
+apps/cli/tests/test_main_startup.py,sha256=Hor2XhjsBXUDqCbjsGyTW-MTFUbjBitur8bPTxaNp30,706
+apps/cli/tests/test_project_and_commands.py,sha256=11Qsd570UNzvf30XPbo5b2eQn9T1zTcAvFNkFbc5IoE,6276
+sovaria_cli-0.2.0.dist-info/METADATA,sha256=LQyvB4dnGwTJ_d56LuX2E5xL2Dd-BkRev_f-wGwZ6UI,4026
+sovaria_cli-0.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+sovaria_cli-0.2.0.dist-info/entry_points.txt,sha256=MPAectZWR-aNVegp6O-gS6hVUWikhPq8V-xPQ-T4QPg,52
+sovaria_cli-0.2.0.dist-info/RECORD,,

sovaria_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sovaria_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sov = apps.cli.src.main:cli_entry