django-cfg 1.4.21__py3-none-any.whl → 1.4.24__py3-none-any.whl

django_cfg/modules/django_rpc_old/config.py

@@ -1,279 +0,0 @@
-"""
-WebSocket RPC Configuration for Django-CFG.
-
-Pydantic 2 configuration model for WebSocket RPC integration.
-Follows django-cfg patterns for modular configuration.
-
-File size: ~250 lines
-"""
-
-from pydantic import Field, field_validator
-import logging
-import os
-
-from django_cfg.models.base import BaseCfgAutoModule
-
-logger = logging.getLogger(__name__)
-
-
-class WebSocketRPCConfig(BaseCfgAutoModule):
-    """
-    WebSocket RPC configuration module.
-
-    Configures Redis-based RPC communication between Django and
-    external WebSocket servers.
-
-    Example:
-        >>> from django_cfg import DjangoConfig
-        >>> from django_cfg.modules.django_rpc import WebSocketRPCConfig
-        >>>
-        >>> config = DjangoConfig(
-        ...     websocket_rpc=WebSocketRPCConfig(
-        ...         enabled=True,
-        ...         redis_url="redis://localhost:6379/2",
-        ...         rpc_timeout=30
-        ...     )
-        ... )
-    """
-
-    # Module metadata
-    module_name: str = Field(
-        default="websocket_rpc",
-        frozen=True,
-        description="Module name for django-cfg integration",
-    )
-
-    enabled: bool = Field(
-        default=False,
-        description="Enable WebSocket RPC layer",
-    )
-
-    # Redis configuration
-    redis_url: str = Field(
-        default="redis://localhost:6379/2",
-        description="Redis URL for WebSocket RPC (dedicated database recommended)",
-        examples=[
-            "redis://localhost:6379/2",
-            "redis://:password@localhost:6379/2",
-            "redis://redis-server:6379/2",
-        ],
-    )
-
-    redis_max_connections: int = Field(
-        default=50,
-        ge=10,
-        le=500,
-        description="Maximum Redis connection pool size",
-    )
-
-    # RPC settings
-    rpc_timeout: int = Field(
-        default=30,
-        ge=5,
-        le=300,
-        description="Default RPC call timeout (seconds)",
-    )
-
-    request_stream: str = Field(
-        default="stream:requests",
-        min_length=1,
-        max_length=100,
-        description="Redis Stream name for RPC requests",
-    )
-
-    consumer_group: str = Field(
-        default="rpc_group",
-        min_length=1,
-        max_length=100,
-        description="Redis Streams consumer group name",
-    )
-
-    stream_maxlen: int = Field(
-        default=10000,
-        ge=1000,
-        le=100000,
-        description="Maximum stream length (XADD MAXLEN)",
-    )
-
-    # Response settings
-    response_key_prefix: str = Field(
-        default="list:response:",
-        min_length=1,
-        max_length=50,
-        description="Prefix for response list keys",
-    )
-
-    response_key_ttl: int = Field(
-        default=60,
-        ge=10,
-        le=3600,
-        description="Response key TTL (seconds) for auto-cleanup",
-    )
-
-    # Bridge listener settings (for receiving messages from WS)
-    enable_bridge: bool = Field(
-        default=False,
-        description="Enable Redis bridge listener for incoming RPC",
-    )
-
-    bridge_consumer_name: str = Field(
-        default="django_bridge",
-        min_length=1,
-        max_length=100,
-        description="Consumer name for bridge listener",
-    )
-
-    bridge_stream: str = Field(
-        default="stream:django:requests",
-        min_length=1,
-        max_length=100,
-        description="Redis Stream for incoming requests to Django",
-    )
-
-    # WebSocket server settings (for client-side reference)
-    websocket_url: str = Field(
-        default="ws://localhost:8765",
-        description="WebSocket server URL (for documentation/testing)",
-        examples=["ws://localhost:8765", "wss://ws.example.com"],
-    )
-
-    # Performance settings
-    enable_connection_pooling: bool = Field(
-        default=True,
-        description="Enable Redis connection pooling",
-    )
-
-    socket_keepalive: bool = Field(
-        default=True,
-        description="Enable TCP keepalive for Redis connections",
-    )
-
-    socket_keepalive_options: dict[str, int] = Field(
-        default={
-            "socket_keepalive": 1,
-            "socket_keepalive_idle": 30,
-            "socket_keepalive_intvl": 10,
-            "socket_keepalive_cnt": 3,
-        },
-        description="TCP keepalive options for Redis sockets",
-    )
-
-    # Logging settings
-    log_rpc_calls: bool = Field(
-        default=False,
-        description="Log all RPC calls (verbose, use for debugging)",
-    )
-
-    log_level: str = Field(
-        default="INFO",
-        pattern=r"^(DEBUG|INFO|WARNING|ERROR|CRITICAL)$",
-        description="Log level for RPC module",
-    )
-
-    @field_validator("redis_url")
-    @classmethod
-    def validate_redis_url(cls, v: str) -> str:
-        """
-        Validate Redis URL format.
-
-        Args:
-            v: Redis URL to validate
-
-        Returns:
-            Validated Redis URL
-
-        Raises:
-            ValueError: If URL format is invalid
-        """
-        if not v.startswith("redis://") and not v.startswith("rediss://"):
-            raise ValueError(
-                "redis_url must start with 'redis://' or 'rediss://' "
-                f"(got: {v})"
-            )
-
-        return v
-
-    @field_validator("websocket_url")
-    @classmethod
-    def validate_websocket_url(cls, v: str) -> str:
-        """
-        Validate WebSocket URL format.
-
-        Args:
-            v: WebSocket URL to validate
-
-        Returns:
-            Validated WebSocket URL
-
-        Raises:
-            ValueError: If URL format is invalid
-        """
-        if not v.startswith("ws://") and not v.startswith("wss://"):
-            raise ValueError(
-                "websocket_url must start with 'ws://' or 'wss://' "
-                f"(got: {v})"
-            )
-
-        return v
-
-    def to_django_settings(self) -> dict:
-        """
-        Generate Django settings dictionary.
-
-        Returns:
-            Dictionary with WEBSOCKET_RPC settings
-
-        Example:
-            >>> config = WebSocketRPCConfig(enabled=True)
-            >>> settings_dict = config.to_django_settings()
-            >>> print(settings_dict["WEBSOCKET_RPC"]["REDIS_URL"])
-        """
-        if not self.enabled:
-            return {}
-
-        return {
-            "WEBSOCKET_RPC": {
-                "ENABLED": self.enabled,
-                "REDIS_URL": self.redis_url,
-                "REDIS_MAX_CONNECTIONS": self.redis_max_connections,
-                "RPC_TIMEOUT": self.rpc_timeout,
-                "REQUEST_STREAM": self.request_stream,
-                "CONSUMER_GROUP": self.consumer_group,
-                "STREAM_MAXLEN": self.stream_maxlen,
-                "RESPONSE_KEY_PREFIX": self.response_key_prefix,
-                "RESPONSE_KEY_TTL": self.response_key_ttl,
-                "ENABLE_BRIDGE": self.enable_bridge,
-                "BRIDGE_CONSUMER_NAME": self.bridge_consumer_name,
-                "BRIDGE_STREAM": self.bridge_stream,
-                "WEBSOCKET_URL": self.websocket_url,
-                "LOG_RPC_CALLS": self.log_rpc_calls,
-                "LOG_LEVEL": self.log_level,
-            }
-        }
-
-    def get_redis_config(self) -> dict:
-        """
-        Get Redis connection configuration.
-
-        Returns:
-            Dictionary with Redis connection options
-
-        Example:
-            >>> config = WebSocketRPCConfig()
-            >>> redis_config = config.get_redis_config()
-            >>> redis_client = redis.Redis.from_url(**redis_config)
-        """
-        config = {
-            "url": self.redis_url,
-            "max_connections": self.redis_max_connections,
-            "decode_responses": False,  # We handle JSON ourselves
-        }
-
-        if self.socket_keepalive:
-            config["socket_keepalive"] = True
-            config["socket_keepalive_options"] = self.socket_keepalive_options
-
-        return config
-
-
-__all__ = ["WebSocketRPCConfig"]

django_cfg/modules/django_rpc_old/exceptions.py

@@ -1,172 +0,0 @@
-"""
-Custom Exceptions for WebSocket RPC.
-
-Provides specific exception types for better error handling and debugging.
-
-File size: ~150 lines
-"""
-
-from typing import Optional
-from django_cfg.models.websocket import RPCError
-
-
-class RPCBaseException(Exception):
-    """
-    Base exception for all RPC-related errors.
-
-    All custom RPC exceptions inherit from this class.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initialize base RPC exception.
-
-        Args:
-            message: Error message
-        """
-        self.message = message
-        super().__init__(message)
-
-
-class RPCTimeoutError(RPCBaseException):
-    """
-    RPC call timed out waiting for response.
-
-    Raised when BLPOP timeout is exceeded.
-
-    Example:
-        >>> try:
-        ...     result = rpc.call(method="slow", params=..., timeout=5)
-        ... except RPCTimeoutError as e:
-        ...     print(f"RPC timeout: {e.message}")
-        ...     print(f"Timeout duration: {e.timeout_seconds}s")
-    """
-
-    def __init__(self, message: str, method: str, timeout_seconds: int):
-        """
-        Initialize timeout error.
-
-        Args:
-            message: Error message
-            method: RPC method that timed out
-            timeout_seconds: Timeout duration that was exceeded
-        """
-        super().__init__(message)
-        self.method = method
-        self.timeout_seconds = timeout_seconds
-
-    def __str__(self) -> str:
-        """String representation."""
-        return f"RPC timeout on method '{self.method}' after {self.timeout_seconds}s: {self.message}"
-
-
-class RPCRemoteError(RPCBaseException):
-    """
-    Remote RPC execution failed.
-
-    Raised when server returns error response.
-
-    Example:
-        >>> try:
-        ...     result = rpc.call(method="...", params=...)
-        ... except RPCRemoteError as e:
-        ...     print(f"Remote error: {e.error.code}")
-        ...     print(f"Message: {e.error.message}")
-        ...     if e.error.retryable:
-        ...         print(f"Can retry after {e.error.retry_after}s")
-    """
-
-    def __init__(self, error: RPCError):
-        """
-        Initialize remote error.
-
-        Args:
-            error: Structured RPC error from server
-        """
-        super().__init__(error.message)
-        self.error = error
-
-    def __str__(self) -> str:
-        """String representation."""
-        return f"RPC remote error [{self.error.code.value}]: {self.error.message}"
-
-    @property
-    def is_retryable(self) -> bool:
-        """Check if error is retryable."""
-        return self.error.retryable
-
-    @property
-    def retry_after(self) -> Optional[int]:
-        """Get retry delay in seconds."""
-        return self.error.retry_after
-
-
-class RPCConnectionError(RPCBaseException):
-    """
-    Failed to connect to Redis or WebSocket server.
-
-    Raised when Redis connection fails.
-
-    Example:
-        >>> try:
-        ...     rpc = WebSocketRPCClient(redis_url="redis://invalid:6379")
-        ... except RPCConnectionError as e:
-        ...     print(f"Connection failed: {e.message}")
-    """
-
-    def __init__(self, message: str, redis_url: Optional[str] = None):
-        """
-        Initialize connection error.
-
-        Args:
-            message: Error message
-            redis_url: Redis URL that failed to connect
-        """
-        super().__init__(message)
-        self.redis_url = redis_url
-
-    def __str__(self) -> str:
-        """String representation."""
-        if self.redis_url:
-            return f"RPC connection error to {self.redis_url}: {self.message}"
-        return f"RPC connection error: {self.message}"
-
-
-class RPCConfigurationError(RPCBaseException):
-    """
-    RPC configuration error.
-
-    Raised when RPC client is misconfigured.
-
-    Example:
-        >>> try:
-        ...     rpc = get_rpc_client()  # No config in settings
-        ... except RPCConfigurationError as e:
-        ...     print(f"Configuration error: {e.message}")
-    """
-
-    def __init__(self, message: str, config_key: Optional[str] = None):
-        """
-        Initialize configuration error.
-
-        Args:
-            message: Error message
-            config_key: Configuration key that is missing/invalid
-        """
-        super().__init__(message)
-        self.config_key = config_key
-
-    def __str__(self) -> str:
-        """String representation."""
-        if self.config_key:
-            return f"RPC configuration error (key: {self.config_key}): {self.message}"
-        return f"RPC configuration error: {self.message}"
-
-
-__all__ = [
-    "RPCBaseException",
-    "RPCTimeoutError",
-    "RPCRemoteError",
-    "RPCConnectionError",
-    "RPCConfigurationError",
-]

django_cfg/modules/django_unfold/callbacks/revolution.py

@@ -1,81 +0,0 @@
-"""
-Django Client (OpenAPI) integration callbacks.
-"""
-
-import logging
-from typing import Dict, Any, List, Tuple
-
-from django.conf import settings
-
-logger = logging.getLogger(__name__)
-
-
-class OpenAPIClientCallbacks:
-    """Django Client (OpenAPI) integration callbacks."""
-
-    def get_openapi_groups_data(self) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
-        """Get Django Client (OpenAPI) groups data."""
-        try:
-            # Try to get openapi_client config from Django settings
-            openapi_config = getattr(settings, "OPENAPI_CLIENT", {})
-            if isinstance(openapi_config, dict):
-                groups_list = openapi_config.get("groups", [])
-                api_prefix = openapi_config.get("api_prefix", "api")
-            else:
-                # Handle Pydantic model instance
-                groups_list = getattr(openapi_config, "groups", [])
-                api_prefix = getattr(openapi_config, "api_prefix", "api")
-
-            groups_data = []
-            total_apps = 0
-            total_endpoints = 0
-
-            for group in groups_list:
-                # Handle both dict and object access
-                if isinstance(group, dict):
-                    group_name = group.get("name", "unknown")
-                    title = group.get("title", group_name.title())
-                    description = group.get("description", f"{group_name} group")
-                    apps = group.get("apps", [])
-                else:
-                    # Handle object access (for OpenAPIGroupConfig instances)
-                    group_name = getattr(group, "name", "unknown")
-                    title = getattr(group, "title", group_name.title())
-                    description = getattr(group, "description", f"{group_name} group")
-                    apps = getattr(group, "apps", [])
-
-                # Count actual endpoints by checking URL patterns (simplified estimate)
-                endpoint_count = len(apps) * 3  # Conservative estimate
-
-                groups_data.append({
-                    "name": group_name,
-                    "title": title,
-                    "description": description,
-                    "app_count": len(apps),
-                    "endpoint_count": endpoint_count,
-                    "status": "active",
-                    "schema_url": f"/schema/{group_name}/",
-                    "swagger_url": f"/schema/{group_name}/swagger/",
-                    "redoc_url": f"/schema/{group_name}/redoc/",
-                    "api_url": f"/{api_prefix}/{group_name}/",
-                })
-
-                total_apps += len(apps)
-                total_endpoints += endpoint_count
-
-            return groups_data, {
-                "total_apps": total_apps,
-                "total_endpoints": total_endpoints,
-                "total_groups": len(groups_list),
-            }
-        except Exception as e:
-            logger.error(f"Error getting OpenAPI groups: {e}")
-            return [], {
-                "total_apps": 0,
-                "total_endpoints": 0,
-                "total_groups": 0,
-            }
-
-
-# Keep backward compatibility alias
-RevolutionCallbacks = OpenAPIClientCallbacks