tovuk 0.1.48__tar.gz

tovuk-0.1.48/.gitignore

@@ -0,0 +1,88 @@
+node_modules/
+**/node_modules/
+dist/
+**/dist/
+build/
+**/build/
+target/
+**/target/
+coverage/
+htmlcov/
+*.egg-info/
+.eggs/
+*.egg
+*.whl
+*.tar.gz
+pip-wheel-metadata/
+.pytest_cache/
+**/.pytest_cache/
+.ruff_cache/
+**/.ruff_cache/
+.mypy_cache/
+**/.mypy_cache/
+.tox/
+.nox/
+.venv/
+.direnv/
+.cache/
+**/.cache/
+.turbo/
+**/.turbo/
+.vite/
+**/.vite/
+.parcel-cache/
+**/.parcel-cache/
+.next/
+**/.next/
+.nuxt/
+**/.nuxt/
+.svelte-kit/
+**/.svelte-kit/
+.pnpm-store/
+**/.pnpm-store/
+playwright-report/
+test-results/
+.env
+.env.*
+!.env.example
+.envrc
+.npmrc
+.pypirc
+.cargo/credentials
+.cargo/credentials.toml
+.netrc
+.DS_Store
+**/.DS_Store
+*.log
+*.tgz
+.tovuk/
+.mintlify/
+.agents/
+.codex/
+.claude/
+.cursor/
+.continue/
+.roo/
+.windsurf/
+.aider*
+.vscode/
+.idea/
+
+__pycache__/
+**/__pycache__/
+*.pyc
+*.pyo
+*.tsbuildinfo
+
+[Aa][Gg][Ee][Nn][Tt][Ss].[Mm][Dd]
+**/[Aa][Gg][Ee][Nn][Tt][Ss].[Mm][Dd]
+[Aa][Gg][Ee][Nn][Tt][Ss].[Oo][Vv][Ee][Rr][Rr][Ii][Dd][Ee].[Mm][Dd]
+**/[Aa][Gg][Ee][Nn][Tt][Ss].[Oo][Vv][Ee][Rr][Rr][Ii][Dd][Ee].[Mm][Dd]
+CLAUDE.md
+**/CLAUDE.md
+GEMINI.md
+**/GEMINI.md
+PUBLISHING.md
+npm-support-request.md
+docs/README.md
+sdks/

tovuk-0.1.48/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: tovuk
+Version: 0.1.48
+Summary: Deploy Rust backends, static frontends, and fullstack apps to Tovuk.
+Project-URL: Homepage, https://tovuk.com
+Project-URL: Repository, https://github.com/tovuk/tovuk
+Project-URL: Issues, https://github.com/tovuk/tovuk/issues
+Author: Tovuk
+License-Expression: MIT
+Keywords: backend,deploy,hosting,rust,tovuk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# tovuk
+
+Python CLI package for deploying Rust backends, static frontends, and fullstack
+apps to Tovuk.
+It delegates to the npm Tovuk CLI so PyPI stays aligned with the primary
+agent command surface.
+
+```sh
+pipx install tovuk
+tovuk init my-app --template fullstack-rust-tanstack
+cd my-app/web && bun install && cd ..
+tovuk doctor --json
+tovuk preview
+tovuk deploy --wait --json
+```
+
+From a fullstack repo root, `tovuk deploy` reads one root `tovuk.toml`, builds
+the backend and frontend roots, and returns one app URL with `/api/*` routed to
+the Rust backend.
+
+Rust backend deploys require `cargo fmt --all --check`, locked `cargo check`,
+and locked all-target, all-feature Clippy with `-D warnings`.
+
+Static frontend deploys require TypeScript browser source, stable native
+type-aware TypeScript checks, native linting such as `oxlint`, `biome check`,
+or `deno lint`, and Fallow dead-code, semantic duplicate-code, and health
+gates.
+
+The npm package remains the primary first install path:
+
+```sh
+npx tovuk deploy
+```
+
+Python installs require Node.js 18+ with `npx` available at runtime.
+
+The Python package exposes the same agent command surface as npm:
+
+```sh
+tovuk capabilities
+tovuk me
+tovuk usage
+tovuk activity --json
+tovuk apps
+tovuk overview --app app_1 --json
+tovuk deploys --app app_1
+tovuk builds
+tovuk logs --deploy deploy_1 --limit 100 --json
+tovuk env list --app app_1
+tovuk env set --app app_1 API_KEY=value
+tovuk env delete --app app_1 API_KEY
+tovuk domains add --app app_1 api.example.com
+tovuk domains verify --app app_1 api.example.com
+tovuk billing checkout --json
+tovuk billing portal
+tovuk support create "Deploy failed" "Agent retried deploy after doctor." --app app_1 --build job_1 --deploy deploy_1 --failing-command "tovuk deploy --wait --json" --first-log-line "cargo check failed in src/main.rs" --json
+tovuk support list --json
+tovuk support resolve ticket_0123456789abcdef0123 --json
+```
+
+Agent repair loop:
+
+```sh
+tovuk doctor --json
+tovuk deploy --wait --json
+tovuk logs --build job_1 --json
+```
+
+Fix the first failed `agent_instruction`. If a build fails, inspect build logs,
+fix the first actionable log error, rerun doctor, then redeploy.
+
+On first deploy, the CLI opens browser login, waits for GitHub or Google, stores
+the Tovuk session in the OS credential store when available, and continues the
+deploy. Later commands reuse that session.

tovuk-0.1.48/README.md

@@ -0,0 +1,74 @@
+# tovuk
+
+Python CLI package for deploying Rust backends, static frontends, and fullstack
+apps to Tovuk.
+It delegates to the npm Tovuk CLI so PyPI stays aligned with the primary
+agent command surface.
+
+```sh
+pipx install tovuk
+tovuk init my-app --template fullstack-rust-tanstack
+cd my-app/web && bun install && cd ..
+tovuk doctor --json
+tovuk preview
+tovuk deploy --wait --json
+```
+
+From a fullstack repo root, `tovuk deploy` reads one root `tovuk.toml`, builds
+the backend and frontend roots, and returns one app URL with `/api/*` routed to
+the Rust backend.
+
+Rust backend deploys require `cargo fmt --all --check`, locked `cargo check`,
+and locked all-target, all-feature Clippy with `-D warnings`.
+
+Static frontend deploys require TypeScript browser source, stable native
+type-aware TypeScript checks, native linting such as `oxlint`, `biome check`,
+or `deno lint`, and Fallow dead-code, semantic duplicate-code, and health
+gates.
+
+The npm package remains the primary first install path:
+
+```sh
+npx tovuk deploy
+```
+
+Python installs require Node.js 18+ with `npx` available at runtime.
+
+The Python package exposes the same agent command surface as npm:
+
+```sh
+tovuk capabilities
+tovuk me
+tovuk usage
+tovuk activity --json
+tovuk apps
+tovuk overview --app app_1 --json
+tovuk deploys --app app_1
+tovuk builds
+tovuk logs --deploy deploy_1 --limit 100 --json
+tovuk env list --app app_1
+tovuk env set --app app_1 API_KEY=value
+tovuk env delete --app app_1 API_KEY
+tovuk domains add --app app_1 api.example.com
+tovuk domains verify --app app_1 api.example.com
+tovuk billing checkout --json
+tovuk billing portal
+tovuk support create "Deploy failed" "Agent retried deploy after doctor." --app app_1 --build job_1 --deploy deploy_1 --failing-command "tovuk deploy --wait --json" --first-log-line "cargo check failed in src/main.rs" --json
+tovuk support list --json
+tovuk support resolve ticket_0123456789abcdef0123 --json
+```
+
+Agent repair loop:
+
+```sh
+tovuk doctor --json
+tovuk deploy --wait --json
+tovuk logs --build job_1 --json
+```
+
+Fix the first failed `agent_instruction`. If a build fails, inspect build logs,
+fix the first actionable log error, rerun doctor, then redeploy.
+
+On first deploy, the CLI opens browser login, waits for GitHub or Google, stores
+the Tovuk session in the OS credential store when available, and continues the
+deploy. Later commands reuse that session.

tovuk-0.1.48/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling==1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tovuk"
+version = "0.1.48"
+description = "Deploy Rust backends, static frontends, and fullstack apps to Tovuk."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "Tovuk" }]
+keywords = ["tovuk", "rust", "deploy", "backend", "hosting"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Build Tools"
+]
+
+[project.urls]
+Homepage = "https://tovuk.com"
+Repository = "https://github.com/tovuk/tovuk"
+Issues = "https://github.com/tovuk/tovuk/issues"
+
+[project.scripts]
+tovuk = "tovuk.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tovuk"]

tovuk-0.1.48/src/tovuk/__init__.py

@@ -0,0 +1,4 @@
+"""Tovuk Python package."""
+
+__all__ = ["__version__"]
+__version__ = "0.1.48"

tovuk-0.1.48/src/tovuk/__main__.py

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

tovuk-0.1.48/src/tovuk/cli.py

@@ -0,0 +1,82 @@
+"""Thin Python entrypoint for the npm Tovuk CLI source of truth."""
+
+from __future__ import annotations
+
+import json
+import os
+import pathlib
+import shutil
+import subprocess
+import sys
+
+from . import __version__
+
+NPM_PACKAGE = "tovuk"
+NPM_PACKAGE_VERSION = "0.1.48"
+NPM_PACKAGE_SPEC = f"{NPM_PACKAGE}@{NPM_PACKAGE_VERSION}"
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if _wants_version(args):
+        print(__version__)
+        return
+
+    try:
+        command = _delegate_command()
+    except RuntimeError as error:
+        _print_agent_error(str(error), "--json" in args)
+        raise SystemExit(1) from error
+
+    completed = subprocess.run([*command, *args], check=False)
+    raise SystemExit(completed.returncode)
+
+
+def _wants_version(args: list[str]) -> bool:
+    return len(args) == 1 and args[0] in {"--version", "-v", "-V"}
+
+
+def _delegate_command() -> list[str]:
+    local_cli = os.environ.get("TOVUK_NPM_CLI", "").strip()
+    if local_cli:
+        path = pathlib.Path(local_cli).expanduser()
+        if not path.is_file():
+            raise RuntimeError(f"TOVUK_NPM_CLI does not point to a file: {path}")
+        return [_local_tsx(path), str(path)]
+
+    npx = shutil.which("npx")
+    if npx:
+        return [npx, "-y", NPM_PACKAGE_SPEC]
+
+    raise RuntimeError("Node.js npm tooling is required for the PyPI Tovuk CLI.")
+
+
+def _required_executable(name: str) -> str:
+    executable = shutil.which(name)
+    if executable:
+        return executable
+    raise RuntimeError(f"{name} is required to run the local Tovuk npm CLI.")
+
+
+def _local_tsx(cli_path: pathlib.Path) -> str:
+    package_root = cli_path.parent.parent
+    local_bin = package_root / "node_modules" / ".bin" / ("tsx.cmd" if os.name == "nt" else "tsx")
+    if local_bin.is_file():
+        return str(local_bin)
+    return _required_executable("tsx")
+
+
+def _print_agent_error(message: str, json_output: bool) -> None:
+    payload = {
+        "code": "dependency_missing",
+        "message": message,
+        "agent_instruction": "Install Node.js 18+ with npx, or set TOVUK_NPM_CLI to packages/tovuk/src/tovuk.ts after running npm install in packages/tovuk.",
+        "docs_url": "https://docs.tovuk.com/reference/packages",
+        "checkout_url": None,
+    }
+    if json_output:
+        print(json.dumps(payload, indent=2), file=sys.stderr)
+        return
+
+    print(payload["message"], file=sys.stderr)
+    print(f"agent_instruction: {payload['agent_instruction']}", file=sys.stderr)