django-cfg 1.3.11__py3-none-any.whl → 1.4.0__py3-none-any.whl

django_cfg/core/generation/utils/helpers.py

@@ -0,0 +1,32 @@
+"""
+Helper utilities for settings generation.
+
+Common functions used across multiple generators.
+"""
+
+from typing import Dict, Any
+
+
+def merge_settings(*settings_dicts: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Merge multiple settings dictionaries.
+
+    Later dictionaries override earlier ones.
+
+    Args:
+        *settings_dicts: Settings dictionaries to merge
+
+    Returns:
+        Merged settings dictionary
+
+    Example:
+        >>> merge_settings({"A": 1}, {"B": 2}, {"A": 3})
+        {"A": 3, "B": 2}
+    """
+    result = {}
+    for settings in settings_dicts:
+        result.update(settings)
+    return result
+
+
+__all__ = ["merge_settings"]

django_cfg/core/integration/__init__.py

@@ -16,23 +16,22 @@ _startup_info_shown = False
 
 def print_startup_info():
     """Print startup information based on config.startup_info_mode."""
-    # Skip startup info in development mode to avoid hot reload spam
-    try:
-        from django.conf import settings
-        if settings.DEBUG:
-            return
-    except Exception:
-        pass
-    
-    try:
-        manager = StartupDisplayManager()
-        manager.display_startup_info()
-            
-    except Exception as e:
-        import traceback
-        print(f"❌ ERROR in print_startup_info: {e}")
-        print("🔍 TRACEBACK:")
-        traceback.print_exc()
+    global _startup_info_shown
+
+    # Skip if already shown (prevents spam on hot reload)
+    if _startup_info_shown:
+        return
+
+    # Only show in the actual worker process (not in autoreload parent process)
+    # RUN_MAIN is set by Django's autoreloader in the worker process
+    if os.environ.get('RUN_MAIN') != 'true':
+        return
+
+    # Mark as shown to prevent duplicate display on subsequent hot reloads
+    _startup_info_shown = True
+
+    manager = StartupDisplayManager()
+    manager.display_startup_info()
 
 def reset_startup_info_flag():
     """Reset the startup info display flag. Useful for testing or manual reset."""
@@ -41,14 +40,8 @@ def reset_startup_info_flag():
 
 def print_ngrok_tunnel_info(tunnel_url: str):
     """Print ngrok tunnel information after tunnel is established."""
-    try:
-        manager = NgrokDisplayManager()
-        manager.display_tunnel_info(tunnel_url)
-    except Exception as e:
-        import traceback
-        print(f"❌ ERROR in print_ngrok_tunnel_info: {e}")
-        print("🔍 TRACEBACK:")
-        traceback.print_exc()
+    manager = NgrokDisplayManager()
+    manager.display_tunnel_info(tunnel_url)
 
 from .version_checker import get_version_info, get_latest_version, get_current_version
 from .commands_collector import get_all_commands, get_command_count, get_commands_with_descriptions

django_cfg/core/integration/display/startup.py

@@ -20,145 +20,158 @@ class StartupDisplayManager(BaseDisplayManager):
     
     def display_startup_info(self):
         """Display startup information based on config.startup_info_mode."""
-        try:
-            if not self.config:
-                return
-            
-            # Always check and display ngrok info first if active
-            self.ngrok_manager.display_if_active()
-            
-            from django_cfg.core.config import StartupInfoMode
-            mode = self.config.startup_info_mode
-            
-            if mode == StartupInfoMode.NONE:
-                self.display_minimal_info()
-            elif mode == StartupInfoMode.SHORT:
-                self.display_essential_info()
-            elif mode == StartupInfoMode.FULL:
-                self.display_complete_info()
-                
-        except Exception:
-            # Silently fail - startup info is not critical
-            pass
+        if not self.config:
+            return
+
+        # Always check and display ngrok info first if active
+        self.ngrok_manager.display_if_active()
+
+        from django_cfg.core.config import StartupInfoMode
+        mode = self.config.startup_info_mode
+
+        if mode == StartupInfoMode.NONE:
+            self.display_minimal_info()
+        elif mode == StartupInfoMode.SHORT:
+            self.display_essential_info()
+        elif mode == StartupInfoMode.FULL:
+            self.display_complete_info()
     
     def display_minimal_info(self):
         """Display minimal startup info (NONE mode)."""
-        version = self.get_version()
-        panel_style, env_emoji, env_color = self.get_environment_style()
-        
-        # Simple one-liner
-        info_text = Text()
-        info_text.append(f"{env_emoji} Django CFG ", style="bold")
-        info_text.append(f"v{version}", style="cyan")
-        info_text.append(" • ", style="dim")
-        info_text.append(f"{self.config.env_mode}", style=env_color)
-        info_text.append(" • ", style="dim")
-        info_text.append(f"{self.config.project_name}", style="white")
-        
-        # Check for critical updates
         try:
-            from ..version_checker import get_version_info
-            version_info = get_version_info()
-            if version_info.get('update_available'):
-                info_text.append(" • ", style="dim")
-                info_text.append("🚨 UPDATE AVAILABLE", style="bold yellow")
-                info_text.append(" (", style="dim")
-                info_text.append("poetry add django-cfg@latest", style="bright_blue")
-                info_text.append(")", style="dim")
-        except Exception:
-            pass
-        
-        self.console.print(info_text)
+            version = self.get_version()
+            panel_style, env_emoji, env_color = self.get_environment_style()
+
+            # Simple one-liner
+            info_text = Text()
+            info_text.append(f"{env_emoji} Django CFG ", style="bold")
+            info_text.append(f"v{version}", style="cyan")
+            info_text.append(" • ", style="dim")
+            info_text.append(f"{self.config.env_mode}", style=env_color)
+            info_text.append(" • ", style="dim")
+            info_text.append(f"{self.config.project_name}", style="white")
+
+            # Check for critical updates
+            try:
+                from ..version_checker import get_version_info
+                version_info = get_version_info()
+                if version_info.get('update_available'):
+                    info_text.append(" • ", style="dim")
+                    info_text.append("🚨 UPDATE AVAILABLE", style="bold yellow")
+                    info_text.append(" (", style="dim")
+                    info_text.append("poetry add django-cfg@latest", style="bright_blue")
+                    info_text.append(")", style="dim")
+            except Exception:
+                pass
+
+            self.console.print(info_text)
+        except Exception as e:
+            import traceback
+            print(f"❌ ERROR in display_minimal_info: {e}")
+            print("🔍 TRACEBACK:")
+            traceback.print_exc()
     
     def display_essential_info(self):
         """Display essential startup info (SHORT mode)."""
-        version = self.get_version()
-        panel_style, env_emoji, env_color = self.get_environment_style()
-        
-        # Create compact header
-        header_text = Text()
-        header_text.append(f"{env_emoji} Django CFG ", style="bold")
-        header_text.append(f"v{version}", style="cyan")
-        header_text.append(" • ", style="dim")
-        header_text.append(f"{self.config.env_mode}", style=env_color)
-        header_text.append(" • ", style="dim")
-        header_text.append(f"{self.config.project_name}", style="white")
-        
-        header_panel = self.create_panel(
-            header_text,
-            title="",
-            border_style=panel_style,
-            width=None
-        )
-        header_panel.padding = (0, 1)  # Override padding for header
-        self.console.print(header_panel)
-        
-        # Check for updates first
-        self._display_update_notification_short()
-        
-        # Create columns for essential info
-        self._display_essential_columns()
+        try:
+            version = self.get_version()
+            panel_style, env_emoji, env_color = self.get_environment_style()
+
+            # Create compact header
+            header_text = Text()
+            header_text.append(f"{env_emoji} Django CFG ", style="bold")
+            header_text.append(f"v{version}", style="cyan")
+            header_text.append(" • ", style="dim")
+            header_text.append(f"{self.config.env_mode}", style=env_color)
+            header_text.append(" • ", style="dim")
+            header_text.append(f"{self.config.project_name}", style="white")
+
+            header_panel = self.create_panel(
+                header_text,
+                title="",
+                border_style=panel_style,
+                width=None
+            )
+            header_panel.padding = (0, 1)  # Override padding for header
+            self.console.print(header_panel)
+
+            # Check for updates first
+            self._display_update_notification_short()
+
+            # Create columns for essential info
+            self._display_essential_columns()
+        except Exception as e:
+            import traceback
+            print(f"❌ ERROR in display_essential_info: {e}")
+            print("🔍 TRACEBACK:")
+            traceback.print_exc()
     
     def display_complete_info(self):
         """Display complete startup info (FULL mode)."""
-        version = self.get_version()
-        panel_style, env_emoji, env_color = self.get_environment_style()
-        
-        # Get library info
-        from django_cfg.config import (
-            LIB_NAME, LIB_SITE_URL, LIB_DOCS_URL, LIB_GITHUB_URL, 
-            LIB_SUPPORT_URL, LIB_HEALTH_URL
-        )
-        
-        # Create main info table
-        info_table = self.create_table()
-        info_table.add_column("Setting", style="cyan", width=30)
-        info_table.add_column("Value", style="white")
-        
-        info_table.add_row("📦 Version", version)
-        info_table.add_row("🔗 Prefix", "/cfg/")
-        info_table.add_row("🌍 Environment", self.config.env_mode)
-        info_table.add_row("🔧 Debug", str(self.config.debug))
-        info_table.add_row("🏗️ Project", self.config.project_name)
-        
-        # Add environment source
-        env_source = getattr(self.config, 'env_mode', 'default_fallback')
-        info_table.add_row("🔍 Env Source", env_source)
-        
-        info_table.add_row("🌐 Site", LIB_SITE_URL)
-        info_table.add_row("📚 Docs", LIB_DOCS_URL)
-        info_table.add_row("🐙 GitHub", LIB_GITHUB_URL)
-        info_table.add_row("🆘 Support", LIB_SUPPORT_URL)
-        
-        # Use full URL for health endpoint
-        health_url = f"{self.get_base_url()}/cfg/health/"
-        info_table.add_row("❤️ Health", health_url)
-        
-        # Create main panel with full width
-        main_panel = self.create_full_width_panel(
-            info_table,
-            title=f"{env_emoji} Django CFG Configuration",
-            border_style=panel_style
-        )
-        
-        self.console.print(main_panel)
-        
-        # Check for updates
-        self._display_update_notification_full()
-        
-        # Create columns for apps and endpoints
-        self._display_main_columns()
-        
-        # App-specific configuration panels
-        self._display_config_panels()
-        
-        # Revolution info
-        self._display_revolution_info()
-        
-        # Management commands
-        self._display_commands_info()
-        
-        self.print_spacing()
+        try:
+            version = self.get_version()
+            panel_style, env_emoji, env_color = self.get_environment_style()
+
+            # Get library info
+            from django_cfg.config import (
+                LIB_NAME, LIB_SITE_URL, LIB_DOCS_URL, LIB_GITHUB_URL,
+                LIB_SUPPORT_URL, LIB_HEALTH_URL
+            )
+
+            # Create main info table
+            info_table = self.create_table()
+            info_table.add_column("Setting", style="cyan", width=30)
+            info_table.add_column("Value", style="white")
+
+            info_table.add_row("📦 Version", version)
+            info_table.add_row("🔗 Prefix", "/cfg/")
+            info_table.add_row("🌍 Environment", self.config.env_mode)
+            info_table.add_row("🔧 Debug", str(self.config.debug))
+            info_table.add_row("🏗️ Project", self.config.project_name)
+
+            # Add environment source
+            env_source = getattr(self.config, 'env_mode', 'default_fallback')
+            info_table.add_row("🔍 Env Source", env_source)
+
+            info_table.add_row("🌐 Site", LIB_SITE_URL)
+            info_table.add_row("📚 Docs", LIB_DOCS_URL)
+            info_table.add_row("🐙 GitHub", LIB_GITHUB_URL)
+            info_table.add_row("🆘 Support", LIB_SUPPORT_URL)
+
+            # Use full URL for health endpoint
+            health_url = f"{self.get_base_url()}/cfg/health/"
+            info_table.add_row("❤️ Health", health_url)
+
+            # Create main panel with full width
+            main_panel = self.create_full_width_panel(
+                info_table,
+                title=f"{env_emoji} Django CFG Configuration",
+                border_style=panel_style
+            )
+
+            self.console.print(main_panel)
+
+            # Check for updates
+            self._display_update_notification_full()
+
+            # Create columns for apps and endpoints
+            self._display_main_columns()
+
+            # App-specific configuration panels
+            self._display_config_panels()
+
+            # Revolution info
+            self._display_revolution_info()
+
+            # Management commands
+            self._display_commands_info()
+
+            self.print_spacing()
+        except Exception as e:
+            import traceback
+            print(f"❌ ERROR in display_complete_info: {e}")
+            print("🔍 TRACEBACK:")
+            traceback.print_exc()
     
     def _display_update_notification_short(self):
         """Display update notification for SHORT mode."""
@@ -223,10 +236,10 @@ class StartupDisplayManager(BaseDisplayManager):
     def _display_essential_columns(self):
         """Display essential info in columns for SHORT mode."""
         # Enabled apps
-        enabled_apps = self.config.get_enabled_apps() or []
+        enabled_apps = self.config.get_installed_apps() if hasattr(self.config, 'get_installed_apps') else []
         apps_table = self.create_table()
         apps_table.add_column("App", style="bright_blue")
-        
+
         for app in enabled_apps[:5]:  # Limit for SHORT mode
             app_name = app.split('.')[-1]
             apps_table.add_row(f"• {app_name}")
@@ -251,10 +264,10 @@ class StartupDisplayManager(BaseDisplayManager):
     def _display_main_columns(self):
         """Display main columns (apps and endpoints) for FULL mode."""
         # Enabled apps
-        enabled_apps = self.config.get_enabled_apps() or []
+        enabled_apps = self.config.get_installed_apps() if hasattr(self.config, 'get_installed_apps') else []
         apps_table = self.create_table()
         apps_table.add_column("App", style="bright_blue")
-        
+
         for app in enabled_apps:
             app_name = app.split('.')[-1]
             apps_table.add_row(f"• {app_name}")

django_cfg/core/integration/url_integration.py

@@ -53,14 +53,25 @@ def add_django_cfg_urls(urlpatterns: List[URLPattern], cfg_prefix: str = "cfg/")
     except ImportError:
         # Django Revolution not available - skip
         pass
-    
+
+    # Add django-browser-reload URLs in development (if installed)
+    if settings.DEBUG:
+        try:
+            import django_browser_reload
+            new_patterns = new_patterns + [
+                path("__reload__/", include("django_browser_reload.urls")),
+            ]
+        except ImportError:
+            # django-browser-reload not installed - skip
+            pass
+
     # Show startup info based on config
     try:
         from . import print_startup_info
         print_startup_info()
     except ImportError:
         pass
-    
+
     return new_patterns
 
 

django_cfg/core/services/__init__.py

@@ -0,0 +1,5 @@
+"""Services for configuration management."""
+
+from .config_service import ConfigService
+
+__all__ = ["ConfigService"]

django_cfg/core/services/config_service.py

@@ -0,0 +1,121 @@
+"""
+Configuration service coordinating all builders.
+
+Facade pattern: Provides simple API to DjangoConfig while delegating
+to specialized builders for actual work.
+
+Size: ~100 lines (pure coordination, no business logic)
+"""
+
+from typing import List, Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..base.config_model import DjangoConfig
+    from ..builders.apps_builder import InstalledAppsBuilder
+    from ..builders.middleware_builder import MiddlewareBuilder
+    from ..builders.security_builder import SecurityBuilder
+
+
+class ConfigService:
+    """
+    Facade service coordinating all configuration builders.
+
+    This service:
+    - Lazy-loads builders on demand
+    - Provides simple API for DjangoConfig
+    - Coordinates multiple builders
+
+    Example:
+        ```python
+        service = ConfigService(config)
+        apps = service.get_installed_apps()
+        middleware = service.get_middleware()
+        ```
+    """
+
+    def __init__(self, config: "DjangoConfig"):
+        """
+        Initialize service with configuration.
+
+        Args:
+            config: DjangoConfig instance
+        """
+        self.config = config
+
+        # Lazy initialization of builders
+        self._apps_builder: Optional["InstalledAppsBuilder"] = None
+        self._middleware_builder: Optional["MiddlewareBuilder"] = None
+        self._security_builder: Optional["SecurityBuilder"] = None
+
+    @property
+    def apps_builder(self) -> "InstalledAppsBuilder":
+        """Lazy-load apps builder."""
+        if self._apps_builder is None:
+            from ..builders.apps_builder import InstalledAppsBuilder
+            self._apps_builder = InstalledAppsBuilder(self.config)
+        return self._apps_builder
+
+    @property
+    def middleware_builder(self) -> "MiddlewareBuilder":
+        """Lazy-load middleware builder."""
+        if self._middleware_builder is None:
+            from ..builders.middleware_builder import MiddlewareBuilder
+            self._middleware_builder = MiddlewareBuilder(self.config)
+        return self._middleware_builder
+
+    @property
+    def security_builder(self) -> "SecurityBuilder":
+        """Lazy-load security builder."""
+        if self._security_builder is None:
+            from ..builders.security_builder import SecurityBuilder
+            self._security_builder = SecurityBuilder(self.config)
+        return self._security_builder
+
+    def get_installed_apps(self) -> List[str]:
+        """
+        Get complete INSTALLED_APPS list.
+
+        Delegates to InstalledAppsBuilder.
+
+        Returns:
+            List of Django app labels
+
+        Example:
+            >>> service.get_installed_apps()
+            ['django.contrib.admin', 'django.contrib.auth', ...]
+        """
+        return self.apps_builder.build()
+
+    def get_middleware(self) -> List[str]:
+        """
+        Get complete MIDDLEWARE list.
+
+        Delegates to MiddlewareBuilder.
+
+        Returns:
+            List of middleware class paths
+
+        Example:
+            >>> service.get_middleware()
+            ['django.middleware.security.SecurityMiddleware', ...]
+        """
+        return self.middleware_builder.build()
+
+    def get_allowed_hosts(self) -> List[str]:
+        """
+        Get ALLOWED_HOSTS from security configuration.
+
+        Delegates to SecurityBuilder.
+
+        Returns:
+            List of allowed host patterns
+
+        Example:
+            >>> service.get_allowed_hosts()
+            ['localhost', '127.0.0.1', 'example.com']
+        """
+        return self.security_builder.build_allowed_hosts()
+
+
+# Export service
+__all__ = ["ConfigService"]

django_cfg/core/state/__init__.py

@@ -0,0 +1,9 @@
+"""Global state management for django-cfg."""
+
+from .registry import get_current_config, set_current_config, clear_current_config
+
+__all__ = [
+    "get_current_config",
+    "set_current_config",
+    "clear_current_config",
+]

django_cfg/core/state/registry.py

@@ -0,0 +1,84 @@
+"""
+Global configuration registry.
+
+Manages current DjangoConfig instance for thread-safe access.
+Extracted from original config.py for better organization.
+
+Size: ~60 lines (simple state management)
+"""
+
+from typing import Optional, TYPE_CHECKING
+import threading
+
+if TYPE_CHECKING:
+    from ..base.config_model import DjangoConfig
+
+# Thread-local storage for current config
+_thread_local = threading.local()
+
+# Global config (fallback if thread-local not set)
+_global_config: Optional["DjangoConfig"] = None
+
+
+def get_current_config() -> Optional["DjangoConfig"]:
+    """
+    Get currently active DjangoConfig instance.
+
+    Returns:
+        Current config instance, or None if not set
+
+    Example:
+        >>> config = get_current_config()
+        >>> if config:
+        ...     print(config.project_name)
+    """
+    # Try thread-local first
+    config = getattr(_thread_local, "config", None)
+    if config is not None:
+        return config
+
+    # Fall back to global
+    return _global_config
+
+
+def set_current_config(config: "DjangoConfig") -> None:
+    """
+    Set currently active DjangoConfig instance.
+
+    Args:
+        config: DjangoConfig instance to set as current
+
+    Example:
+        >>> config = DjangoConfig(project_name="My Project", ...)
+        >>> set_current_config(config)
+    """
+    global _global_config
+
+    # Set both thread-local and global
+    _thread_local.config = config
+    _global_config = config
+
+
+def clear_current_config() -> None:
+    """
+    Clear currently active config (useful for testing).
+
+    Example:
+        >>> clear_current_config()
+        >>> assert get_current_config() is None
+    """
+    global _global_config
+
+    # Clear both thread-local and global
+    if hasattr(_thread_local, "config"):
+        delattr(_thread_local, "config")
+
+    _global_config = None
+
+
+# Export functions
+__all__ = [
+    "get_current_config",
+    "set_current_config",
+    "clear_current_config",
+]