cubepath-sdk 0.1.0__tar.gz

cubepath_sdk-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install ruff mypy httpx
+
+      - name: Ruff check
+        run: ruff check cubepath/
+
+      - name: Ruff format check
+        run: ruff format --check cubepath/
+
+      - name: Type check
+        run: mypy cubepath/ --ignore-missing-imports
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        run: python -m pytest tests/ -v
+        if: hashFiles('tests/') != ''
+
+      - name: Verify import
+        run: python -c "import cubepath; print(cubepath.__version__)"
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

cubepath_sdk-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    runs-on: ubuntu-latest
+    needs: build
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*

cubepath_sdk-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/

cubepath_sdk-0.1.0/LICENSE

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

cubepath_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: cubepath-sdk
+Version: 0.1.0
+Summary: CubePath Cloud API Python SDK
+Project-URL: Homepage, https://github.com/CubePathInc/cubepath-python-sdk
+Project-URL: Documentation, https://github.com/CubePathInc/cubepath-python-sdk
+Project-URL: Repository, https://github.com/CubePathInc/cubepath-python-sdk
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+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: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# CubePath Python SDK
+
+Official Python SDK for the [CubePath Cloud API](https://api.cubepath.com).
+
+## Installation
+
+```bash
+pip install cubepath
+```
+
+## Quick Start
+
+```python
+import cubepath
+
+client = cubepath.CubePathClient(api_token="your-api-token")
+
+# List projects
+projects = client.projects.list()
+for p in projects:
+    print(p.project.name)
+
+# Create a VPS
+from cubepath.models import CreateVPSRequest
+
+req = CreateVPSRequest(
+    name="my-vps",
+    plan_name="gp.nano",
+    template_name="debian-12",
+    location_name="us-mia-1",
+    ssh_key_names=["my-key"],
+)
+task = client.vps.create(project_id="proj-123", req=req)
+print(f"Task: {task.task_id}")
+```
+
+## Services
+
+| Service | Access | Description |
+|---------|--------|-------------|
+| Projects | `client.projects` | Manage projects |
+| SSH Keys | `client.ssh_keys` | Manage SSH keys |
+| VPS | `client.vps` | Virtual private servers |
+| VPS Backups | `client.vps.backups()` | VPS backup management |
+| VPS ISOs | `client.vps.isos()` | ISO mount/unmount |
+| Baremetal | `client.baremetal` | Bare metal servers |
+| Networks | `client.networks` | Private networks |
+| Floating IPs | `client.floating_ips` | Floating IP addresses |
+| Firewall | `client.firewall` | Firewall groups & rules |
+| DNS | `client.dns` | DNS zones & records |
+| Load Balancer | `client.load_balancer` | Load balancers, listeners, targets |
+| CDN | `client.cdn` | CDN zones, origins, rules, WAF |
+| Kubernetes | `client.kubernetes` | K8s clusters, node pools, addons |
+| Pricing | `client.pricing` | Pricing information |
+| DDoS | `client.ddos` | DDoS attack reports |
+
+## Configuration
+
+```python
+client = cubepath.CubePathClient(
+    api_token="your-api-token",
+    base_url="https://api.cubepath.com",   # default
+    timeout=30.0,                           # seconds
+    max_retries=3,                          # retry on 429/5xx
+    retry_wait_min=1.0,                     # min backoff seconds
+    retry_wait_max=30.0,                    # max backoff seconds
+    rate_limit_interval=0.1,                # 10 req/s
+)
+```
+
+## Context Manager
+
+```python
+with cubepath.CubePathClient(api_token="tok") as client:
+    zones = client.dns.list_zones()
+```
+
+## Error Handling
+
+```python
+from cubepath import APIError, is_not_found
+
+try:
+    project = client.projects.get("nonexistent")
+except APIError as e:
+    if e.is_not_found():
+        print("Project not found")
+    elif e.is_rate_limited():
+        print("Rate limited, try again later")
+    else:
+        print(f"API error: {e}")
+```
+
+## Requirements
+
+- Python >= 3.10
+- httpx >= 0.27
+
+## Examples
+
+### Deploy a Baremetal Server
+
+```python
+from cubepath.models import CreateBaremetalRequest
+
+req = CreateBaremetalRequest(
+    model_name="c1.metal.plus",
+    location_name="us-mia-1",
+    hostname="db-server",
+    password="SecurePass123!",
+    os_name="debian-12",
+    ssh_key_names=["my-key"],
+)
+task = client.baremetal.deploy(project_id="proj-123", req=req)
+```
+
+### Create a Load Balancer
+
+```python
+from cubepath.models import CreateLoadBalancerRequest, CreateListenerRequest
+
+lb = client.load_balancer.create(CreateLoadBalancerRequest(
+    name="web-lb",
+    plan_name="lb.small",
+    location_name="us-mia-1",
+))
+
+client.load_balancer.create_listener(lb.uuid, CreateListenerRequest(
+    name="http",
+    protocol="http",
+    source_port=80,
+    target_port=8080,
+    algorithm="round_robin",
+))
+```
+
+### Create a CDN Zone
+
+```python
+from cubepath.models import CreateCDNZoneRequest, CreateCDNOriginRequest
+
+zone = client.cdn.create_zone(CreateCDNZoneRequest(
+    name="my-site",
+    plan_name="cdn.starter",
+    custom_domain="cdn.example.com",
+))
+
+client.cdn.create_origin(zone.uuid, CreateCDNOriginRequest(
+    name="primary-origin",
+    address="origin.example.com",
+    port=443,
+    protocol="https",
+    weight=100,
+    priority=1,
+    health_check_path="/health",
+))
+```
+
+### DNS Management
+
+```python
+from cubepath.models import CreateDNSZoneRequest, CreateDNSRecordRequest
+
+zone = client.dns.create_zone(CreateDNSZoneRequest(domain="example.com"))
+
+client.dns.create_record(zone.uuid, CreateDNSRecordRequest(
+    name="@",
+    record_type="A",
+    content="203.0.113.10",
+    ttl=3600,
+))
+```

cubepath_sdk-0.1.0/README.md

@@ -0,0 +1,172 @@
+# CubePath Python SDK
+
+Official Python SDK for the [CubePath Cloud API](https://api.cubepath.com).
+
+## Installation
+
+```bash
+pip install cubepath
+```
+
+## Quick Start
+
+```python
+import cubepath
+
+client = cubepath.CubePathClient(api_token="your-api-token")
+
+# List projects
+projects = client.projects.list()
+for p in projects:
+    print(p.project.name)
+
+# Create a VPS
+from cubepath.models import CreateVPSRequest
+
+req = CreateVPSRequest(
+    name="my-vps",
+    plan_name="gp.nano",
+    template_name="debian-12",
+    location_name="us-mia-1",
+    ssh_key_names=["my-key"],
+)
+task = client.vps.create(project_id="proj-123", req=req)
+print(f"Task: {task.task_id}")
+```
+
+## Services
+
+| Service | Access | Description |
+|---------|--------|-------------|
+| Projects | `client.projects` | Manage projects |
+| SSH Keys | `client.ssh_keys` | Manage SSH keys |
+| VPS | `client.vps` | Virtual private servers |
+| VPS Backups | `client.vps.backups()` | VPS backup management |
+| VPS ISOs | `client.vps.isos()` | ISO mount/unmount |
+| Baremetal | `client.baremetal` | Bare metal servers |
+| Networks | `client.networks` | Private networks |
+| Floating IPs | `client.floating_ips` | Floating IP addresses |
+| Firewall | `client.firewall` | Firewall groups & rules |
+| DNS | `client.dns` | DNS zones & records |
+| Load Balancer | `client.load_balancer` | Load balancers, listeners, targets |
+| CDN | `client.cdn` | CDN zones, origins, rules, WAF |
+| Kubernetes | `client.kubernetes` | K8s clusters, node pools, addons |
+| Pricing | `client.pricing` | Pricing information |
+| DDoS | `client.ddos` | DDoS attack reports |
+
+## Configuration
+
+```python
+client = cubepath.CubePathClient(
+    api_token="your-api-token",
+    base_url="https://api.cubepath.com",   # default
+    timeout=30.0,                           # seconds
+    max_retries=3,                          # retry on 429/5xx
+    retry_wait_min=1.0,                     # min backoff seconds
+    retry_wait_max=30.0,                    # max backoff seconds
+    rate_limit_interval=0.1,                # 10 req/s
+)
+```
+
+## Context Manager
+
+```python
+with cubepath.CubePathClient(api_token="tok") as client:
+    zones = client.dns.list_zones()
+```
+
+## Error Handling
+
+```python
+from cubepath import APIError, is_not_found
+
+try:
+    project = client.projects.get("nonexistent")
+except APIError as e:
+    if e.is_not_found():
+        print("Project not found")
+    elif e.is_rate_limited():
+        print("Rate limited, try again later")
+    else:
+        print(f"API error: {e}")
+```
+
+## Requirements
+
+- Python >= 3.10
+- httpx >= 0.27
+
+## Examples
+
+### Deploy a Baremetal Server
+
+```python
+from cubepath.models import CreateBaremetalRequest
+
+req = CreateBaremetalRequest(
+    model_name="c1.metal.plus",
+    location_name="us-mia-1",
+    hostname="db-server",
+    password="SecurePass123!",
+    os_name="debian-12",
+    ssh_key_names=["my-key"],
+)
+task = client.baremetal.deploy(project_id="proj-123", req=req)
+```
+
+### Create a Load Balancer
+
+```python
+from cubepath.models import CreateLoadBalancerRequest, CreateListenerRequest
+
+lb = client.load_balancer.create(CreateLoadBalancerRequest(
+    name="web-lb",
+    plan_name="lb.small",
+    location_name="us-mia-1",
+))
+
+client.load_balancer.create_listener(lb.uuid, CreateListenerRequest(
+    name="http",
+    protocol="http",
+    source_port=80,
+    target_port=8080,
+    algorithm="round_robin",
+))
+```
+
+### Create a CDN Zone
+
+```python
+from cubepath.models import CreateCDNZoneRequest, CreateCDNOriginRequest
+
+zone = client.cdn.create_zone(CreateCDNZoneRequest(
+    name="my-site",
+    plan_name="cdn.starter",
+    custom_domain="cdn.example.com",
+))
+
+client.cdn.create_origin(zone.uuid, CreateCDNOriginRequest(
+    name="primary-origin",
+    address="origin.example.com",
+    port=443,
+    protocol="https",
+    weight=100,
+    priority=1,
+    health_check_path="/health",
+))
+```
+
+### DNS Management
+
+```python
+from cubepath.models import CreateDNSZoneRequest, CreateDNSRecordRequest
+
+zone = client.dns.create_zone(CreateDNSZoneRequest(domain="example.com"))
+
+client.dns.create_record(zone.uuid, CreateDNSRecordRequest(
+    name="@",
+    record_type="A",
+    content="203.0.113.10",
+    ttl=3600,
+))
+```

cubepath_sdk-0.1.0/cubepath/__init__.py

@@ -0,0 +1,15 @@
+"""CubePath Cloud API Python SDK."""
+
+from cubepath.client import CubePathClient
+from cubepath.exceptions import APIError, is_bad_request, is_conflict, is_not_found, is_rate_limited
+
+__all__ = [
+    "CubePathClient",
+    "APIError",
+    "is_not_found",
+    "is_conflict",
+    "is_rate_limited",
+    "is_bad_request",
+]
+
+__version__ = "0.1.0"