intelion-cloud 0.2.0__tar.gz

intelion_cloud-0.2.0/LICENSE

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

intelion_cloud-0.2.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: intelion-cloud
+Version: 0.2.0
+Summary: Python client for the Intelion Cloud API
+Author-email: Intelion Cloud <support@intelion.cloud>
+License-Expression: MIT
+Project-URL: Homepage, https://intelion.cloud
+Project-URL: Documentation, https://intelion.cloud/swagger/
+Project-URL: Repository, https://github.com/IntelionCloud/ic_python_client
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: respx>=0.20; extra == "dev"
+Dynamic: license-file
+
+# Intelion Cloud Python Client
+
+[![PyPI](https://img.shields.io/pypi/v/intelion-cloud.svg)](https://pypi.org/project/intelion-cloud/)
+[![Python](https://img.shields.io/pypi/pyversions/intelion-cloud.svg)](https://pypi.org/project/intelion-cloud/)
+[![License](https://img.shields.io/pypi/l/intelion-cloud.svg)](https://github.com/IntelionCloud/ic_python_client/blob/main/LICENSE)
+
+Official Python SDK for the [Intelion Cloud](https://intelion.cloud) GPU cloud API (`/api/v2/`).
+
+Pure `httpx` — no Django dependency. Sync and async clients, typed dataclass models, automatic pagination, retries with exponential backoff.
+
+## Install
+
+```bash
+pip install intelion-cloud
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+from intelion_cloud import IntelionCloud
+
+client = IntelionCloud(token="your_api_token")
+
+# List your cloud servers
+for server in client.cloud_servers.list():
+    print(server.id, server.name, server.status)
+
+# Start / stop a server
+client.cloud_servers.start(server_id=42)
+client.cloud_servers.stop(server_id=42)
+
+# Create a new server
+new_server = client.cloud_servers.create(
+    name="my-h100-box",
+    flavor_id=1,          # FlavorConfig PK
+    ssd_count=100,        # network disk size, GB (min 30)
+    os_id=1,              # OperationalSystemImage PK
+    price_plan=0,         # 0 = hourly, 1 = monthly, ...
+)
+
+client.close()
+```
+
+### Async client
+
+```python
+import asyncio
+from intelion_cloud import AsyncIntelionCloud
+
+async def main():
+    async with AsyncIntelionCloud(token="your_api_token") as client:
+        me = await client.users.me()
+        print(me.username, me.current_balance_rub_cents)
+
+asyncio.run(main())
+```
+
+### Context manager
+
+```python
+with IntelionCloud(token="...") as client:
+    servers = client.cloud_servers.list()
+```
+
+## Available resources
+
+| Resource | Methods |
+|---|---|
+| `client.cloud_servers` | `list()`, `get()`, `create()`, `update()`, `start()`, `stop()`, `reboot()`, `delete()`, `get_status()`, `get_password()`, `clone()`, `migrate()` |
+| `client.flavors` | `list()` |
+| `client.os_images` | `list(flavor_id=, gpu_id=)` |
+| `client.users` | `me()`, `get()`, `update()` |
+
+## Authentication
+
+Get your API token from the [Intelion Cloud dashboard](https://intelion.cloud). The client sends it as `Authorization: Token {token}`.
+
+## Error handling
+
+```python
+from intelion_cloud import (
+    AuthenticationError, NotFoundError, ConflictError,
+    RateLimitError, ValidationError, ServerError,
+)
+
+try:
+    server = client.cloud_servers.get(999)
+except NotFoundError:
+    print("Server not found")
+except AuthenticationError:
+    print("Invalid token")
+except ValidationError as e:
+    print("Field errors:", e.field_errors)
+```
+
+## Links
+
+- **Homepage:** https://intelion.cloud
+- **API docs (Swagger):** https://intelion.cloud/api/
+- **Source:** https://github.com/IntelionCloud/ic_python_client
+
+## License
+
+MIT

intelion_cloud-0.2.0/README.md

@@ -0,0 +1,106 @@
+# Intelion Cloud Python Client
+
+[![PyPI](https://img.shields.io/pypi/v/intelion-cloud.svg)](https://pypi.org/project/intelion-cloud/)
+[![Python](https://img.shields.io/pypi/pyversions/intelion-cloud.svg)](https://pypi.org/project/intelion-cloud/)
+[![License](https://img.shields.io/pypi/l/intelion-cloud.svg)](https://github.com/IntelionCloud/ic_python_client/blob/main/LICENSE)
+
+Official Python SDK for the [Intelion Cloud](https://intelion.cloud) GPU cloud API (`/api/v2/`).
+
+Pure `httpx` — no Django dependency. Sync and async clients, typed dataclass models, automatic pagination, retries with exponential backoff.
+
+## Install
+
+```bash
+pip install intelion-cloud
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+from intelion_cloud import IntelionCloud
+
+client = IntelionCloud(token="your_api_token")
+
+# List your cloud servers
+for server in client.cloud_servers.list():
+    print(server.id, server.name, server.status)
+
+# Start / stop a server
+client.cloud_servers.start(server_id=42)
+client.cloud_servers.stop(server_id=42)
+
+# Create a new server
+new_server = client.cloud_servers.create(
+    name="my-h100-box",
+    flavor_id=1,          # FlavorConfig PK
+    ssd_count=100,        # network disk size, GB (min 30)
+    os_id=1,              # OperationalSystemImage PK
+    price_plan=0,         # 0 = hourly, 1 = monthly, ...
+)
+
+client.close()
+```
+
+### Async client
+
+```python
+import asyncio
+from intelion_cloud import AsyncIntelionCloud
+
+async def main():
+    async with AsyncIntelionCloud(token="your_api_token") as client:
+        me = await client.users.me()
+        print(me.username, me.current_balance_rub_cents)
+
+asyncio.run(main())
+```
+
+### Context manager
+
+```python
+with IntelionCloud(token="...") as client:
+    servers = client.cloud_servers.list()
+```
+
+## Available resources
+
+| Resource | Methods |
+|---|---|
+| `client.cloud_servers` | `list()`, `get()`, `create()`, `update()`, `start()`, `stop()`, `reboot()`, `delete()`, `get_status()`, `get_password()`, `clone()`, `migrate()` |
+| `client.flavors` | `list()` |
+| `client.os_images` | `list(flavor_id=, gpu_id=)` |
+| `client.users` | `me()`, `get()`, `update()` |
+
+## Authentication
+
+Get your API token from the [Intelion Cloud dashboard](https://intelion.cloud). The client sends it as `Authorization: Token {token}`.
+
+## Error handling
+
+```python
+from intelion_cloud import (
+    AuthenticationError, NotFoundError, ConflictError,
+    RateLimitError, ValidationError, ServerError,
+)
+
+try:
+    server = client.cloud_servers.get(999)
+except NotFoundError:
+    print("Server not found")
+except AuthenticationError:
+    print("Invalid token")
+except ValidationError as e:
+    print("Field errors:", e.field_errors)
+```
+
+## Links
+
+- **Homepage:** https://intelion.cloud
+- **API docs (Swagger):** https://intelion.cloud/api/
+- **Source:** https://github.com/IntelionCloud/ic_python_client
+
+## License
+
+MIT

intelion_cloud-0.2.0/intelion_cloud/__init__.py

@@ -0,0 +1,82 @@
+"""Intelion Cloud Python client.
+
+Usage::
+
+    from intelion_cloud import IntelionCloud
+
+    client = IntelionCloud(token="your_api_token")
+    servers = client.cloud_servers.list()
+"""
+
+from ._client import AsyncIntelionCloud, IntelionCloud
+from .constants import BillingPeriod, PricePlan, ServerState
+from .constants import ServerStatus as ServerStatusEnum
+from .exceptions import (
+    APIError,
+    AuthenticationError,
+    ConflictError,
+    ConnectionError,
+    ForbiddenError,
+    IntelionCloudError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    ValidationError,
+)
+from .models import (
+    CPU,
+    GPU,
+    OSImage,
+    RAM,
+    SSD,
+    CloudServer,
+    DebtInfo,
+    Flavor,
+    PhysicalServer,
+    Promocode,
+    ServerStatus,
+    SoftwareAddonInstance,
+    UsageAct,
+    User,
+    WhiteIP,
+)
+
+__version__ = "0.2.0"
+
+__all__ = [
+    # Clients
+    "IntelionCloud",
+    "AsyncIntelionCloud",
+    # Models
+    "CloudServer",
+    "ServerStatus",
+    "Flavor",
+    "User",
+    "GPU",
+    "CPU",
+    "RAM",
+    "SSD",
+    "OSImage",
+    "UsageAct",
+    "DebtInfo",
+    "Promocode",
+    "WhiteIP",
+    "PhysicalServer",
+    "SoftwareAddonInstance",
+    # Constants
+    "ServerStatusEnum",
+    "ServerState",
+    "PricePlan",
+    "BillingPeriod",
+    # Exceptions
+    "IntelionCloudError",
+    "APIError",
+    "AuthenticationError",
+    "ForbiddenError",
+    "NotFoundError",
+    "ConflictError",
+    "RateLimitError",
+    "ValidationError",
+    "ServerError",
+    "ConnectionError",
+]

intelion_cloud-0.2.0/intelion_cloud/_client.py

@@ -0,0 +1,108 @@
+"""Main client classes: IntelionCloud (sync) and AsyncIntelionCloud (async)."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .constants import DEFAULT_BASE_URL, DEFAULT_CONNECT_TIMEOUT, DEFAULT_TIMEOUT
+from ._transport import AsyncTransport, SyncTransport
+from .resources.cloud_servers import AsyncCloudServers, CloudServers
+from .resources.flavors import AsyncFlavors, Flavors
+from .resources.os_images import AsyncOSImages, OSImages
+from .resources.users import AsyncUsers, Users
+
+
+class IntelionCloud:
+    """Synchronous client for the Intelion Cloud API.
+
+    Usage::
+
+        client = IntelionCloud(token="your_api_token")
+        servers = client.cloud_servers.list()
+        client.close()
+
+    Or as a context manager::
+
+        with IntelionCloud(token="your_api_token") as client:
+            servers = client.cloud_servers.list()
+
+    Args:
+        token: API authentication token (``Authorization: Token <token>``).
+        base_url: Base URL of the Intelion Cloud instance.
+        timeout: Overall request timeout in seconds.
+        connect_timeout: Connection establishment timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = DEFAULT_TIMEOUT,
+        connect_timeout: float = DEFAULT_CONNECT_TIMEOUT,
+    ) -> None:
+        self._transport = SyncTransport(
+            token=token,
+            base_url=base_url,
+            timeout=timeout,
+            connect_timeout=connect_timeout,
+        )
+        self.cloud_servers = CloudServers(self._transport)
+        self.flavors = Flavors(self._transport)
+        self.os_images = OSImages(self._transport)
+        self.users = Users(self._transport)
+
+    def close(self) -> None:
+        """Close the underlying HTTP connection pool."""
+        self._transport.close()
+
+    def __enter__(self) -> IntelionCloud:
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+
+class AsyncIntelionCloud:
+    """Asynchronous client for the Intelion Cloud API.
+
+    Usage::
+
+        async with AsyncIntelionCloud(token="your_api_token") as client:
+            servers = await client.cloud_servers.list()
+
+    Args:
+        token: API authentication token (``Authorization: Token <token>``).
+        base_url: Base URL of the Intelion Cloud instance.
+        timeout: Overall request timeout in seconds.
+        connect_timeout: Connection establishment timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = DEFAULT_TIMEOUT,
+        connect_timeout: float = DEFAULT_CONNECT_TIMEOUT,
+    ) -> None:
+        self._transport = AsyncTransport(
+            token=token,
+            base_url=base_url,
+            timeout=timeout,
+            connect_timeout=connect_timeout,
+        )
+        self.cloud_servers = AsyncCloudServers(self._transport)
+        self.flavors = AsyncFlavors(self._transport)
+        self.os_images = AsyncOSImages(self._transport)
+        self.users = AsyncUsers(self._transport)
+
+    async def close(self) -> None:
+        """Close the underlying async HTTP connection pool."""
+        await self._transport.close()
+
+    async def __aenter__(self) -> AsyncIntelionCloud:
+        return self
+
+    async def __aexit__(self, *args: object) -> None:
+        await self.close()

intelion_cloud-0.2.0/intelion_cloud/_pagination.py

@@ -0,0 +1,66 @@
+"""Pagination helpers for DRF paginated responses."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Dict, Generic, List, Optional, Tuple, TypeVar
+from urllib.parse import parse_qs, urlparse
+
+T = TypeVar("T")
+
+
+@dataclass
+class PaginatedResponse(Generic[T]):
+    """A single page of results from the API."""
+
+    count: int
+    results: List[T]
+    next_url: Optional[str] = None
+    previous_url: Optional[str] = None
+
+    @property
+    def has_next(self) -> bool:
+        return self.next_url is not None
+
+
+def parse_paginated(data: Dict[str, Any]) -> Dict[str, Any]:
+    """Extract pagination metadata from a DRF response.
+
+    Returns dict with 'count', 'next', 'previous', 'results'.
+    If the response is not paginated (plain list), wraps it.
+    """
+    if isinstance(data, list):
+        return {"count": len(data), "next": None, "previous": None, "results": data}
+    return {
+        "count": data.get("count", 0),
+        "next": data.get("next"),
+        "previous": data.get("previous"),
+        "results": data.get("results", []),
+    }
+
+
+def extract_next_page(url: Optional[str]) -> Optional[Tuple[str, Dict[str, str]]]:
+    """Convert an absolute next/previous URL to (path, params) for the transport.
+
+    Returns None if URL is None, otherwise (relative_path, query_params).
+
+    Example:
+        'https://intelion.cloud/api/v2/flavors/?page=2'
+        -> ('flavors/', {'page': '2'})
+    """
+    if url is None:
+        return None
+
+    parsed = urlparse(url)
+
+    # Extract relative path after /api/v2/
+    path = parsed.path
+    marker = "/api/v2/"
+    idx = path.find(marker)
+    if idx >= 0:
+        path = path[idx + len(marker) :]
+
+    # Parse query string into flat dict (take first value of each key)
+    params = {k: v[0] for k, v in parse_qs(parsed.query).items()}
+
+    return path, params