django-cfg 1.4.10__py3-none-any.whl → 1.4.13__py3-none-any.whl

django_cfg/modules/django_client/core/generator/python/templates/__init__.py.jinja

@@ -0,0 +1,9 @@
+from .client import APIClient
+from .models import *
+{% if has_enums %}
+from .enums import *
+{% endif %}
+
+__all__ = [
+    "APIClient",
+]

django_cfg/modules/django_client/core/generator/python/templates/api_wrapper.py.jinja

@@ -0,0 +1,153 @@
+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
+        )
+
+{% for prop in properties %}
+    @property
+    def {{ prop.property }}(self) -> {{ prop.class_name }}:
+        """Access {{ prop.tag }} endpoints."""
+        return self._client.{{ prop.property }}
+
+{% endfor %}
+    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(self) -> dict[str, Any]:
+        """
+        Get OpenAPI schema.
+
+        Returns:
+            Complete OpenAPI specification for this API
+        """
+        return OPENAPI_SCHEMA
+
+    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()

django_cfg/modules/django_client/core/generator/python/templates/app_init.py.jinja

@@ -0,0 +1,6 @@
+from .client import {{ class_name }}
+from .models import *
+
+__all__ = [
+    "{{ class_name }}",
+]

django_cfg/modules/django_client/core/generator/python/templates/client/app_client.py.jinja

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class {{ class_name }}:
+    """API endpoints for {{ tag }}."""
+
+    def __init__(self, client: httpx.AsyncClient):
+        """Initialize sub-client with shared httpx client."""
+        self._client = client
+
+{% for operation in operations %}
+{{ operation | indent(4, first=True) }}
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client/flat_client.py.jinja

@@ -0,0 +1,38 @@
+class APIClient:
+    """
+    Async API client for {{ api_title }}.
+
+    Usage:
+        >>> async with APIClient(base_url='https://api.example.com') as client:
+        ...     users = await client.users_list()
+    """
+
+    def __init__(self, base_url: str, **kwargs: Any):
+        """
+        Initialize API client.
+
+        Args:
+            base_url: Base API URL (e.g., 'https://api.example.com')
+            **kwargs: Additional httpx.AsyncClient kwargs
+        """
+        self.base_url = base_url.rstrip('/')
+        self._client = httpx.AsyncClient(
+            base_url=self.base_url,
+            timeout=30.0,
+            **kwargs,
+        )
+
+    async def __aenter__(self) -> 'APIClient':
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        await self._client.aclose()
+
+    async def close(self) -> None:
+        """Close HTTP client."""
+        await self._client.aclose()
+
+{% for operation in operations %}
+    {{ operation }}
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client/main_client.py.jinja

@@ -0,0 +1,68 @@
+class APIClient:
+    """
+    Async API client for {{ api_title }}.
+
+    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,
+                timeout=30.0,
+                **kwargs,
+            )
+        else:
+            self._client = httpx.AsyncClient(
+                base_url=self.base_url,
+                timeout=30.0,
+                **kwargs,
+            )
+
+        # Initialize logger
+        self.logger: Optional[APILogger] = None
+        if logger_config is not None:
+            self.logger = APILogger(logger_config)
+
+        # Initialize sub-clients
+{% for tag in tags %}
+        self.{{ tag.property }} = {{ tag.class_name }}(self._client)
+{% endfor %}
+
+    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()

django_cfg/modules/django_client/core/generator/python/templates/client/main_client_file.py.jinja

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+{% for tag in tags %}
+from .{{ tag.slug }} import {{ tag.class_name }}
+{% endfor %}
+from .logger import APILogger, LoggerConfig
+from .retry import RetryConfig, RetryAsyncClient
+
+
+{{ client_code }}

django_cfg/modules/django_client/core/generator/python/templates/client/operation_method.py.jinja

@@ -0,0 +1,9 @@
+async def {{ method_name }}({{ params | join(', ') }}) -> {{ return_type }}:
+{% if docstring %}
+    """
+{{ docstring | indent(4, first=True) }}
+    """
+{% endif %}
+{% for line in body_lines %}
+    {{ line }}
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client/sub_client.py.jinja

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class {{ class_name }}:
+    """API endpoints for {{ tag }}."""
+
+    def __init__(self, client: httpx.AsyncClient):
+        """Initialize sub-client with shared httpx client."""
+        self._client = client
+
+{% for operation in operations %}
+{{ operation | indent(4, first=True) }}
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client/sync_main_client.py.jinja

@@ -0,0 +1,50 @@
+class SyncAPIClient:
+    """
+    Synchronous API client for {{ api_title }}.
+
+    Usage:
+        >>> with SyncAPIClient(base_url='https://api.example.com') as client:
+        ...     users = client.users.list()
+        ...     post = client.posts.create(data=new_post)
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        logger_config: Optional[LoggerConfig] = None,
+        **kwargs: Any,
+    ):
+        """
+        Initialize sync API client.
+
+        Args:
+            base_url: Base API URL (e.g., 'https://api.example.com')
+            logger_config: Logger configuration (None to disable logging)
+            **kwargs: Additional httpx.Client kwargs
+        """
+        self.base_url = base_url.rstrip('/')
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            timeout=30.0,
+            **kwargs,
+        )
+
+        # Initialize logger
+        self.logger: Optional[APILogger] = None
+        if logger_config is not None:
+            self.logger = APILogger(logger_config)
+
+        # Initialize sub-clients
+{% for tag in tags %}
+        self.{{ tag.property }} = Sync{{ tag.class_name }}(self._client)
+{% endfor %}
+
+    def __enter__(self) -> 'SyncAPIClient':
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self._client.close()
+
+    def close(self) -> None:
+        """Close HTTP client."""
+        self._client.close()

django_cfg/modules/django_client/core/generator/python/templates/client/sync_operation_method.py.jinja

@@ -0,0 +1,9 @@
+def {{ method_name }}({{ params | join(', ') }}) -> {{ return_type }}:
+{% if docstring %}
+    """
+{{ docstring | indent(4, first=True) }}
+    """
+{% endif %}
+{% for line in body_lines %}
+    {{ line }}
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client/sync_sub_client.py.jinja

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import httpx
+
+from .models import *
+
+
+class Sync{{ class_name }}:
+    """Synchronous API endpoints for {{ tag }}."""
+
+    def __init__(self, client: httpx.Client):
+        """Initialize sync sub-client with shared httpx client."""
+        self._client = client
+
+{% for operation in operations %}
+{{ operation | indent(4, first=True) }}
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/client_file.py.jinja

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from .models import *
+{% if has_enums %}
+from .enums import *
+{% endif %}
+
+
+{{ client_code }}

django_cfg/modules/django_client/core/generator/python/templates/main_init.py.jinja

@@ -0,0 +1,52 @@
+"""
+{{ api_title }} - 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
+    >>> schema = api.get_schema()
+"""
+
+from __future__ import annotations
+
+import threading
+from typing import Any
+
+import httpx
+
+from .client import APIClient
+from .schema import OPENAPI_SCHEMA
+from .logger import LoggerConfig
+from .retry import RetryConfig
+{% for tag in tags %}
+from .{{ tag.slug }} import {{ tag.class_name }}
+{% endfor %}
+{% if has_enums %}
+from . import enums
+from .enums import {{ enum_names | join(', ') }}
+{% endif %}
+
+TOKEN_KEY = "auth_token"
+REFRESH_TOKEN_KEY = "refresh_token"
+
+{{ api_class }}
+
+__all__ = [
+    "API",
+    "APIClient",
+]

django_cfg/modules/django_client/core/generator/python/templates/models/app_models.py.jinja

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+{% if has_enums and enum_names %}
+
+from ..enums import {{ enum_names | join(', ') }}
+{% endif %}
+
+
+{% for schema in schemas %}
+{{ schema }}
+
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/models/enum_class.py.jinja

@@ -0,0 +1,17 @@
+class {{ name }}({{ base_class }}):
+{% if docstring %}
+    """
+{{ docstring | indent(4, first=True) }}
+    """
+{% endif %}
+{% if members %}
+{% if docstring %}
+
+{% endif %}
+{% for member in members %}
+    {{ member }}
+{% endfor %}
+{% else %}
+
+    pass
+{% endif %}

django_cfg/modules/django_client/core/generator/python/templates/models/enums.py.jinja

@@ -0,0 +1,8 @@
+from enum import IntEnum, StrEnum
+
+
+{% for enum in enums %}
+{{ enum }}
+
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/models/models.py.jinja

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+{% if has_enums %}
+
+from .enums import *
+{% endif %}
+
+
+{% for schema in schemas %}
+{{ schema }}
+
+
+{% endfor %}

django_cfg/modules/django_client/core/generator/python/templates/models/schema_class.py.jinja

@@ -0,0 +1,21 @@
+class {{ name }}(BaseModel):
+{% if docstring %}
+    """
+{{ docstring | indent(4, first=True) }}
+    """
+{% endif %}
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        frozen=False,
+    )
+{% if fields %}
+
+{% for field in fields %}
+    {{ field }}
+{% endfor %}
+{% else %}
+
+    pass
+{% endif %}

django_cfg/modules/django_client/core/generator/python/templates/pyproject.toml.jinja

@@ -0,0 +1,55 @@
+[tool.poetry]
+name = "{{ package_name }}"
+version = "{{ version }}"
+description = "{{ description }}"
+authors = {{ authors | tojson }}
+license = "{{ license }}"
+readme = "README.md"
+{% if repository_url %}repository = "{{ repository_url }}"
+{% endif %}keywords = {{ keywords | tojson }}
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+
+[tool.poetry.dependencies]
+python = "{{ python_version }}"
+pydantic = "^2.12"
+httpx = "^0.28"
+tenacity = "^9.1"
+rich = "^14.1.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0"
+pytest-asyncio = "^0.24"
+pytest-cov = "^6.0"
+mypy = "^1.18"
+ruff = "^0.13"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "UP", "B"]
+ignore = []
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = "--cov={{ package_name | replace('-', '_') }} --cov-report=html --cov-report=term"