sdkrouter 0.1.1__py3-none-any.whl

sdkrouter/_api/generated/keys/__init__.py

@@ -0,0 +1,212 @@
+# Auto-generated by DjangoCFG - see CLAUDE.md
+"""
+SDKRouter API - API Client with JWT Management
+
+Usage:
+    >>> from api import API
+    >>>
+    >>> api = API('https://api.example.com')
+    >>>
+    >>> # Set JWT token
+    >>> api.set_token('your-jwt-token', 'refresh-token')
+    >>>
+    >>> # Use API
+    >>> async with api:
+    ...     posts = await api.posts.list()
+    ...     user = await api.users.retrieve(1)
+    >>>
+    >>> # Check authentication
+    >>> if api.is_authenticated():
+    ...     # ...
+    >>>
+    >>> # Get OpenAPI schema path
+    >>> schema_path = api.get_schema_path()
+"""
+
+from __future__ import annotations
+
+import threading
+from typing import Any
+
+import httpx
+
+from .client import APIClient
+from .logger import LoggerConfig
+from .retry import RetryConfig
+from .keys__api__keys import KeysKeysAPI
+from . import enums
+# NOTE: Individual enum imports commented out due to invalid Python syntax with dotted names
+# from .enums import APIKeyCreate.permission, APIKeyCreateRequest.permission, APIKeyDetail.permission, APIKeyList.permission
+
+TOKEN_KEY = "auth_token"
+REFRESH_TOKEN_KEY = "refresh_token"
+
+# Auto-generated by DjangoCFG - see CLAUDE.md
+class API:
+    """
+    API Client wrapper with JWT token management.
+
+    This class provides:
+    - Thread-safe JWT token storage
+    - Automatic Authorization header injection
+    - Context manager support for async operations
+    - Optional retry and logging configuration
+
+    Example:
+        >>> api = API('https://api.example.com')
+        >>> api.set_token('jwt-token')
+        >>> async with api:
+        ...     users = await api.users.list()
+        >>>
+        >>> # With retry and logging
+        >>> api = API(
+        ...     'https://api.example.com',
+        ...     retry_config=RetryConfig(max_attempts=5),
+        ...     logger_config=LoggerConfig(enabled=True)
+        ... )
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        logger_config: LoggerConfig | None = None,
+        retry_config: RetryConfig | None = None,
+        **kwargs: Any
+    ):
+        """
+        Initialize API client.
+
+        Args:
+            base_url: Base API URL (e.g., 'https://api.example.com')
+            logger_config: Logger configuration (None to disable logging)
+            retry_config: Retry configuration (None to disable retry)
+            **kwargs: Additional httpx.AsyncClient kwargs
+        """
+        self.base_url = base_url.rstrip('/')
+        self._kwargs = kwargs
+        self._logger_config = logger_config
+        self._retry_config = retry_config
+        self._token: str | None = None
+        self._refresh_token: str | None = None
+        self._lock = threading.Lock()
+        self._client: APIClient | None = None
+        self._init_clients()
+
+    def _init_clients(self) -> None:
+        """Initialize API client with current token."""
+        # Create httpx client with auth header if token exists
+        headers = {}
+        if self._token:
+            headers['Authorization'] = f'Bearer {self._token}'
+
+        kwargs = {**self._kwargs}
+        if headers:
+            kwargs['headers'] = headers
+
+        # Create new APIClient
+        self._client = APIClient(
+            self.base_url,
+            logger_config=self._logger_config,
+            retry_config=self._retry_config,
+            **kwargs
+        )
+
+    @property
+    def keys_keys(self) -> KeysKeysAPI:
+        """Access keys endpoints."""
+        return self._client.keys_keys
+
+    def get_token(self) -> str | None:
+        """Get current JWT token."""
+        with self._lock:
+            return self._token
+
+    def get_refresh_token(self) -> str | None:
+        """Get current refresh token."""
+        with self._lock:
+            return self._refresh_token
+
+    def set_token(self, token: str, refresh_token: str | None = None) -> None:
+        """
+        Set JWT token and refresh token.
+
+        Args:
+            token: JWT access token
+            refresh_token: JWT refresh token (optional)
+        """
+        with self._lock:
+            self._token = token
+            if refresh_token:
+                self._refresh_token = refresh_token
+
+        # Reinitialize clients with new token
+        self._init_clients()
+
+    def clear_tokens(self) -> None:
+        """Clear all tokens."""
+        with self._lock:
+            self._token = None
+            self._refresh_token = None
+
+        # Reinitialize clients without token
+        self._init_clients()
+
+    def is_authenticated(self) -> bool:
+        """Check if user is authenticated."""
+        return self.get_token() is not None
+
+    def set_base_url(self, url: str) -> None:
+        """
+        Update base URL and reinitialize clients.
+
+        Args:
+            url: New base URL
+        """
+        self.base_url = url.rstrip('/')
+        self._init_clients()
+
+    def get_base_url(self) -> str:
+        """Get current base URL."""
+        return self.base_url
+
+    def get_schema_path(self) -> str:
+        """
+        Get OpenAPI schema path.
+
+        Returns:
+            Path to the OpenAPI schema JSON file
+
+        Note:
+            The OpenAPI schema is available in the schema.json file.
+            You can load it dynamically using:
+            ```python
+            import json
+            from pathlib import Path
+
+            schema_path = Path(__file__).parent / 'schema.json'
+            with open(schema_path) as f:
+                schema = json.load(f)
+            ```
+        """
+        return './schema.json'
+
+    async def __aenter__(self) -> 'API':
+        """Async context manager entry."""
+        if self._client:
+            await self._client.__aenter__()
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        """Async context manager exit."""
+        if self._client:
+            await self._client.__aexit__(*args)
+
+    async def close(self) -> None:
+        """Close HTTP client."""
+        if self._client:
+            await self._client.close()
+
+__all__ = [
+    "API",
+    "APIClient",
+]

sdkrouter/_api/generated/keys/client.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+from .keys__api__keys import KeysKeysAPI
+from .logger import APILogger, LoggerConfig
+from .retry import RetryConfig, RetryAsyncClient
+
+
+class APIClient:
+    """
+    Async API client for SDKRouter API.
+
+    Usage:
+        >>> async with APIClient(base_url='https://api.example.com') as client:
+        ...     users = await client.users.list()
+        ...     post = await client.posts.create(data=new_post)
+        >>>
+        >>> # With retry configuration
+        >>> retry_config = RetryConfig(max_attempts=5, min_wait=2.0)
+        >>> async with APIClient(base_url='https://api.example.com', retry_config=retry_config) as client:
+        ...     users = await client.users.list()
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        logger_config: Optional[LoggerConfig] = None,
+        retry_config: Optional[RetryConfig] = None,
+        **kwargs: Any,
+    ):
+        """
+        Initialize API client.
+
+        Args:
+            base_url: Base API URL (e.g., 'https://api.example.com')
+            logger_config: Logger configuration (None to disable logging)
+            retry_config: Retry configuration (None to disable retry)
+            **kwargs: Additional httpx.AsyncClient kwargs
+        """
+        self.base_url = base_url.rstrip('/')
+
+        # Create HTTP client with or without retry
+        if retry_config is not None:
+            self._client = RetryAsyncClient(
+                base_url=self.base_url,
+                retry_config=retry_config,
+                **kwargs,
+            )
+        else:
+            self._client = httpx.AsyncClient(
+                base_url=self.base_url,
+                **kwargs,
+            )
+
+        # Initialize logger
+        self.logger: Optional[APILogger] = None
+        if logger_config is not None:
+            self.logger = APILogger(logger_config)
+
+        # Initialize sub-clients
+        self.keys_keys = KeysKeysAPI(self._client)
+
+    async def __aenter__(self) -> 'APIClient':
+        await self._client.__aenter__()
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        await self._client.__aexit__(*args)
+
+    async def close(self) -> None:
+        """Close HTTP client."""
+        await self._client.aclose()

sdkrouter/_api/generated/keys/enums.py

@@ -0,0 +1,64 @@
+# Auto-generated by DjangoCFG - see CLAUDE.md
+from enum import IntEnum, Enum
+
+# Python 3.10 compatibility: StrEnum was added in Python 3.11
+# Use str + Enum instead for backward compatibility
+class StrEnum(str, Enum):
+    """String Enum for Python 3.10+ compatibility"""
+    pass
+
+
+class APIKeyCreatePermission(StrEnum):
+    """
+    * `read` - Read Only
+    * `write` - Read & Write
+    * `admin` - Admin
+    """
+
+    READ = "read"
+    WRITE = "write"
+    ADMIN = "admin"
+
+
+
+class APIKeyCreateRequestPermission(StrEnum):
+    """
+    * `read` - Read Only
+    * `write` - Read & Write
+    * `admin` - Admin
+    """
+
+    READ = "read"
+    WRITE = "write"
+    ADMIN = "admin"
+
+
+
+class APIKeyDetailPermission(StrEnum):
+    """
+    Permission level for this key
+    * `read` - Read Only
+    * `write` - Read & Write
+    * `admin` - Admin
+    """
+
+    READ = "read"
+    WRITE = "write"
+    ADMIN = "admin"
+
+
+
+class APIKeyListPermission(StrEnum):
+    """
+    Permission level for this key
+    * `read` - Read Only
+    * `write` - Read & Write
+    * `admin` - Admin
+    """
+
+    READ = "read"
+    WRITE = "write"
+    ADMIN = "admin"
+
+
+

sdkrouter/_api/generated/keys/keys__api__keys/__init__.py

@@ -0,0 +1,7 @@
+# Auto-generated by DjangoCFG - see CLAUDE.md
+from .client import KeysKeysAPI
+from .models import *
+
+__all__ = [
+    "KeysKeysAPI",
+]

sdkrouter/_api/generated/keys/keys__api__keys/client.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class KeysKeysAPI:
+    """API endpoints for Keys."""
+
+    def __init__(self, client: httpx.AsyncClient):
+        """Initialize sub-client with shared httpx client."""
+        self._client = client
+
+    async def list(self, page: int | None = None, page_size: int | None = None) -> list[PaginatedAPIKeyListList]:
+        """
+        ViewSet for API key management. Endpoints: - GET /api/keys/ - List
+        user's API keys - POST /api/keys/ - Create a new API key - GET
+        /api/keys/{id}/ - Get API key details - DELETE /api/keys/{id}/ -
+        Deactivate API key - POST /api/keys/{id}/rotate/ - Rotate API key - POST
+        /api/keys/{id}/reactivate/ - Reactivate API key
+        """
+        url = "/api/keys/"
+        response = await self._client.get(url, params={"page": page if page is not None else None, "page_size": page_size if page_size is not None else None})
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return PaginatedAPIKeyListList.model_validate(response.json())
+
+
+    async def create(self, data: APIKeyCreateRequest) -> APIKeyCreate:
+        """
+        Create a new API key.
+        """
+        url = "/api/keys/"
+        response = await self._client.post(url, json=data.model_dump(exclude_unset=True))
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyCreate.model_validate(response.json())
+
+
+    async def retrieve(self, id: str) -> APIKeyDetail:
+        """
+        ViewSet for API key management. Endpoints: - GET /api/keys/ - List
+        user's API keys - POST /api/keys/ - Create a new API key - GET
+        /api/keys/{id}/ - Get API key details - DELETE /api/keys/{id}/ -
+        Deactivate API key - POST /api/keys/{id}/rotate/ - Rotate API key - POST
+        /api/keys/{id}/reactivate/ - Reactivate API key
+        """
+        url = f"/api/keys/{id}/"
+        response = await self._client.get(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyDetail.model_validate(response.json())
+
+
+    async def update(self, id: str) -> APIKeyList:
+        """
+        ViewSet for API key management. Endpoints: - GET /api/keys/ - List
+        user's API keys - POST /api/keys/ - Create a new API key - GET
+        /api/keys/{id}/ - Get API key details - DELETE /api/keys/{id}/ -
+        Deactivate API key - POST /api/keys/{id}/rotate/ - Rotate API key - POST
+        /api/keys/{id}/reactivate/ - Reactivate API key
+        """
+        url = f"/api/keys/{id}/"
+        response = await self._client.put(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyList.model_validate(response.json())
+
+
+    async def partial_update(self, id: str) -> APIKeyList:
+        """
+        ViewSet for API key management. Endpoints: - GET /api/keys/ - List
+        user's API keys - POST /api/keys/ - Create a new API key - GET
+        /api/keys/{id}/ - Get API key details - DELETE /api/keys/{id}/ -
+        Deactivate API key - POST /api/keys/{id}/rotate/ - Rotate API key - POST
+        /api/keys/{id}/reactivate/ - Reactivate API key
+        """
+        url = f"/api/keys/{id}/"
+        response = await self._client.patch(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyList.model_validate(response.json())
+
+
+    async def destroy(self, id: str) -> None:
+        """
+        Deactivate an API key (soft delete).
+        """
+        url = f"/api/keys/{id}/"
+        response = await self._client.delete(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return None
+
+
+    async def reactivate_create(self, id: str) -> APIKeyList:
+        """
+        Reactivate a deactivated API key.
+        """
+        url = f"/api/keys/{id}/reactivate/"
+        response = await self._client.post(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyList.model_validate(response.json())
+
+
+    async def rotate_create(self, id: str) -> APIKeyList:
+        """
+        Rotate an API key (generate new key).
+        """
+        url = f"/api/keys/{id}/rotate/"
+        response = await self._client.post(url)
+        if not response.is_success:
+            try:
+                error_body = response.json()
+            except Exception:
+                error_body = response.text
+            raise httpx.HTTPStatusError(f"{response.status_code}: {error_body}", request=response.request, response=response)
+        return APIKeyList.model_validate(response.json())
+
+

sdkrouter/_api/generated/keys/keys__api__keys/models.py

@@ -0,0 +1,152 @@
+# Auto-generated by DjangoCFG - see CLAUDE.md
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from ..enums import APIKeyCreatePermission, APIKeyCreateRequestPermission, APIKeyDetailPermission, APIKeyListPermission
+
+
+class APIKeyList(BaseModel):
+    """
+    Serializer for listing API keys (no sensitive data).
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    id: Any = ...
+    name: Any = Field(description='Human-readable name for the key')
+    key_prefix: Any = Field(description="Visible prefix for identification (e.g., 'sk_live_abc...')")
+    permission: APIKeyListPermission = Field(description='Permission level for this key\n\n* `read` - Read Only\n* `write` - Read & Write\n* `admin` - Admin')
+    is_active: bool = Field(description='Whether this key can be used')
+    is_expired: bool = ...
+    is_valid: bool = ...
+    is_quota_exceeded: bool = ...
+    rate_limit_rpm: int | None = Field(None, description='Max requests per minute (null = unlimited)')
+    rate_limit_rpd: int | None = Field(None, description='Max requests per day (null = unlimited)')
+    quota_monthly_usd: Any | None = Field(None, description='Monthly spending limit in USD (null = unlimited)', pattern='^-?\\d{0,8}(?:\\.\\d{0,2})?$')
+    quota_used_usd: Any = Field(description='Amount spent this month in USD', pattern='^-?\\d{0,4}(?:\\.\\d{0,6})?$')
+    last_used_at: Any | None = Field(None, description='Last time this key was used')
+    total_requests: int = Field(description='Total number of requests made with this key')
+    total_cost_usd: Any = Field(description='Total cost of all requests in USD', pattern='^-?\\d{0,6}(?:\\.\\d{0,6})?$')
+    expires_at: Any | None = Field(None, description='When this key expires (null = never)')
+    created_at: Any = ...
+    updated_at: Any = ...
+
+
+
+class PaginatedAPIKeyListList(BaseModel):
+    """
+    
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    count: int = Field(description='Total number of items across all pages')
+    page: int = Field(description='Current page number (1-based)')
+    pages: int = Field(description='Total number of pages')
+    page_size: int = Field(description='Number of items per page')
+    has_next: bool = Field(description='Whether there is a next page')
+    has_previous: bool = Field(description='Whether there is a previous page')
+    next_page: int | None = Field(None, description='Next page number (null if no next page)')
+    previous_page: int | None = Field(None, description='Previous page number (null if no previous page)')
+    results: list[APIKeyList] = Field(description='Array of items for current page')
+
+
+
+class APIKeyCreateRequest(BaseModel):
+    """
+    Serializer for creating new API keys.
+
+    Request model (no read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    name: str = Field(min_length=1, max_length=100)
+    permission: APIKeyCreateRequestPermission | None = Field(None, description='* `read` - Read Only\n* `write` - Read & Write\n* `admin` - Admin')
+    rate_limit_rpm: int | None = Field(None, ge=1)
+    rate_limit_rpd: int | None = Field(None, ge=1)
+    quota_monthly_usd: str | None = Field(None, pattern='^-?\\d{0,8}(?:\\.\\d{0,2})?$')
+    expires_at: str | None = None
+    metadata: dict[str, Any] | None = None
+    is_test: bool | None = None
+
+
+
+class APIKeyCreate(BaseModel):
+    """
+    Serializer for creating new API keys.
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    name: str = Field(max_length=100)
+    permission: APIKeyCreatePermission | None = Field(None, description='* `read` - Read Only\n* `write` - Read & Write\n* `admin` - Admin')
+    rate_limit_rpm: int | None = Field(None, ge=1)
+    rate_limit_rpd: int | None = Field(None, ge=1)
+    quota_monthly_usd: str | None = Field(None, pattern='^-?\\d{0,8}(?:\\.\\d{0,2})?$')
+    expires_at: str | None = None
+    metadata: dict[str, Any] | None = None
+    is_test: bool | None = None
+
+
+
+class APIKeyDetail(BaseModel):
+    """
+    Serializer for API key details.
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    id: Any = ...
+    name: Any = Field(description='Human-readable name for the key')
+    key_prefix: Any = Field(description="Visible prefix for identification (e.g., 'sk_live_abc...')")
+    permission: APIKeyDetailPermission = Field(description='Permission level for this key\n\n* `read` - Read Only\n* `write` - Read & Write\n* `admin` - Admin')
+    is_active: bool = Field(description='Whether this key can be used')
+    is_expired: bool = ...
+    is_valid: bool = ...
+    is_quota_exceeded: bool = ...
+    rate_limit_rpm: int | None = Field(None, description='Max requests per minute (null = unlimited)')
+    rate_limit_rpd: int | None = Field(None, description='Max requests per day (null = unlimited)')
+    quota_monthly_usd: Any | None = Field(None, description='Monthly spending limit in USD (null = unlimited)', pattern='^-?\\d{0,8}(?:\\.\\d{0,2})?$')
+    quota_used_usd: Any = Field(description='Amount spent this month in USD', pattern='^-?\\d{0,4}(?:\\.\\d{0,6})?$')
+    last_used_at: Any | None = Field(None, description='Last time this key was used')
+    total_requests: int = Field(description='Total number of requests made with this key')
+    total_cost_usd: Any = Field(description='Total cost of all requests in USD', pattern='^-?\\d{0,6}(?:\\.\\d{0,6})?$')
+    expires_at: Any | None = Field(None, description='When this key expires (null = never)')
+    created_at: Any = ...
+    updated_at: Any = ...
+    metadata: dict[str, Any] | None = Field(None, description='Additional metadata (e.g., allowed IPs, allowed models)')
+
+
+