appliku 0.1.0__tar.gz

appliku-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Byte-compiled / optimized
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# Environment variables
+.env
+.env.*
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test artifacts
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# Type checking
+.mypy_cache/

appliku-0.1.0/CLAUDE.md

@@ -0,0 +1,117 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`appliku-cli` is a Python CLI and SDK for the [Appliku](https://api.appliku.com) platform. It wraps the Appliku OpenAPI spec (`https://api.appliku.com/api/schema/`) and is published to PyPI. The project uses **UV** for all Python environment and dependency management.
+
+## Environment & Tooling
+
+- **Python package manager**: UV exclusively. Never use `pip install` directly. Use `uv add` for dependencies, `uv run` to execute commands within the project environment.
+- **Project config**: `pyproject.toml` is the single source of truth for metadata, dependencies, scripts, and tool configuration.
+- **Build backend**: `hatchling` as specified in `pyproject.toml`.
+
+## Common Commands
+
+```bash
+# Create/sync the environment
+uv sync
+
+# Run the CLI
+uv run appliku --help
+
+# Run tests
+uv run pytest
+
+# Run a single test file or test by keyword
+uv run pytest tests/test_apps.py
+uv run pytest -k "test_create_app"
+
+# Lint and format (assuming ruff is configured)
+uv run ruff check .
+uv run ruff format .
+
+# Type check (if mypy is configured)
+uv run mypy src/
+
+# Build the package for PyPI
+uv build
+
+# Publish to PyPI (dry run first)
+uv publish --dry-run
+uv publish
+```
+
+## Architecture & Code Organization
+
+The project follows a **src layout**:
+
+```
+src/appliku/
+├── __init__.py              # Public SDK exports (Appliku class + all models + exceptions)
+├── _main.py                 # Appliku class — SDK entry point with lazy resource properties
+├── _client.py               # AplikuClient — HTTP client with retry, pagination, error handling
+├── _auth.py                 # Token resolution (env/config/param) + login flow + config persistence
+├── _exceptions.py           # Exception hierarchy: AplikuError → typed subclasses
+├── _models.py               # All Pydantic v2 models (PaginatedResponse, Team, App, Deployment, etc.)
+├── resources/               # Resource classes — one per API domain
+│   ├── teams.py             # TeamsResource: list, get, create, update, delete
+│   ├── apps.py              # AppsResource: list, get, create, update, delete, deploy, config vars
+│   ├── deployments.py       # DeploymentsResource: list, get, latest, logs, stream_logs
+│   ├── datastores.py        # DatastoresResource: list, get, create, delete, start, stop, restart
+│   ├── domains.py           # DomainsResource: list, get, create, delete
+│   ├── volumes.py           # VolumesResource: list, get, create, update, delete
+│   ├── cron_jobs.py         # CronJobsResource: list, get, create, update, delete
+│   ├── clusters.py          # ClustersResource: list, get, create, delete
+│   ├── servers.py           # ServersResource: list, get, create_digitalocean, create_ec2, create_custom
+│   ├── invites.py           # InvitesResource: list, create, delete, accept, decline
+│   └── migrations.py        # MigrationsResource: list, get, run, logs
+└── cli/                     # Typer CLI layer
+    ├── __init__.py          # Root Typer app + shared helpers (get_client, render_output, render_table)
+    ├── auth.py              # Root commands: login, logout, whoami
+    ├── teams.py             # teams sub-app
+    ├── apps.py              # apps sub-app (list, get, create, update, delete, deploy, config, set-config)
+    ├── deployments.py       # deployments sub-app (list, latest, logs --stream)
+    ├── datastores.py        # datastores sub-app (list, create, delete, start, stop, restart)
+    ├── domains.py           # domains sub-app (list, create, delete)
+    ├── volumes.py           # volumes sub-app (list, create, update, delete)
+    ├── cron_jobs.py         # crons sub-app (list, create, update, delete)
+    ├── clusters.py          # clusters sub-app (list, create, delete)
+    ├── servers.py           # servers sub-app (list, create-do, create-ec2, create-custom)
+    ├── invites.py           # invites sub-app (list, create, delete, accept, decline)
+    └── migrations.py        # migrations sub-app (list, run, logs)
+```
+
+### Key Architectural Decisions
+
+1. **API surface is driven by the OpenAPI spec at `https://api.appliku.com/api/schema/`**. The resource model maps to:
+   - **Auth**: Token + JWT authentication, API key management
+   - **Teams**: Team CRUD, member invitations, cloud credential storage (AWS, DigitalOcean)
+   - **Apps**: Application lifecycle — deploy, scale processes, manage domains/SSL, config vars
+   - **Infrastructure**: Clusters, build servers, EC2/DigitalOcean instance provisioning
+   - **Data Services**: Datastores (databases), backups, volumes, replica promotion
+   - **Monitoring**: Logs (app, nginx, deployment, DB migration), stats/metrics
+   - **Integrations**: GitHub/GitLab repos, cron jobs, webhooks, one-off commands
+
+2. **CLI commands mirror SDK client methods.** Each top-level resource maps to a Typer sub-app. The SDK client is usable independently of the CLI.
+
+3. **Authentication flow**: Token resolution priority: explicit param → `APPLIKU_TOKEN` env → `~/.config/appliku/config.toml`. Login does a two-step flow: POST `/api/sign_up/` for JWT, then POST `/api/obtain_user_api_key/` for persistent API key.
+
+4. **Output formatting**: CLI commands default to Rich tables. All list commands support `--output json` for scripting.
+
+5. **Error handling**: Typed exception hierarchy with auto-retry on 429 (respect Retry-After) and 5xx (exponential backoff, up to 3 attempts).
+
+6. **Pagination**: `AplikuClient.paginate()` for single page, `paginate_all()` for auto-following next links.
+
+## OpenAPI Schema
+
+The canonical schema is at `https://api.appliku.com/api/schema/`. When adding new endpoints or updating models, fetch the latest schema to verify field names and types.
+
+## Testing
+
+- Tests live in `tests/` and use **pytest**.
+- `conftest.py` provides `mock_client` fixture using `httpx.MockTransport` — no network calls.
+- Push `httpx.Response` objects onto the responses list to define mock behavior.
+- `paginated_response` fixture factory wraps results in standard pagination envelope.
+- Integration/e2e tests (if any) should be gated behind `@pytest.mark.integration`.

appliku-0.1.0/LICENSE

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

appliku-0.1.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: appliku
+Version: 0.1.0
+Summary: Python CLI and SDK for Appliku
+Project-URL: Homepage, https://github.com/appliku/appliku-cli
+Project-URL: Documentation, https://github.com/appliku/appliku-cli#readme
+Project-URL: Issues, https://github.com/appliku/appliku-cli/issues
+Author-email: Appliku <dev@appliku.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: appliku,cli,deployment,paas,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# appliku
+
+[![PyPI version](https://badge.fury.io/py/appliku.svg)](https://pypi.org/project/appliku/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+
+Python CLI and SDK for the [Appliku](https://appliku.com) cloud deployment platform.
+
+Appliku is a PaaS that lets you deploy applications, manage infrastructure, and scale services — all from a single unified interface. This package provides both a programmatic Python SDK and a fully-featured command-line interface.
+
+## Installation
+
+```bash
+pip install appliku
+```
+
+UV users:
+
+```bash
+uv add appliku
+```
+
+## Quick Start (SDK)
+
+```python
+from appliku import Appliku
+
+client = Appliku(token="your-api-token")
+
+# List apps in a team
+apps = client.apps.list("my-team")
+for app in apps.results:
+    print(f"{app.name} — {app.status}")
+
+# Trigger a deployment
+deployment = client.apps.deploy("my-team", app_id=42)
+print(f"Deployment {deployment.id} is {deployment.status}")
+```
+
+## Authentication
+
+There are three ways to authenticate:
+
+1. **Constructor parameter**: `Appliku(token="tok_...")`
+2. **Environment variable**: `export APPLIKU_TOKEN=tok_...`
+3. **CLI login** (saves token to `~/.config/appliku/config.toml`):
+   ```bash
+   appliku login --email you@example.com --password secret
+   ```
+
+The SDK checks these sources in order: explicit token → `APPLIKU_TOKEN` env var → config file.
+
+## SDK Usage
+
+### Teams
+
+```python
+# List teams
+teams = client.teams.list()
+
+# Create a team
+team = client.teams.create("my-team-slug", "My Team")
+
+# Update and delete
+client.teams.update("my-team-slug", name="Renamed Team")
+client.teams.delete("my-team-slug")
+```
+
+### Apps
+
+```python
+# List apps
+apps = client.apps.list("my-team")
+
+# Create an app
+app = client.apps.create(
+    "my-team",
+    name="web-app",
+    branch="main",
+    git_url="https://github.com/user/repo.git",
+    build_pack="dockerfile",
+)
+
+# Deploy
+deployment = client.apps.deploy("my-team", app.id)
+
+# Config vars
+vars = client.apps.get_config_vars("my-team", app.id)
+client.apps.set_config_vars("my-team", app.id, {"DATABASE_URL": "postgres://...", "DEBUG": "false"})
+```
+
+### Deployments
+
+```python
+# List deployments
+deployments = client.deployments.list("my-team", app_id=42)
+
+# Get latest
+latest = client.deployments.latest("my-team", app_id=42)
+
+# Stream logs in real-time
+for log in client.deployments.stream_logs("my-team", app_id=42, deployment_id=latest.id):
+    print(f"[{log.timestamp}] {log.message}")
+```
+
+### Datastores
+
+```python
+# Create a database
+db = client.datastores.create("my-team", app_id=42, name="primary-db", engine="postgres", version="15")
+
+# Lifecycle management
+client.datastores.stop("my-team", 42, db.id)
+client.datastores.start("my-team", 42, db.id)
+client.datastores.restart("my-team", 42, db.id)
+```
+
+### Domains & Volumes
+
+```python
+# Domains
+domain = client.domains.create("my-team", app_id=42, domain="app.example.com")
+client.domains.delete("my-team", 42, domain.id)
+
+# Volumes
+vol = client.volumes.create("my-team", app_id=42, name="data", container_path="/data")
+client.volumes.update("my-team", 42, vol.id, name="user-data")
+```
+
+### Cron Jobs
+
+```python
+cron = client.cron_jobs.create(
+    "my-team", app_id=42,
+    name="cleanup", schedule="0 2 * * *", command="python manage.py cleanup"
+)
+client.cron_jobs.update("my-team", 42, cron.id, is_disabled=True)
+```
+
+### Clusters & Servers
+
+```python
+# Create a cluster
+cluster = client.clusters.create("my-team", name="production")
+
+# Provision servers
+do_server = client.servers.create_digitalocean("my-team", name="web-1", region="nyc1", size="s-2vcpu-2gb")
+ec2_server = client.servers.create_ec2("my-team", name="worker-1", region="us-east-1", instance_type="t3.large")
+custom_server = client.servers.create_custom("my-team", name="bare-metal", host="203.0.113.1")
+```
+
+## CLI Usage
+
+### Authentication
+
+```bash
+appliku login --email you@example.com --password secret
+appliku whoami
+appliku logout
+```
+
+### Apps
+
+```bash
+appliku apps list --team my-team
+appliku apps create --team my-team --name web-app --branch main --git-url https://github.com/user/repo.git
+appliku apps deploy --team my-team --app 42
+appliku apps config --team my-team --app 42
+appliku apps set-config --team my-team --app 42 --var FOO=bar --var BAZ=qux
+```
+
+### Deployments
+
+```bash
+appliku deployments list --team my-team --app 42
+appliku deployments latest --team my-team --app 42
+appliku deployments logs --team my-team --app 42 --deployment 7 --stream
+```
+
+### Datastores
+
+```bash
+appliku datastores create --team my-team --app 42 --name primary-db --engine postgres --version 15
+appliku datastores start --team my-team --app 42 1
+appliku datastores stop --team my-team --app 42 1
+```
+
+### All commands support `--output json` for scripting:
+
+```bash
+appliku apps list --team my-team --output json
+```
+
+## CLI Reference
+
+| Command Group   | Subcommands                                      |
+|-----------------|--------------------------------------------------|
+| *(root)*        | `login`, `logout`, `whoami`                      |
+| `teams`         | `list`, `get`, `create`, `update`, `delete`      |
+| `apps`          | `list`, `get`, `create`, `update`, `delete`, `deploy`, `config`, `set-config` |
+| `deployments`   | `list`, `latest`, `logs`                         |
+| `datastores`    | `list`, `create`, `delete`, `start`, `stop`, `restart` |
+| `domains`       | `list`, `create`, `delete`                       |
+| `volumes`       | `list`, `create`, `update`, `delete`             |
+| `crons`         | `list`, `create`, `update`, `delete`             |
+| `clusters`      | `list`, `create`, `delete`                       |
+| `servers`       | `list`, `create-do`, `create-ec2`, `create-custom` |
+| `invites`       | `list`, `create`, `delete`, `accept`, `decline` |
+| `migrations`    | `list`, `run`, `logs`                            |
+
+## Error Handling
+
+The SDK raises typed exceptions so you can handle specific failure modes:
+
+```python
+from appliku import Appliku, NotFoundError, AuthenticationError, RateLimitError
+
+client = Appliku()
+
+try:
+    app = client.apps.get("my-team", app_id=999)
+except NotFoundError as e:
+    print(f"App not found: {e}")
+except AuthenticationError:
+    print("Invalid or expired token")
+except RateLimitError:
+    print("Too many requests — retried automatically")
+```
+
+Exception hierarchy:
+- `AplikuError` (base)
+  - `AuthenticationError` — 401
+  - `AuthorizationError` — 403
+  - `NotFoundError` — 404
+  - `ValidationError` — 400 (field-level errors)
+  - `RateLimitError` — 429 (auto-retried)
+  - `ServerError` — 5xx (auto-retried with backoff)
+
+## License
+
+MIT

appliku-0.1.0/README.md

@@ -0,0 +1,241 @@
+# appliku
+
+[![PyPI version](https://badge.fury.io/py/appliku.svg)](https://pypi.org/project/appliku/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+
+Python CLI and SDK for the [Appliku](https://appliku.com) cloud deployment platform.
+
+Appliku is a PaaS that lets you deploy applications, manage infrastructure, and scale services — all from a single unified interface. This package provides both a programmatic Python SDK and a fully-featured command-line interface.
+
+## Installation
+
+```bash
+pip install appliku
+```
+
+UV users:
+
+```bash
+uv add appliku
+```
+
+## Quick Start (SDK)
+
+```python
+from appliku import Appliku
+
+client = Appliku(token="your-api-token")
+
+# List apps in a team
+apps = client.apps.list("my-team")
+for app in apps.results:
+    print(f"{app.name} — {app.status}")
+
+# Trigger a deployment
+deployment = client.apps.deploy("my-team", app_id=42)
+print(f"Deployment {deployment.id} is {deployment.status}")
+```
+
+## Authentication
+
+There are three ways to authenticate:
+
+1. **Constructor parameter**: `Appliku(token="tok_...")`
+2. **Environment variable**: `export APPLIKU_TOKEN=tok_...`
+3. **CLI login** (saves token to `~/.config/appliku/config.toml`):
+   ```bash
+   appliku login --email you@example.com --password secret
+   ```
+
+The SDK checks these sources in order: explicit token → `APPLIKU_TOKEN` env var → config file.
+
+## SDK Usage
+
+### Teams
+
+```python
+# List teams
+teams = client.teams.list()
+
+# Create a team
+team = client.teams.create("my-team-slug", "My Team")
+
+# Update and delete
+client.teams.update("my-team-slug", name="Renamed Team")
+client.teams.delete("my-team-slug")
+```
+
+### Apps
+
+```python
+# List apps
+apps = client.apps.list("my-team")
+
+# Create an app
+app = client.apps.create(
+    "my-team",
+    name="web-app",
+    branch="main",
+    git_url="https://github.com/user/repo.git",
+    build_pack="dockerfile",
+)
+
+# Deploy
+deployment = client.apps.deploy("my-team", app.id)
+
+# Config vars
+vars = client.apps.get_config_vars("my-team", app.id)
+client.apps.set_config_vars("my-team", app.id, {"DATABASE_URL": "postgres://...", "DEBUG": "false"})
+```
+
+### Deployments
+
+```python
+# List deployments
+deployments = client.deployments.list("my-team", app_id=42)
+
+# Get latest
+latest = client.deployments.latest("my-team", app_id=42)
+
+# Stream logs in real-time
+for log in client.deployments.stream_logs("my-team", app_id=42, deployment_id=latest.id):
+    print(f"[{log.timestamp}] {log.message}")
+```
+
+### Datastores
+
+```python
+# Create a database
+db = client.datastores.create("my-team", app_id=42, name="primary-db", engine="postgres", version="15")
+
+# Lifecycle management
+client.datastores.stop("my-team", 42, db.id)
+client.datastores.start("my-team", 42, db.id)
+client.datastores.restart("my-team", 42, db.id)
+```
+
+### Domains & Volumes
+
+```python
+# Domains
+domain = client.domains.create("my-team", app_id=42, domain="app.example.com")
+client.domains.delete("my-team", 42, domain.id)
+
+# Volumes
+vol = client.volumes.create("my-team", app_id=42, name="data", container_path="/data")
+client.volumes.update("my-team", 42, vol.id, name="user-data")
+```
+
+### Cron Jobs
+
+```python
+cron = client.cron_jobs.create(
+    "my-team", app_id=42,
+    name="cleanup", schedule="0 2 * * *", command="python manage.py cleanup"
+)
+client.cron_jobs.update("my-team", 42, cron.id, is_disabled=True)
+```
+
+### Clusters & Servers
+
+```python
+# Create a cluster
+cluster = client.clusters.create("my-team", name="production")
+
+# Provision servers
+do_server = client.servers.create_digitalocean("my-team", name="web-1", region="nyc1", size="s-2vcpu-2gb")
+ec2_server = client.servers.create_ec2("my-team", name="worker-1", region="us-east-1", instance_type="t3.large")
+custom_server = client.servers.create_custom("my-team", name="bare-metal", host="203.0.113.1")
+```
+
+## CLI Usage
+
+### Authentication
+
+```bash
+appliku login --email you@example.com --password secret
+appliku whoami
+appliku logout
+```
+
+### Apps
+
+```bash
+appliku apps list --team my-team
+appliku apps create --team my-team --name web-app --branch main --git-url https://github.com/user/repo.git
+appliku apps deploy --team my-team --app 42
+appliku apps config --team my-team --app 42
+appliku apps set-config --team my-team --app 42 --var FOO=bar --var BAZ=qux
+```
+
+### Deployments
+
+```bash
+appliku deployments list --team my-team --app 42
+appliku deployments latest --team my-team --app 42
+appliku deployments logs --team my-team --app 42 --deployment 7 --stream
+```
+
+### Datastores
+
+```bash
+appliku datastores create --team my-team --app 42 --name primary-db --engine postgres --version 15
+appliku datastores start --team my-team --app 42 1
+appliku datastores stop --team my-team --app 42 1
+```
+
+### All commands support `--output json` for scripting:
+
+```bash
+appliku apps list --team my-team --output json
+```
+
+## CLI Reference
+
+| Command Group   | Subcommands                                      |
+|-----------------|--------------------------------------------------|
+| *(root)*        | `login`, `logout`, `whoami`                      |
+| `teams`         | `list`, `get`, `create`, `update`, `delete`      |
+| `apps`          | `list`, `get`, `create`, `update`, `delete`, `deploy`, `config`, `set-config` |
+| `deployments`   | `list`, `latest`, `logs`                         |
+| `datastores`    | `list`, `create`, `delete`, `start`, `stop`, `restart` |
+| `domains`       | `list`, `create`, `delete`                       |
+| `volumes`       | `list`, `create`, `update`, `delete`             |
+| `crons`         | `list`, `create`, `update`, `delete`             |
+| `clusters`      | `list`, `create`, `delete`                       |
+| `servers`       | `list`, `create-do`, `create-ec2`, `create-custom` |
+| `invites`       | `list`, `create`, `delete`, `accept`, `decline` |
+| `migrations`    | `list`, `run`, `logs`                            |
+
+## Error Handling
+
+The SDK raises typed exceptions so you can handle specific failure modes:
+
+```python
+from appliku import Appliku, NotFoundError, AuthenticationError, RateLimitError
+
+client = Appliku()
+
+try:
+    app = client.apps.get("my-team", app_id=999)
+except NotFoundError as e:
+    print(f"App not found: {e}")
+except AuthenticationError:
+    print("Invalid or expired token")
+except RateLimitError:
+    print("Too many requests — retried automatically")
+```
+
+Exception hierarchy:
+- `AplikuError` (base)
+  - `AuthenticationError` — 401
+  - `AuthorizationError` — 403
+  - `NotFoundError` — 404
+  - `ValidationError` — 400 (field-level errors)
+  - `RateLimitError` — 429 (auto-retried)
+  - `ServerError` — 5xx (auto-retried with backoff)
+
+## License
+
+MIT