django-cfg 1.4.20__py3-none-any.whl → 1.4.23__py3-none-any.whl

django_cfg/modules/django_unfold/models/config.py

@@ -4,14 +4,16 @@ Unfold Configuration Models
 Complete configuration models for Django Unfold admin interface.
 """
 
-from typing import List, Optional, Dict, Any, Callable
-from pydantic import BaseModel, Field, ConfigDict, field_validator
-from ...base import BaseCfgModule
-from .navigation import NavigationSection
+import logging
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+from django_cfg.modules.django_admin.icons import Icons
+
 from .dropdown import SiteDropdownItem
+from .navigation import NavigationSection
 from .tabs import TabConfiguration
-from django_cfg.modules.django_admin.icons import Icons
-import logging
 
 logger = logging.getLogger(__name__)
 
@@ -106,13 +108,13 @@ class UnfoldTheme(BaseModel):
             "command_search": True,
             "show_all_applications": self.sidebar.show_all_applications,
         }
-        
+
         # Start with custom navigation from project (if defined)
         nav_items = []
         if self.navigation:
             # Project has custom navigation - add it first
             nav_items.extend([group.to_dict() for group in self.navigation])
-        
+
         # Add default navigation from dashboard manager
         try:
             from ..dashboard import DashboardManager
@@ -121,7 +123,7 @@ class UnfoldTheme(BaseModel):
             nav_items.extend(default_nav_items)
         except ImportError:
             pass
-        
+
         sidebar_config["navigation"] = nav_items
         settings["SIDEBAR"] = sidebar_config
 
@@ -162,138 +164,138 @@ class UnfoldConfig(BaseModel):
     navigation, theming, and callback support.
     """
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     # Site branding
     site_title: str = Field(
         default="Django-CFG Admin",
         description="Site title shown in admin"
     )
-    
+
     site_header: str = Field(
         default="Django Config Toolkit",
         description="Site header text"
     )
-    
+
     site_subheader: str = Field(
         default="🚀 Type-safe Django Configuration",
         description="Site subheader text"
     )
-    
+
     site_symbol: str = Field(
         default="settings",
         description="Material icon symbol for site"
     )
-    
+
     site_url: str = Field(
         default="/",
         description="Site URL"
     )
-    
+
     # UI settings
     show_history: bool = Field(
         default=True,
         description="Show history in admin"
     )
-    
+
     show_view_on_site: bool = Field(
         default=True,
         description="Show 'View on site' links"
     )
-    
+
     show_back_button: bool = Field(
         default=False,
         description="Show back button in admin"
     )
-    
+
     # Theme settings
     theme: Optional[str] = Field(
         default=None,
         description="Theme setting (light/dark/auto)"
     )
-    
+
     border_radius: str = Field(
         default="8px",
         description="Border radius for UI elements"
     )
-    
+
     # Dashboard settings
     dashboard_enabled: bool = Field(
         default=True,
         description="Enable custom dashboard"
     )
-    
+
     dashboard_callback: Optional[str] = Field(
         default="django_cfg.routing.callbacks.dashboard_callback",
         description="Dashboard callback function path"
     )
-    
+
     environment_callback: Optional[str] = Field(
         default="django_cfg.routing.callbacks.environment_callback",
         description="Environment callback function path"
     )
-    
+
     # Navigation settings
     show_search: bool = Field(
         default=True,
         description="Show search in sidebar"
     )
-    
+
     command_search: bool = Field(
         default=True,
         description="Enable command search"
     )
-    
+
     show_all_applications: bool = Field(
         default=True,
         description="Show all applications in sidebar"
     )
-    
+
     # Multi-language settings
     show_languages: bool = Field(
         default=False,
         description="Show language switcher"
     )
-    
+
     # Colors configuration
     colors: Optional[UnfoldColors] = Field(
         default=None,
         description="Color theme configuration"
     )
-    
+
     # Sidebar configuration
     sidebar: Optional[UnfoldSidebar] = Field(
         default=None,
         description="Sidebar configuration"
     )
-    
+
     # Navigation items
     navigation: List[NavigationSection] = Field(
         default_factory=list,
         description="Custom navigation sections"
     )
-    
+
     navigation_items: List[Dict[str, Any]] = Field(
         default_factory=list,
         description="Custom navigation items (legacy)"
     )
-    
+
     # Site dropdown items
     site_dropdown: List[SiteDropdownItem] = Field(
         default_factory=list,
         description="Site dropdown menu items"
     )
-    
+
     site_dropdown_items: List[Dict[str, Any]] = Field(
         default_factory=list,
         description="Site dropdown menu items (legacy)"
     )
-    
+
     # Tab configurations
     tab_configurations: List[Dict[str, Any]] = Field(
         default_factory=list,
         description="Tab configurations for admin"
     )
-    
+
     @field_validator('theme')
     @classmethod
     def validate_theme(cls, v: Optional[str]) -> Optional[str]:
@@ -301,19 +303,19 @@ class UnfoldConfig(BaseModel):
         if v and v not in ['light', 'dark', 'auto']:
             raise ValueError("Theme must be 'light', 'dark', 'auto', or None")
         return v
-    
+
     def get_color_scheme(self) -> Dict[str, Any]:
         """Get Unfold semantic color scheme configuration with theme support."""
         return {
             # Base semantic colors that auto-adapt to theme
             "base": {
                 "50": "248, 250, 252",   # Light theme: very light background
-                "100": "241, 245, 249",  # Light theme: light background  
+                "100": "241, 245, 249",  # Light theme: light background
                 "200": "226, 232, 240",  # Light theme: subtle border
                 "300": "203, 213, 225",  # Light theme: border
                 "400": "148, 163, 184",  # Light theme: muted text / Dark theme: text
                 "500": "100, 116, 139",  # Neutral - works in both themes
-                "600": "71, 85, 105",    # Dark theme: muted text / Light theme: text  
+                "600": "71, 85, 105",    # Dark theme: muted text / Light theme: text
                 "700": "51, 65, 85",     # Dark theme: border
                 "800": "30, 41, 59",     # Dark theme: subtle border
                 "900": "15, 23, 42",     # Dark theme: light background
@@ -322,7 +324,7 @@ class UnfoldConfig(BaseModel):
             # Primary brand - auto-adapts via CSS variables
             "primary": {
                 "50": "239, 246, 255",
-                "100": "219, 234, 254", 
+                "100": "219, 234, 254",
                 "200": "191, 219, 254",
                 "300": "147, 197, 253",
                 "400": "96, 165, 250",
@@ -337,7 +339,7 @@ class UnfoldConfig(BaseModel):
             "success": {
                 "50": "236, 253, 245",
                 "100": "209, 250, 229",
-                "200": "167, 243, 208", 
+                "200": "167, 243, 208",
                 "300": "110, 231, 183",
                 "400": "52, 211, 153",
                 "500": "16, 185, 129",   # Main success color
@@ -347,12 +349,12 @@ class UnfoldConfig(BaseModel):
                 "900": "6, 78, 59",
                 "950": "2, 44, 34",
             },
-            # Warning semantic color  
+            # Warning semantic color
             "warning": {
                 "50": "255, 251, 235",
                 "100": "254, 243, 199",
                 "200": "253, 230, 138",
-                "300": "252, 211, 77", 
+                "300": "252, 211, 77",
                 "400": "251, 191, 36",
                 "500": "245, 158, 11",   # Main warning color
                 "600": "217, 119, 6",
@@ -367,7 +369,7 @@ class UnfoldConfig(BaseModel):
                 "100": "254, 226, 226",
                 "200": "254, 202, 202",
                 "300": "252, 165, 165",
-                "400": "248, 113, 113", 
+                "400": "248, 113, 113",
                 "500": "239, 68, 68",    # Main danger color
                 "600": "220, 38, 38",
                 "700": "185, 28, 28",
@@ -383,14 +385,14 @@ class UnfoldConfig(BaseModel):
                 "300": "103, 232, 249",
                 "400": "34, 211, 238",
                 "500": "6, 182, 212",    # Main info color
-                "600": "8, 145, 178", 
+                "600": "8, 145, 178",
                 "700": "14, 116, 144",
                 "800": "21, 94, 117",
                 "900": "22, 78, 99",
                 "950": "8, 51, 68",
             },
         }
-    
+
     def to_django_settings(self) -> Dict[str, Any]:
         """Generate Django settings for Unfold."""
         # Base Unfold configuration
@@ -408,28 +410,28 @@ class UnfoldConfig(BaseModel):
             "SHOW_LANGUAGES": self.show_languages,
             "COLORS": self.get_color_scheme(),
         }
-        
+
         # Add callbacks if configured
         if self.dashboard_callback:
             unfold_settings["DASHBOARD_CALLBACK"] = self.dashboard_callback
-        
+
         if self.environment_callback:
             unfold_settings["ENVIRONMENT"] = self.environment_callback
-        
+
         # Sidebar configuration
         sidebar_config = {
             "show_search": self.show_search,
             "command_search": self.command_search,
             "show_all_applications": self.show_all_applications,
         }
-        
+
         # Get default navigation from dashboard manager first
         nav_items = []
         try:
             from ..dashboard import DashboardManager
             dashboard = DashboardManager()
             nav_items = dashboard.get_navigation_config()
-        except Exception as e:
+        except Exception:
             # Catch all exceptions including circular imports during settings generation
             # During settings generation, config discovery may fail - use empty nav
             pass
@@ -441,10 +443,10 @@ class UnfoldConfig(BaseModel):
         # Add legacy navigation_items if configured
         if self.navigation_items:
             nav_items.extend(self.navigation_items)
-        
+
         sidebar_config["navigation"] = nav_items
         unfold_settings["SIDEBAR"] = sidebar_config
-        
+
         # Add site dropdown - combine default from dashboard + project dropdown
         dropdown_items = []
 
@@ -454,20 +456,20 @@ class UnfoldConfig(BaseModel):
             dropdown_items.extend(DashboardManager._get_default_dropdown_items())
         except (ImportError, Exception):
             pass
-        
+
         # Then add project-specific dropdown items
         if self.site_dropdown:
             dropdown_items.extend([item.to_dict() for item in self.site_dropdown])
         elif self.site_dropdown_items:
             dropdown_items.extend(self.site_dropdown_items)
-        
+
         if dropdown_items:
             unfold_settings["SITE_DROPDOWN"] = dropdown_items
-        
+
         # Add tabs if configured
         if self.tab_configurations:
             unfold_settings["TABS"] = self.tab_configurations
-        
+
         # Command interface - Enhanced for better UX
         unfold_settings["COMMAND"] = {
             "search_models": True,
@@ -478,38 +480,39 @@ class UnfoldConfig(BaseModel):
         # Inject universal CSS variables and custom styles
         if "STYLES" not in unfold_settings:
             unfold_settings["STYLES"] = []
-        
+
         # Add our CSS as inline data URI
         try:
-            from ..tailwind import get_css_variables, get_modal_fix_css
             import base64
-            
+
+            from ..tailwind import get_css_variables, get_modal_fix_css
+
             # Base CSS variables
             css_content = get_css_variables()
-            
+
             # Add modal scroll fix CSS
             css_content += get_modal_fix_css()
-            
+
             css_b64 = base64.b64encode(css_content.encode('utf-8')).decode('utf-8')
             data_uri = f"data:text/css;base64,{css_b64}"
             unfold_settings["STYLES"].append(lambda request: data_uri)
         except ImportError:
             pass
-        
+
         return {"UNFOLD": unfold_settings}
 
 
 class UnfoldDashboardConfig(BaseModel):
     """Complete Unfold dashboard configuration."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     # Site branding
     site_title: str = Field(default="Admin Dashboard", description="Site title")
-    site_header: str = Field(default="Admin", description="Site header") 
+    site_header: str = Field(default="Admin", description="Site header")
     site_subheader: str = Field(default="Management Interface", description="Site subheader")
     site_url: str = Field(default="/", description="Site URL")
     site_symbol: str = Field(default=Icons.ADMIN_PANEL_SETTINGS, description="Site icon")
-    
+
     # UI settings
     show_history: bool = Field(default=True, description="Show history")
     show_view_on_site: bool = Field(default=True, description="Show view on site")
@@ -517,29 +520,29 @@ class UnfoldDashboardConfig(BaseModel):
     theme: Optional[str] = Field(default=None, description="Theme (light/dark) or None for theme switcher")
     show_languages: bool = Field(default=False, description="Show language switcher")
     show_theme_switcher: bool = Field(default=True, description="Show theme switcher (requires theme=None)")
-    
+
     # Callbacks
     dashboard_callback: Optional[str] = Field(None, description="Dashboard callback path")
     environment_callback: Optional[str] = Field(None, description="Environment callback path")
-    
+
     # Navigation configuration
     navigation_sections: List[NavigationSection] = Field(
-        default_factory=list, 
+        default_factory=list,
         description="Navigation sections"
     )
-    
-    # Site dropdown configuration  
+
+    # Site dropdown configuration
     site_dropdown_items: List[SiteDropdownItem] = Field(
         default_factory=list,
         description="Site dropdown items"
     )
-    
+
     # Tab configurations
     tab_configurations: List[TabConfiguration] = Field(
         default_factory=list,
         description="Tab configurations"
     )
-    
+
     def to_unfold_dict(self) -> Dict[str, Any]:
         """Convert to Unfold configuration dictionary."""
         base_config = {
@@ -553,7 +556,7 @@ class UnfoldDashboardConfig(BaseModel):
             "SHOW_BACK_BUTTON": self.show_back_button,
             "SHOW_LANGUAGES": self.show_languages,
         }
-        
+
         # Theme configuration: None enables theme switcher, string value forces theme
         if self.show_theme_switcher and self.theme is None:
             # Don't set THEME key - this enables theme switcher
@@ -561,31 +564,31 @@ class UnfoldDashboardConfig(BaseModel):
         else:
             # Set specific theme - this disables theme switcher
             base_config["THEME"] = self.theme
-        
+
         # Add callbacks if configured
         if self.dashboard_callback:
             base_config["DASHBOARD_CALLBACK"] = self.dashboard_callback
-        
+
         if self.environment_callback:
             base_config["ENVIRONMENT"] = self.environment_callback
-        
+
         # Sidebar configuration
         sidebar_config = {
             "show_search": True,
             "command_search": True,
             "show_all_applications": True,
         }
-        
+
         # Convert navigation sections
         if self.navigation_sections:
             sidebar_config["navigation"] = [section.to_dict() for section in self.navigation_sections]
-        
+
         base_config["SIDEBAR"] = sidebar_config
-        
+
         # Convert site dropdown
         if self.site_dropdown_items:
             base_config["SITE_DROPDOWN"] = [item.to_dict() for item in self.site_dropdown_items]
-        
+
         # Convert tabs
         if self.tab_configurations:
             tabs = []
@@ -599,11 +602,11 @@ class UnfoldDashboardConfig(BaseModel):
                     if item.permission:
                         tab_item["permission"] = item.permission
                     tab_items.append(tab_item)
-                
+
                 tabs.append({
                     "models": tab.models,
                     "items": tab_items,
                 })
             base_config["TABS"] = tabs
-        
+
         return base_config

django_cfg/modules/django_unfold/models/dashboard.py

@@ -4,14 +4,15 @@ Dashboard Components Models for Unfold
 Pydantic models for dashboard components like stat cards, health items, etc.
 """
 
-from typing import List, Optional, Dict, Any, Literal
-from pydantic import BaseModel, Field, ConfigDict, computed_field
+from typing import Any, Dict, List, Literal, Optional
+
+from pydantic import BaseModel, ConfigDict, Field, computed_field
 
 
 class StatCard(BaseModel):
     """Dashboard statistics card model."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     title: str = Field(..., description="Card title")
     value: str = Field(..., description="Main value to display")
     icon: str = Field(..., description="Material icon name")
@@ -19,7 +20,7 @@ class StatCard(BaseModel):
     change_type: Literal["positive", "negative", "neutral"] = Field(default="neutral", description="Change type")
     description: Optional[str] = Field(None, description="Additional description")
     color: str = Field("primary", description="Card color theme")
-    
+
     @computed_field
     @property
     def css_classes(self) -> Dict[str, str]:
@@ -29,7 +30,7 @@ class StatCard(BaseModel):
             "negative": "text-red-600 bg-red-100 dark:bg-red-900/20 dark:text-red-400",
             "neutral": "text-slate-600 bg-slate-100 dark:bg-slate-700 dark:text-slate-400"
         }
-    
+
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary for Unfold dashboard widgets."""
         return {
@@ -46,33 +47,33 @@ class StatCard(BaseModel):
 class SystemHealthItem(BaseModel):
     """System health status item."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     component: str = Field(..., description="Component name")
     status: Literal["healthy", "warning", "error", "unknown"] = Field(..., description="Health status")
     description: str = Field(..., description="Status description")
     last_check: str = Field(..., description="Last check time")
     health_percentage: Optional[int] = Field(None, description="Health percentage (0-100)")
-    
+
     @computed_field
     @property
     def icon(self) -> str:
         """Get icon based on component type."""
         icons = {
             "database": "storage",
-            "cache": "memory", 
+            "cache": "memory",
             "queue": "queue",
             "storage": "folder",
             "api": "api",
         }
         return icons.get(self.component.lower(), "info")
-    
+
     @computed_field
     @property
     def status_icon(self) -> str:
         """Get status icon."""
         icons = {
             "healthy": "check_circle",
-            "warning": "warning", 
+            "warning": "warning",
             "error": "error",
             "unknown": "help"
         }
@@ -82,7 +83,7 @@ class SystemHealthItem(BaseModel):
 class QuickAction(BaseModel):
     """Quick action button model."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     title: str = Field(..., description="Action title")
     description: str = Field(..., description="Action description")
     icon: str = Field(..., description="Material icon name")
@@ -128,7 +129,7 @@ class DashboardWidget(BaseModel):
     callback: Optional[str] = Field(None, description="Callback function path")
     width: int = Field(12, description="Widget width (1-12)")
     order: int = Field(0, description="Widget order")
-    
+
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary for Unfold dashboard widgets."""
         return {
@@ -143,11 +144,11 @@ class DashboardWidget(BaseModel):
 class StatsCardsWidget(BaseModel):
     """Stats cards widget for dashboard."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     type: Literal["stats_cards"] = Field(default="stats_cards", description="Widget type")
     title: str = Field(..., description="Widget title")
     cards: List[StatCard] = Field(default_factory=list, description="Statistics cards")
-    
+
     def to_dict(self) -> Dict[str, Any]:
         """Convert to dictionary for Unfold dashboard widgets."""
         return {
@@ -179,20 +180,20 @@ class ChartData(BaseModel):
 class DashboardData(BaseModel):
     """Main dashboard data container."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     # Statistics cards
     stat_cards: List[StatCard] = Field(default_factory=list, description="Dashboard statistics cards")
-    
+
     # System health
     system_health: List[SystemHealthItem] = Field(default_factory=list, description="System health items")
-    
+
     # Quick actions
     quick_actions: List[QuickAction] = Field(default_factory=list, description="Quick action buttons")
-    
+
     # Additional data
     last_updated: str = Field(..., description="Last update timestamp")
     environment: str = Field("development", description="Current environment")
-    
+
     @computed_field
     @property
     def total_users(self) -> int:

django_cfg/modules/django_unfold/models/dropdown.py

@@ -4,15 +4,17 @@ Site Dropdown Models for Unfold Dashboard
 Pydantic models for site dropdown menu items.
 """
 
-from typing import Union, Callable
-from pydantic import BaseModel, Field, ConfigDict, computed_field
+from typing import Callable, Union
+
+from pydantic import BaseModel, ConfigDict, Field, computed_field
+
 from ..utils import auto_resolve_url
 
 
 class SiteDropdownItem(BaseModel):
     """Site dropdown menu item configuration with automatic URL resolution."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     title: str = Field(..., min_length=1, description="Menu item title")
     icon: str = Field(..., min_length=1, description="Material icon name")
     link: str = Field(..., min_length=1, description="Link URL or URL name")
@@ -28,7 +30,7 @@ class SiteDropdownItem(BaseModel):
     def get_link_for_unfold(self):
         """Get the link in the format expected by Unfold."""
         return self.resolved_link
-    
+
     def to_dict(self) -> dict:
         """Convert to dictionary for Unfold admin."""
         return {