django-cfg 1.1.82__py3-none-any.whl → 1.2.0__py3-none-any.whl

django_cfg/models/unfold.py

@@ -1,271 +0,0 @@
-"""
-Unfold Configuration Models for django_cfg.
-
-Provides type-safe configuration for Django Unfold admin interface.
-"""
-
-from typing import List, Optional, Dict, Any
-from pydantic import BaseModel, Field
-from django.urls import reverse_lazy, NoReverseMatch
-import base64
-
-from django_cfg.modules.unfold.tailwind import get_unfold_colors, get_css_variables
-
-class UnfoldColors(BaseModel):
-    """Unfold color theme configuration."""
-
-    primary: Optional[str] = Field(None, description="Primary color")
-    success: Optional[str] = Field(None, description="Success color")
-    warning: Optional[str] = Field(None, description="Warning color")
-    danger: Optional[str] = Field(None, description="Danger color")
-    info: Optional[str] = Field(None, description="Info color")
-
-
-class UnfoldSidebar(BaseModel):
-    """Unfold sidebar configuration."""
-
-    show_search: bool = Field(True, description="Show search in sidebar")
-    show_all_applications: bool = Field(True, description="Show all applications")
-    navigation: List[Dict[str, Any]] = Field(default_factory=list, description="Custom navigation")
-
-
-class NavigationItem(BaseModel):
-    """Single navigation item configuration."""
-
-    title: str = Field(..., description="Navigation item title")
-    icon: Optional[str] = Field(None, description="Material icon name")
-    link: Optional[str] = Field(None, description="Navigation link")
-    badge: Optional[str] = Field(None, description="Badge text")
-
-class NavigationGroup(BaseModel):
-    """Navigation group configuration."""
-
-    title: str = Field(..., description="Group title")
-    separator: bool = Field(True, description="Add separator before group")
-    collapsible: bool = Field(True, description="Group is collapsible")
-    items: List[NavigationItem] = Field(default_factory=list, description="Group items")
-
-
-class DropdownItem(BaseModel):
-    """Dropdown menu item configuration."""
-
-    title: str = Field(..., description="Item title")
-    icon: str = Field(..., description="Material icon name")
-    link: str = Field(..., description="Item URL")
-
-
-class QuickAction(BaseModel):
-    """Quick action configuration for dashboard."""
-
-    title: str = Field(..., description="Action title")
-    icon: str = Field(..., description="Material icon name")
-    url: str = Field(..., description="Action URL")
-    description: Optional[str] = Field(None, description="Action description")
-    color: Optional[str] = Field(None, description="Action color")
-
-
-def get_reverse_lazy(link: str) -> str:
-    try:
-        return reverse_lazy(link)
-    except NoReverseMatch:
-        return link
-
-
-class DashboardWidget(BaseModel):
-    """Dashboard widget configuration."""
-
-    title: str = Field(..., description="Widget title")
-    template: Optional[str] = Field(None, description="Custom template path")
-    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")
-
-
-class UnfoldTheme(BaseModel):
-    """Complete Unfold theme configuration."""
-
-    # Basic theme settings
-    site_title: str = Field("Django Admin", description="Site title")
-    site_header: str = Field("Django Administration", description="Site header")
-    site_url: str = Field("/", description="Site URL")
-    site_symbol: str = Field("rocket_launch", description="Material icon for site")
-
-    # UI settings
-    show_history: bool = Field(True, description="Show history in admin")
-    show_view_on_site: bool = Field(True, description="Show view on site links")
-    show_back_button: bool = Field(False, description="Show back button")
-
-    # Theme and appearance
-    theme: Optional[str] = Field(None, description="Theme: light, dark, or None for switcher")
-    colors: UnfoldColors = Field(default_factory=UnfoldColors, description="Color theme")
-    sidebar: UnfoldSidebar = Field(default_factory=UnfoldSidebar, description="Sidebar config")
-
-    # Dashboard
-    dashboard_callback: Optional[str] = Field(None, description="Dashboard callback function")
-    environment_callback: Optional[str] = Field(None, description="Environment callback function")
-
-    # Navigation
-    navigation: List[NavigationGroup] = Field(default_factory=list, description="Custom navigation")
-
-    # Site dropdown menu
-    site_dropdown: List[DropdownItem] = Field(default_factory=list, description="Site dropdown menu items")
-
-    # Quick actions and widgets
-    quick_actions: List[QuickAction] = Field(default_factory=list, description="Dashboard quick actions")
-    widgets: List[DashboardWidget] = Field(default_factory=list, description="Dashboard widgets")
-
-    def to_django_settings(self) -> Dict[str, Any]:
-        """Convert to Django UNFOLD settings."""
-        # Try to import colors, fallback to base colors if not available
-        colors = get_unfold_colors()
-
-        settings = {
-            "SITE_TITLE": self.site_title,
-            "SITE_HEADER": self.site_header,
-            "SITE_URL": self.site_url,
-            "SITE_SYMBOL": self.site_symbol,
-            "SHOW_HISTORY": self.show_history,
-            "SHOW_VIEW_ON_SITE": self.show_view_on_site,
-            "SHOW_BACK_BUTTON": self.show_back_button,
-            "COLORS": colors,
-            "BORDER_RADIUS": "8px",
-        }
-
-        # Theme settings
-        if self.theme:
-            settings["THEME"] = self.theme
-
-        # Sidebar configuration - KEY PART!
-        sidebar_config = {
-            "show_search": self.sidebar.show_search,
-            "command_search": True,
-            "show_all_applications": self.sidebar.show_all_applications,
-        }
-        
-        # Get default navigation from dashboard manager
-        from django_cfg.modules.unfold.dashboard import DashboardManager
-        dashboard = DashboardManager()
-        nav_items = dashboard.get_navigation_config()
-        
-        # 1. Add custom navigation from project (if defined)
-        if self.navigation:
-            # Project has custom navigation - add it first
-            for group in self.navigation:
-                group_dict = {
-                    "title": group.title,
-                    "separator": group.separator,
-                    "collapsible": group.collapsible,
-                    "items": [
-                        {
-                            "title": item.title,
-                            "icon": item.icon,
-                            "link": get_reverse_lazy(item.link),
-                        }
-                        for item in group.items
-                    ],
-                }
-                nav_items.append(group_dict)
-        
-        sidebar_config["navigation"] = nav_items
-
-        settings["SIDEBAR"] = sidebar_config
-
-        # Command interface
-        settings["COMMAND"] = {
-            "search_models": True,
-            "show_history": True,
-        }
-
-        # Multi-language support - DISABLED
-        settings["SHOW_LANGUAGES"] = False
-
-        # Site dropdown menu
-        if self.site_dropdown:
-            settings["SITE_DROPDOWN"] = [
-                {
-                    "icon": item.icon,
-                    "title": item.title,
-                    "link": item.link,
-                }
-                for item in self.site_dropdown
-            ]
-
-        # Dashboard callback
-        if self.dashboard_callback:
-            settings["DASHBOARD_CALLBACK"] = self.dashboard_callback
-
-        # Environment callback
-        if self.environment_callback:
-            settings["ENVIRONMENT_CALLBACK"] = self.environment_callback
-
-        return settings
-
-
-
-class UnfoldConfig(BaseModel):
-    """
-    Main Unfold configuration for django_cfg.
-
-    Usage:
-        unfold = UnfoldConfig(
-            theme=UnfoldTheme(
-                site_title="My Admin",
-                site_header="My Project Admin",
-            )
-        )
-    """
-
-    enabled: bool = Field(True, description="Enable Unfold admin interface")
-    theme: UnfoldTheme = Field(default_factory=UnfoldTheme, description="Unfold theme configuration")
-
-    # Additional settings that can be overridden
-    additional_settings: Dict[str, Any] = Field(default_factory=dict, description="Additional Django UNFOLD settings")
-
-    def to_django_settings(self) -> Dict[str, Any]:
-        """Generate Django settings for Unfold."""
-        if not self.enabled:
-            return {}
-
-        # Get base settings from theme
-        unfold_settings = self.theme.to_django_settings()
-
-        # Inject universal CSS variables (includes object-tools flex)
-        if "STYLES" not in unfold_settings:
-            unfold_settings["STYLES"] = []
-        
-        # Add our CSS as inline data URI
-        css_content = get_css_variables()
-        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)
-        
-        # Add Tailwind CSS CDN
-        if "SCRIPTS" not in unfold_settings:
-            unfold_settings["SCRIPTS"] = []
-        
-        # unfold_settings["SCRIPTS"].append(
-        #     lambda request: "https://cdn.tailwindcss.com/4.1.11"
-        # )
-
-        # Merge additional settings
-        unfold_settings.update(self.additional_settings)
-
-        return {"UNFOLD": unfold_settings}
-
-    def get_installed_apps(self) -> List[str]:
-        """Get required installed apps for Unfold."""
-        if not self.enabled:
-            return []
-
-        return [
-            "unfold",  # Must be before django.contrib.admin
-            "unfold.contrib.filters",  # Optional filters
-            "unfold.contrib.forms",  # Optional form elements
-            "unfold.contrib.inlines",  # Inline forms
-            "unfold.contrib.import_export",  # Import/export functionality
-            "unfold.contrib.guardian",  # Guardian permissions
-            "unfold.contrib.simple_history",  # Simple history
-            "unfold.contrib.location_field",  # Location fields
-            "unfold.contrib.constance",  # Constance integration
-        ]

django_cfg/modules/unfold/__init__.py

@@ -1,29 +0,0 @@
-"""
-Django CFG Unfold Module
-
-Complete Unfold admin interface integration with system monitoring,
-dashboard callbacks, and auto-configuration.
-"""
-
-from .system_monitor import SystemMonitor
-from .dashboard import DashboardManager
-from .callbacks import UnfoldCallbacks
-from .models import DashboardData, StatCard, SystemHealthItem, QuickAction
-
-# Export instances for easy import
-system_monitor = SystemMonitor()
-dashboard_manager = DashboardManager()
-unfold_callbacks = UnfoldCallbacks()
-
-__all__ = [
-    "SystemMonitor",
-    "DashboardManager", 
-    "UnfoldCallbacks",
-    "DashboardData",
-    "StatCard",
-    "SystemHealthItem",
-    "QuickAction",
-    "system_monitor",
-    "dashboard_manager",
-    "unfold_callbacks",
-]

django_cfg/modules/unfold/dashboard.py

@@ -1,318 +0,0 @@
-"""
-Dashboard Manager for Django CFG Unfold
-
-Manages dashboard configuration, widgets, and navigation
-based on the working configuration from the old version.
-"""
-
-from typing import List, Dict, Any, Optional
-from django.templatetags.static import static
-from django.urls import reverse_lazy
-from ..base import BaseModule
-
-
-class DashboardManager(BaseModule):
-    """
-    Dashboard configuration manager for Unfold.
-    
-    Based on the working configuration from @old/api__old/api/dashboard/unfold_config.py
-    """
-    
-    def __init__(self):
-        """Initialize dashboard manager."""
-        super().__init__()
-        self.config = self.get_config()
-    
-    def get_navigation_config(self) -> List[Dict[str, Any]]:
-        """Get complete default navigation configuration for Unfold sidebar."""
-        navigation = [
-            {
-                "title": "Dashboard",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Overview",
-                        "icon": "dashboard",
-                        "link": "/admin/",
-                    },
-                    {
-                        "title": "Settings",
-                        "icon": "settings",
-                        "link": '/admin/constance/config/',
-                    },
-                    {
-                        "title": "Health Check",
-                        "icon": "health_and_safety",
-                        "link": "/cfg/health/",
-                    },
-                ],
-            },
-        ]
-        
-        # Add Accounts section if enabled
-        if self.is_accounts_enabled():
-            navigation.append({
-                "title": "Users & Access",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Users",
-                        "icon": "people",
-                        "link": "/admin/django_cfg_accounts/customuser/",
-                    },
-
-                    {
-                        "title": "User Groups",
-                        "icon": "group",
-                        "link": "/admin/auth/group/",
-                    },
-                    {
-                        "title": "Registration Sources",
-                        "icon": "link",
-                        "link": "/admin/django_cfg_accounts/registrationsource/",
-                    },
-                    {
-                        "title": "User Registration Sources",
-                        "icon": "person",
-                        "link": "/admin/django_cfg_accounts/userregistrationsource/",
-                    },
-                ]
-            })
-        
-        # Add Support section if enabled
-        if self.is_support_enabled():
-            navigation.append({
-                "title": "Support",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Tickets",
-                        "icon": "support_agent",
-                        "link": "/admin/django_cfg_support/ticket/",
-                    },
-                    {
-                        "title": "Messages",
-                        "icon": "chat",
-                        "link": "/admin/django_cfg_support/message/",
-                    },
-                ]
-            })
-        
-        # Add Newsletter section if enabled
-        if self.is_newsletter_enabled():
-            navigation.append({
-                "title": "Newsletter",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Newsletters",
-                        "icon": "email",
-                        "link": "/admin/django_cfg_newsletter/newsletter/",
-                    },
-                    {
-                        "title": "Subscriptions",
-                        "icon": "person_add",
-                        "link": "/admin/django_cfg_newsletter/newslettersubscription/",
-                    },
-                    {
-                        "title": "Campaigns",
-                        "icon": "campaign",
-                        "link": "/admin/django_cfg_newsletter/newslettercampaign/",
-                    },
-                    {
-                        "title": "Email Logs",
-                        "icon": "mail_outline",
-                        "link": "/admin/django_cfg_newsletter/emaillog/",
-                    },
-                ]
-            })
-        
-        # Add Leads section if enabled
-        if self.is_leads_enabled():
-            navigation.append({
-                "title": "Leads",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Leads",
-                        "icon": "contact_page",
-                        "link": "/admin/django_cfg_leads/lead/",
-                    },
-                ]
-            })
-        
-        # Add Dramatiq section if enabled
-        if self.is_tasks_enabled():
-            navigation.append({
-                "title": "Background Tasks",
-                "separator": True,
-                "collapsible": True,
-                "items": [
-                    {
-                        "title": "Queue Dashboard",
-                        "icon": "dashboard",
-                        "link": "/cfg/tasks/dashboard/",
-                        "description": "Interactive queue management and monitoring",
-                    },
-                    {
-                        "title": "Task History",
-                        "icon": "history",
-                        "link": "/admin/django_dramatiq/task/",
-                        "description": "View task execution history and details",
-                    },
-                ]
-            })
-        
-        return navigation
-    
-    def _get_reverse_lazy(self, link: str) -> str:
-        """Safe reverse with fallback."""
-        try:
-            from django.urls import reverse
-            return reverse(link)
-        except Exception:
-            return link
-    
-    
-    def _get_user_admin_url(self) -> str:
-        """Get admin changelist URL for the current AUTH_USER_MODEL."""
-        try:
-            from django.contrib.auth import get_user_model
-            User = get_user_model()
-            app_label = User._meta.app_label
-            model_name = User._meta.model_name
-            # Return string URL, not reverse_lazy object
-            return f'/admin/{app_label}/{model_name}/'
-        except Exception:
-            # Universal fallback - return admin index instead of hardcoded model
-            return '/admin/'
-    
-    def get_unfold_config(self) -> Dict[str, Any]:
-        """Get complete Unfold configuration based on working old version."""
-        return {
-            # Site branding and appearance
-            "SITE_TITLE": "Admin",
-            "SITE_HEADER": "Admin",
-            "SITE_SUBHEADER": "",
-            "SITE_URL": "/",
-            "SITE_SYMBOL": "dashboard",
-            
-            # UI visibility controls
-            "SHOW_HISTORY": True,
-            "SHOW_VIEW_ON_SITE": True,
-            "SHOW_BACK_BUTTON": False,
-            
-            # Dashboard callback
-            "DASHBOARD_CALLBACK": "api.dashboard.callbacks.main_dashboard_callback",
-            
-            # Theme configuration
-            "THEME": None,  # Auto-detect or force "dark"/"light"
-            
-            # Login page customization
-            "LOGIN": {
-                "redirect_after": lambda request: "/admin/",
-            },
-            
-            # Design system
-            "BORDER_RADIUS": "8px",
-            "COLORS": {
-                "base": {
-                    "50": "249, 250, 251",
-                    "100": "243, 244, 246",
-                    "200": "229, 231, 235",
-                    "300": "209, 213, 219",
-                    "400": "156, 163, 175",
-                    "500": "107, 114, 128",
-                    "600": "75, 85, 99",
-                    "700": "55, 65, 81",
-                    "800": "31, 41, 55",
-                    "900": "17, 24, 39",
-                    "950": "3, 7, 18",
-                },
-                "primary": {
-                    "50": "239, 246, 255",
-                    "100": "219, 234, 254",
-                    "200": "191, 219, 254",
-                    "300": "147, 197, 253",
-                    "400": "96, 165, 250",
-                    "500": "59, 130, 246",
-                    "600": "37, 99, 235",
-                    "700": "29, 78, 216",
-                    "800": "30, 64, 175",
-                    "900": "30, 58, 138",
-                    "950": "23, 37, 84",
-                },
-                "font": {
-                    "subtle-light": "var(--color-base-500)",
-                    "subtle-dark": "var(--color-base-400)",
-                    "default-light": "var(--color-base-600)",
-                    "default-dark": "var(--color-base-300)",
-                    "important-light": "var(--color-base-900)",
-                    "important-dark": "var(--color-base-100)",
-                },
-            },
-            
-            # Sidebar navigation - KEY STRUCTURE!
-            "SIDEBAR": {
-                "show_search": True,
-                "command_search": True,
-                "show_all_applications": True,
-                "navigation": self.get_navigation_config(),
-            },
-            
-            # Site dropdown menu - moved to top level
-            "SITE_DROPDOWN": [
-                # {
-                #     "icon": "language",
-                #     "title": "Documentation",
-                #     "link": "https://docs.carapis.com",
-                # },
-            ],
-            
-            # Command interface
-            "COMMAND": {
-                "search_models": True,
-                "show_history": True,
-            },
-            
-            # Multi-language support - DISABLED
-            "SHOW_LANGUAGES": False,
-        }
-    
-    def get_widgets_config(self) -> List[Dict[str, Any]]:
-        """Get dashboard widgets configuration."""
-        return [
-            {
-                "type": "stats_cards",
-                "title": "System Overview",
-                "cards": [
-                    {
-                        "title": "CPU Usage",
-                        "value_template": "{{ cpu_percent }}%",
-                        "icon": "memory",
-                        "color": "blue",
-                    },
-                    {
-                        "title": "Memory Usage", 
-                        "value_template": "{{ memory_percent }}%",
-                        "icon": "storage",
-                        "color": "green",
-                    },
-                    {
-                        "title": "Disk Usage",
-                        "value_template": "{{ disk_percent }}%",
-                        "icon": "folder",
-                        "color": "orange",
-                    },
-                ]
-            },
-        ]
-
-
-# Create global instance for easy import
-dashboard_manager = DashboardManager()