sdkrouter 0.1.1__py3-none-any.whl

sdkrouter/_api/generated/cleaner/__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 .cleaner__api__cleaner import CleanerCleanerAPI
+from . import enums
+# NOTE: Individual enum imports commented out due to invalid Python syntax with dotted names
+# from .enums import CleanRequestRequest.output_format, CleaningRequestDetail.status, CleaningRequestList.status
+
+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 cleaner_cleaner(self) -> CleanerCleanerAPI:
+        """Access cleaner endpoints."""
+        return self._client.cleaner_cleaner
+
+    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/cleaner/cleaner__api__cleaner/__init__.py

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

sdkrouter/_api/generated/cleaner/cleaner__api__cleaner/client.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class CleanerCleanerAPI:
+    """API endpoints for Cleaner."""
+
+    def __init__(self, client: httpx.AsyncClient):
+        """Initialize sub-client with shared httpx client."""
+        self._client = client
+
+    async def list(self) -> None:
+        """
+        List cleaning requests
+
+        List user's cleaning requests.
+        """
+        url = "/api/cleaner/"
+        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 None
+
+
+    async def retrieve(self, id: str) -> CleaningRequestDetail:
+        """
+        Get cleaning request details
+
+        Get cleaning request details.
+        """
+        url = f"/api/cleaner/{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 CleaningRequestDetail.model_validate(response.json())
+
+
+    async def clean_create(self, data: CleanRequestRequest) -> CleanResponse:
+        """
+        Clean HTML file
+
+        Clean HTML file. Accepts multipart/form-data with HTML file. Returns
+        cleaned HTML with statistics.
+        """
+        url = "/api/cleaner/clean/"
+        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 CleanResponse.model_validate(response.json())
+
+
+    async def stats_retrieve(self) -> CleaningStats:
+        """
+        Get cleaning statistics
+
+        Get cleaning statistics.
+        """
+        url = "/api/cleaner/stats/"
+        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 CleaningStats.model_validate(response.json())
+
+

sdkrouter/_api/generated/cleaner/cleaner__api__cleaner/models.py

@@ -0,0 +1,117 @@
+# 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 CleanRequestRequestOutputFormat, CleaningRequestDetailStatus
+
+
+class CleaningRequestDetail(BaseModel):
+    """
+    Detail serializer for cleaning request.
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    uuid: Any = Field(description='Unique request identifier')
+    original_filename: Any = Field(description='Original filename')
+    original_size_bytes: int = Field(description='Original HTML size in bytes')
+    cleaned_html: Any = Field(description='Cleaned HTML content')
+    cleaned_size_bytes: int = Field(description='Cleaned HTML size in bytes')
+    output_format: Any = Field(description='Output format: html, markdown, aom, xtree')
+    config: dict[str, Any] = Field(description='CleanerConfig used for this request')
+    stats: dict[str, Any] = Field(description='Cleaning statistics (elements removed, etc.)')
+    status: CleaningRequestDetailStatus = Field(description='* `pending` - Pending\n* `processing` - Processing\n* `success` - Success\n* `error` - Error')
+    error_message: Any = Field(description='Error message if request failed')
+    duration_ms: int | None = Field(None, description='Processing duration in milliseconds')
+    compression_ratio: float = ...
+    size_reduction_percent: float = ...
+    created_at: Any = ...
+
+
+
+class CleanRequestRequest(BaseModel):
+    """
+    Request serializer for HTML cleaning (multipart/form-data).
+
+    Request model (no read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    file: str = Field(description='HTML file to clean')
+    output_format: CleanRequestRequestOutputFormat | None = Field(None, description='* `html` - html\n* `markdown` - markdown\n* `aom` - aom\n* `xtree` - xtree')
+    max_tokens: int | None = Field(None, ge=100, le=100000)
+    remove_scripts: bool | None = None
+    remove_styles: bool | None = None
+    remove_comments: bool | None = None
+    remove_hidden: bool | None = None
+    filter_classes: bool | None = None
+    class_threshold: float | None = Field(None, ge=0.0, le=1.0)
+    try_hydration: bool | None = None
+    preserve_selectors: list[str] | None = None
+
+
+
+class CleanResponse(BaseModel):
+    """
+    Response serializer for cleaned HTML.
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    request_uuid: str = ...
+    cleaned_html: str = ...
+    original_size: int = ...
+    cleaned_size: int = ...
+    compression_ratio: float = ...
+    size_reduction_percent: float = ...
+    duration_ms: int = ...
+    output_format: str = ...
+    stats: dict[str, Any] = ...
+
+
+
+class CleaningStats(BaseModel):
+    """
+    Statistics serializer.
+
+    Response model (includes read-only fields).
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="allow",
+        frozen=False,
+    )
+
+    total_requests: int = ...
+    successful_requests: int = ...
+    failed_requests: int = ...
+    total_original_bytes: int | None = None
+    total_cleaned_bytes: int | None = None
+    avg_duration_ms: float | None = None
+    overall_compression_ratio: float | None = None
+    overall_size_reduction_percent: float | None = None
+
+
+

sdkrouter/_api/generated/cleaner/cleaner__api__cleaner/sync_client.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class SyncCleanerCleanerAPI:
+    """Synchronous API endpoints for Cleaner."""
+
+    def __init__(self, client: httpx.Client):
+        """Initialize sync sub-client with shared httpx client."""
+        self._client = client
+
+    def list(self) -> None:
+        """
+        List cleaning requests
+
+        List user's cleaning requests.
+        """
+        url = "/api/cleaner/"
+        response = 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)
+
+
+    def retrieve(self, id: str) -> CleaningRequestDetail:
+        """
+        Get cleaning request details
+
+        Get cleaning request details.
+        """
+        url = f"/api/cleaner/{id}/"
+        response = 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 CleaningRequestDetail.model_validate(response.json())
+
+
+    def clean_create(self, data: CleanRequestRequest) -> CleanResponse:
+        """
+        Clean HTML file
+
+        Clean HTML file. Accepts multipart/form-data with HTML file. Returns
+        cleaned HTML with statistics.
+        """
+        url = "/api/cleaner/clean/"
+        response = 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 CleanResponse.model_validate(response.json())
+
+
+    def stats_retrieve(self) -> CleaningStats:
+        """
+        Get cleaning statistics
+
+        Get cleaning statistics.
+        """
+        url = "/api/cleaner/stats/"
+        response = 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 CleaningStats.model_validate(response.json())
+
+

sdkrouter/_api/generated/cleaner/client.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+from .cleaner__api__cleaner import CleanerCleanerAPI
+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.cleaner_cleaner = CleanerCleanerAPI(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/cleaner/enums.py

@@ -0,0 +1,55 @@
+# 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 CleanRequestRequestOutputFormat(StrEnum):
+    """
+    * `html` - html
+    * `markdown` - markdown
+    * `aom` - aom
+    * `xtree` - xtree
+    """
+
+    HTML = "html"
+    MARKDOWN = "markdown"
+    AOM = "aom"
+    XTREE = "xtree"
+
+
+
+class CleaningRequestDetailStatus(StrEnum):
+    """
+    * `pending` - Pending
+    * `processing` - Processing
+    * `success` - Success
+    * `error` - Error
+    """
+
+    PENDING = "pending"
+    PROCESSING = "processing"
+    SUCCESS = "success"
+    ERROR = "error"
+
+
+
+class CleaningRequestListStatus(StrEnum):
+    """
+    * `pending` - Pending
+    * `processing` - Processing
+    * `success` - Success
+    * `error` - Error
+    """
+
+    PENDING = "pending"
+    PROCESSING = "processing"
+    SUCCESS = "success"
+    ERROR = "error"
+
+
+