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

django_cfg/models/services/email.py

@@ -4,8 +4,10 @@ Email Configuration Model
 Django email settings with Pydantic 2.
 """
 
-from typing import Dict, Any, Optional
+from typing import Any, Dict, Optional
+
 from pydantic import Field, field_validator
+
 from ..base import BaseConfig
 
 
@@ -16,70 +18,70 @@ class EmailConfig(BaseConfig):
     Supports SMTP, console, file, and other email backends
     with environment-aware defaults.
     """
-    
+
     # Email backend
     backend: str = Field(
         default="console",
         description="Email backend (smtp/console/file/memory)"
     )
-    
+
     # SMTP settings
     host: str = Field(
         default="localhost",
         description="SMTP server host"
     )
-    
+
     port: int = Field(
         default=587,
         ge=1,
         le=65535,
         description="SMTP server port"
     )
-    
+
     username: Optional[str] = Field(
         default=None,
         description="SMTP username"
     )
-    
+
     password: Optional[str] = Field(
         default=None,
         description="SMTP password"
     )
-    
+
     use_tls: bool = Field(
         default=True,
         description="Use TLS for SMTP"
     )
-    
+
     use_ssl: bool = Field(
         default=False,
         description="Use SSL for SMTP"
     )
-    
+
     timeout: int = Field(
         default=30,
         ge=1,
         le=300,
         description="SMTP timeout in seconds"
     )
-    
+
     # Email addresses
     default_from: str = Field(
         default="noreply@example.com",
         description="Default 'from' email address"
     )
-    
+
     admin_email: Optional[str] = Field(
         default=None,
         description="Admin email for error notifications"
     )
-    
+
     # File backend settings
     file_path: str = Field(
         default="emails/",
         description="Path for file-based email backend"
     )
-    
+
     @field_validator('backend')
     @classmethod
     def validate_backend(cls, v: str) -> str:
@@ -88,7 +90,7 @@ class EmailConfig(BaseConfig):
         if v not in valid_backends:
             raise ValueError(f"Email backend must be one of: {valid_backends}")
         return v
-    
+
     @field_validator('default_from', 'admin_email')
     @classmethod
     def validate_email(cls, v: Optional[str]) -> Optional[str]:
@@ -96,7 +98,7 @@ class EmailConfig(BaseConfig):
         if v and '@' not in v:
             raise ValueError("Invalid email address format")
         return v
-    
+
     @field_validator('use_tls', 'use_ssl', mode='after')
     @classmethod
     def validate_tls_ssl(cls, v, info):
@@ -105,12 +107,12 @@ class EmailConfig(BaseConfig):
         if data.get('use_tls') and data.get('use_ssl'):
             raise ValueError("Cannot use both TLS and SSL simultaneously")
         return v
-    
+
     def to_django_settings(self) -> Dict[str, Any]:
         """Convert to Django email settings."""
         if self.backend == 'smtp':
             backend_class = 'django.core.mail.backends.smtp.EmailBackend'
-            
+
             settings = {
                 'EMAIL_BACKEND': backend_class,
                 'EMAIL_HOST': self.host,
@@ -120,44 +122,44 @@ class EmailConfig(BaseConfig):
                 'EMAIL_TIMEOUT': self.timeout,
                 'DEFAULT_FROM_EMAIL': self.default_from,
             }
-            
+
             if self.username:
                 settings['EMAIL_HOST_USER'] = self.username
-            
+
             if self.password:
                 settings['EMAIL_HOST_PASSWORD'] = self.password
-        
+
         elif self.backend == 'console':
             settings = {
                 'EMAIL_BACKEND': 'django.core.mail.backends.console.EmailBackend',
                 'DEFAULT_FROM_EMAIL': self.default_from,
             }
-        
+
         elif self.backend == 'file':
             settings = {
                 'EMAIL_BACKEND': 'django.core.mail.backends.filebased.EmailBackend',
                 'EMAIL_FILE_PATH': self.file_path,
                 'DEFAULT_FROM_EMAIL': self.default_from,
             }
-        
+
         elif self.backend == 'memory':
             settings = {
                 'EMAIL_BACKEND': 'django.core.mail.backends.locmem.EmailBackend',
                 'DEFAULT_FROM_EMAIL': self.default_from,
             }
-        
+
         elif self.backend == 'dummy':
             settings = {
                 'EMAIL_BACKEND': 'django.core.mail.backends.dummy.EmailBackend',
                 'DEFAULT_FROM_EMAIL': self.default_from,
             }
-        
+
         else:
             raise ValueError(f"Unsupported email backend: {self.backend}")
-        
+
         # Add admin email if provided
         if self.admin_email:
             settings['ADMINS'] = [('Admin', self.admin_email)]
             settings['MANAGERS'] = [('Manager', self.admin_email)]
-        
+
         return settings

django_cfg/models/services/telegram.py

@@ -4,7 +4,8 @@ Telegram service configuration for django_cfg.
 Type-safe Telegram bot configuration with validation.
 """
 
-from typing import Dict, Optional, Any, Literal
+from typing import Any, Dict, Literal, Optional
+
 from pydantic import BaseModel, Field, field_validator
 
 

django_cfg/models/tasks/__init__.py

@@ -30,9 +30,9 @@ Example:
     ```
 """
 
-from .config import TaskConfig, TaskBackend, QueuePriority
 from .backends import DramatiqConfig, WorkerConfig
-from .utils import get_default_task_config, validate_task_config, get_smart_queues
+from .config import QueuePriority, TaskBackend, TaskConfig
+from .utils import get_default_task_config, get_smart_queues, validate_task_config
 
 __all__ = [
     # Main configuration

django_cfg/models/tasks/backends.py

@@ -5,10 +5,11 @@ Contains Dramatiq and Worker configuration models.
 Size: ~200 lines (focused on backend settings)
 """
 
-from pydantic import BaseModel, Field, field_validator
-from typing import Optional, List, Literal
-import os
 import logging
+import os
+from typing import List, Literal, Optional
+
+from pydantic import BaseModel, Field, field_validator
 
 logger = logging.getLogger(__name__)
 

django_cfg/models/tasks/config.py

@@ -5,11 +5,12 @@ Contains TaskConfig class (main entry point) and related enums.
 Size: ~250 lines (focused on main configuration)
 """
 
-from pydantic import BaseModel, Field, field_validator
-from typing import Optional, List, Dict, Any
-from enum import Enum
-import os
 import logging
+import os
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field, field_validator
 
 from django_cfg.models.base import BaseCfgAutoModule
 
@@ -303,6 +304,7 @@ class TaskConfig(BaseModel, BaseCfgAutoModule):
 
 # Resolve forward references for Pydantic v2
 from .backends import DramatiqConfig, WorkerConfig
+
 TaskConfig.model_rebuild()
 
 __all__ = [

django_cfg/models/tasks/utils.py

@@ -9,8 +9,8 @@ Contains utility functions for task configuration:
 Size: ~120 lines (focused on utilities)
 """
 
-from typing import List, Optional, TYPE_CHECKING
 import logging
+from typing import TYPE_CHECKING, List, Optional
 
 if TYPE_CHECKING:
     from .config import TaskConfig
@@ -87,8 +87,8 @@ def get_default_task_config(debug: bool = False) -> 'TaskConfig':
         >>> config.dramatiq.processes
         2
     """
-    from .config import TaskConfig
     from .backends import DramatiqConfig, WorkerConfig
+    from .config import TaskConfig
 
     smart_queues = get_smart_queues(debug)
 
@@ -158,8 +158,8 @@ def validate_task_config(config: 'TaskConfig', redis_url: Optional[str] = None)
 
     # Check if Dramatiq is available
     try:
-        import dramatiq
         import django_dramatiq
+        import dramatiq
     except ImportError as e:
         logger.error(f"Dramatiq dependencies not available: {e}")
         return False

django_cfg/modules/base.py

@@ -4,10 +4,10 @@ Base Module for Django CFG
 Provides base functionality for all auto-configuring modules.
 """
 
-from typing import Any, Optional, TYPE_CHECKING
-from abc import ABC
 import importlib
 import os
+from abc import ABC
+from typing import TYPE_CHECKING, Any, Optional
 
 if TYPE_CHECKING:
     from django_cfg.core.config import DjangoConfig
@@ -20,13 +20,13 @@ class BaseCfgModule(ABC):
     Provides common functionality and configuration access.
     Auto-discovers configuration from Django settings.
     """
-    
+
     _config_instance: Optional["DjangoConfig"] = None
-    
+
     def __init__(self):
         """Initialize the base module."""
         self._config = None
-    
+
     @classmethod
     def get_config(cls) -> Optional["DjangoConfig"]:
         """Get the DjangoConfig instance automatically."""
@@ -51,6 +51,7 @@ class BaseCfgModule(ABC):
 
             # Fallback: try to create minimal config from Django settings
             from django.conf import settings
+
             from django_cfg.core.config import DjangoConfig
 
             return DjangoConfig(
@@ -67,7 +68,7 @@ class BaseCfgModule(ABC):
     def reset_config(cls):
         """Reset the cached config instance (useful for testing)."""
         cls._config_instance = None
-    
+
     def set_config(self, config: Any) -> None:
         """
         Set the configuration instance.
@@ -76,7 +77,7 @@ class BaseCfgModule(ABC):
             config: The DjangoConfig instance
         """
         self._config = config
-    
+
     def _get_config_key(self, key: str, default: Any) -> Any:
         """
         Get a key from the configuration instance.
@@ -88,15 +89,15 @@ class BaseCfgModule(ABC):
         try:
             # Get config using class method
             config = self.get_config()
-            
+
             # If config is available, get the key
             if config is not None:
                 result = getattr(config, key, default)
                 return result
-            
+
             # Fallback to default if no config available
             return default
-            
+
         except Exception:
             # Return default on any error
             return default
@@ -109,7 +110,7 @@ class BaseCfgModule(ABC):
             True if Support is enabled, False otherwise
         """
         return self._get_config_key('enable_support', True)
-    
+
     def is_accounts_enabled(self) -> bool:
         """
         Check if django-cfg Accounts is enabled.
@@ -118,7 +119,7 @@ class BaseCfgModule(ABC):
             True if Accounts is enabled, False otherwise
         """
         return self._get_config_key('enable_accounts', False)
-    
+
     def is_newsletter_enabled(self) -> bool:
         """
         Check if django-cfg Newsletter is enabled.
@@ -127,7 +128,7 @@ class BaseCfgModule(ABC):
             True if Newsletter is enabled, False otherwise
         """
         return self._get_config_key('enable_newsletter', False)
-    
+
     def is_leads_enabled(self) -> bool:
         """
         Check if django-cfg Leads is enabled.
@@ -136,7 +137,7 @@ class BaseCfgModule(ABC):
             True if Leads is enabled, False otherwise
         """
         return self._get_config_key('enable_leads', False)
-    
+
     def is_agents_enabled(self) -> bool:
         """
         Check if django-cfg Agents is enabled.
@@ -145,7 +146,7 @@ class BaseCfgModule(ABC):
             True if Agents is enabled, False otherwise
         """
         return self._get_config_key('enable_agents', False)
-    
+
     def is_knowbase_enabled(self) -> bool:
         """
         Check if django-cfg Knowbase is enabled.
@@ -154,7 +155,7 @@ class BaseCfgModule(ABC):
             True if Knowbase is enabled, False otherwise
         """
         return self._get_config_key('enable_knowbase', False)
-    
+
     def should_enable_tasks(self) -> bool:
         """
         Check if django-cfg Tasks is enabled.
@@ -165,7 +166,7 @@ class BaseCfgModule(ABC):
         """
 
         return self.get_config().should_enable_tasks()
-    
+
     def is_maintenance_enabled(self) -> bool:
         """
         Check if django-cfg Maintenance is enabled.

django_cfg/modules/django_admin/__init__.py

@@ -5,49 +5,48 @@ Clean, type-safe admin utilities with no HTML duplication.
 """
 
 # Core utilities
-from .utils.displays import UserDisplay, MoneyDisplay, StatusDisplay, DateTimeDisplay
-from .utils.badges import StatusBadge, ProgressBadge, CounterBadge
+# Decorators
+from .decorators import action, display
 
 # Icons
-from .icons import Icons, IconCategories
+from .icons import IconCategories, Icons
 
 # Admin mixins
 from .mixins.display_mixin import DisplayMixin
 from .mixins.optimization_mixin import OptimizedModelAdmin
 from .mixins.standalone_actions_mixin import StandaloneActionsMixin, standalone_action
-
-# Configuration models
-from .models.display_models import UserDisplayConfig, MoneyDisplayConfig, DateTimeDisplayConfig
+from .models.action_models import ActionConfig, ActionVariant
 from .models.badge_models import BadgeConfig, BadgeVariant, StatusBadgeConfig
-from .models.action_models import ActionVariant, ActionConfig
 
-# Decorators
-from .decorators import display, action
+# Configuration models
+from .models.display_models import DateTimeDisplayConfig, MoneyDisplayConfig, UserDisplayConfig
+from .utils.badges import CounterBadge, ProgressBadge, StatusBadge
+from .utils.displays import DateTimeDisplay, MoneyDisplay, StatusDisplay, UserDisplay
 
 __version__ = "1.0.0"
 
 __all__ = [
     # Display utilities
     "UserDisplay",
-    "MoneyDisplay", 
+    "MoneyDisplay",
     "StatusDisplay",
     "DateTimeDisplay",
-    
+
     # Badge utilities
     "StatusBadge",
     "ProgressBadge",
     "CounterBadge",
-    
+
     # Icons
     "Icons",
     "IconCategories",
-    
+
     # Admin mixins
     "OptimizedModelAdmin",
     "DisplayMixin",
     "StandaloneActionsMixin",
     "standalone_action",
-    
+
     # Configuration models
     "UserDisplayConfig",
     "MoneyDisplayConfig",
@@ -57,7 +56,7 @@ __all__ = [
     "StatusBadgeConfig",
     "ActionVariant",
     "ActionConfig",
-    
+
     # Decorators
     "display",
     "action",

django_cfg/modules/django_admin/decorators/__init__.py

@@ -4,8 +4,8 @@ Django Admin Decorators - Wrappers for Unfold decorators.
 Provides consistent, type-safe decorators with our admin utilities integration.
 """
 
-from .display import display
 from .actions import action
+from .display import display
 
 __all__ = [
     'display',

django_cfg/modules/django_admin/decorators/actions.py

@@ -4,14 +4,15 @@ Action decorator wrapper for Unfold integration.
 Provides type-safe action decorators with consistent styling.
 """
 
-from typing import Optional, Callable, Any
 from functools import wraps
+from typing import Any, Callable, Optional
+
 from unfold.decorators import action as unfold_action
 from unfold.enums import ActionVariant as UnfoldActionVariant
 
 from django_cfg.modules.django_logging import get_logger
-from ..models.action_models import ActionVariant
 
+from ..models.action_models import ActionVariant
 
 logger = get_logger("django_admin.decorators.actions")
 
@@ -66,13 +67,13 @@ def action(
             except Exception as e:
                 # Log error and show user message
                 logger.error(f"Error in action {func.__name__}: {e}")
-                
+
                 self.message_user(
                     request,
                     f"Error executing action: {str(e)}",
                     level='ERROR'
                 )
-        
+
         # Convert our ActionVariant to Unfold ActionVariant
         action_variant = None
         if variant:
@@ -86,7 +87,7 @@ def action(
                 ActionVariant.DANGER: UnfoldActionVariant.DANGER,
             }
             action_variant = unfold_variant_mapping.get(variant, UnfoldActionVariant.DEFAULT)
-        
+
         # Build decorator kwargs
         decorator_kwargs = {'description': description}
         if action_variant:
@@ -99,8 +100,8 @@ def action(
             decorator_kwargs['url_path'] = url_path
         if attrs:
             decorator_kwargs['attrs'] = attrs
-        
+
         # Apply Unfold decorator
         return unfold_action(**decorator_kwargs)(wrapper)
-    
+
     return decorator

django_cfg/modules/django_admin/decorators/display.py

@@ -4,10 +4,12 @@ Display decorator wrapper for Unfold integration.
 Provides type-safe display decorators with our admin utilities.
 """
 
-from typing import Optional, Callable, Any, Union
 from functools import wraps
+from typing import Any, Callable, Optional, Union
+
 from django.utils.safestring import SafeString, mark_safe
 from unfold.decorators import display as unfold_display
+
 from django_cfg.modules.django_logging import get_logger
 
 logger = get_logger('django_admin.decorators.display')
@@ -65,25 +67,25 @@ def display(
         def wrapper(self, obj: Any) -> Any:
             try:
                 result = func(self, obj)
-                
+
                 # Handle empty values (use our default if unfold's empty_value is None)
                 if result is None or result == "":
                     return empty_value if empty_value is not None else "—"
-                
+
                 # Auto-mark HTML as safe if it contains HTML tags
                 if isinstance(result, str) and ('<' in result and '>' in result):
                     return mark_safe(result)
-                
+
                 # SafeString is already safe
                 if isinstance(result, SafeString):
                     return result
-                
+
                 return result
             except Exception as e:
                 # Log error and return safe fallback
                 logger.error(f"Error in display method {func.__name__}: {e}")
                 return empty_value if empty_value is not None else "—"
-        
+
         # Apply Unfold decorator with all parameters
         return unfold_display(
             function=None,  # We handle the function ourselves
@@ -96,7 +98,7 @@ def display(
             label=label,
             header=header
         )(wrapper)
-    
+
     # Support both @display and @display(...) usage
     if function is not None:
         # Direct usage: @display

django_cfg/modules/django_admin/icons/__init__.py

@@ -4,7 +4,7 @@ Material Icons for Django CFG Unfold.
 Provides IDE-friendly Material Design Icons constants.
 """
 
-from .constants import Icons, IconCategories
+from .constants import IconCategories, Icons
 
 __all__ = [
     'Icons',