django-cfg 1.4.116__py3-none-any.whl → 1.5.14__py3-none-any.whl

django_cfg/core/builders/apps_builder.py

@@ -23,7 +23,6 @@ class InstalledAppsBuilder:
     - Combine default Django/third-party apps
     - Add django-cfg apps based on enabled features
     - Handle special ordering (accounts before admin)
-    - Auto-enable tasks if needed
     - Auto-detect dashboard apps from Unfold
     - Add project-specific apps
     - Remove duplicates while preserving order
@@ -55,7 +54,7 @@ class InstalledAppsBuilder:
             >>> config = DjangoConfig(enable_support=True)
             >>> builder = InstalledAppsBuilder(config)
             >>> apps = builder.build()
-            >>> "django_cfg.apps.support" in apps
+            >>> "django_cfg.apps.business.support" in apps
             True
         """
         apps = []
@@ -92,7 +91,7 @@ class InstalledAppsBuilder:
             if app == "django.contrib.admin":
                 # Insert accounts before admin if enabled (for proper migration order)
                 if self.config.enable_accounts:
-                    apps.append("django_cfg.apps.accounts")
+                    apps.append("django_cfg.apps.business.accounts")
             apps.append(app)
 
         return apps
@@ -109,36 +108,39 @@ class InstalledAppsBuilder:
             "django_cfg.modules.django_tailwind",  # Universal Tailwind layouts
             "django_cfg.apps.api.health",
             "django_cfg.apps.api.commands",
-            "django_cfg.apps.dashboard",  # Dashboard API
+            "django_cfg.apps.system.dashboard",  # Dashboard API
         ]
 
         if self.config.enable_frontend:
-            apps.append("django_cfg.apps.frontend")
+            apps.append("django_cfg.apps.system.frontend")
 
         # Add optional apps based on configuration
         if self.config.enable_support:
-            apps.append("django_cfg.apps.support")
+            apps.append("django_cfg.apps.business.support")
 
         if self.config.enable_newsletter:
-            apps.append("django_cfg.apps.newsletter")
+            apps.append("django_cfg.apps.business.newsletter")
 
         if self.config.enable_leads:
-            apps.append("django_cfg.apps.leads")
+            apps.append("django_cfg.apps.business.leads")
 
         if self.config.enable_knowbase:
-            apps.append("django_cfg.apps.knowbase")
+            apps.append("django_cfg.apps.business.knowbase")
 
         if self.config.enable_agents:
-            apps.append("django_cfg.apps.agents")
+            apps.append("django_cfg.apps.business.agents")
 
         if self.config.enable_maintenance:
-            apps.append("django_cfg.apps.maintenance")
+            apps.append("django_cfg.apps.system.maintenance")
 
         if self.config.payments and self.config.payments.enabled:
-            apps.append("django_cfg.apps.payments")
+            apps.append("django_cfg.apps.business.payments")
 
         if self.config.centrifugo and self.config.centrifugo.enabled:
-            apps.append("django_cfg.apps.centrifugo")
+            apps.append("django_cfg.apps.integrations.centrifugo")
+
+        if self.config.grpc and self.config.grpc.enabled:
+            apps.append("django_cfg.apps.integrations.grpc")
 
         if self.config.crypto_fields and self.config.crypto_fields.enabled:
             apps.append("django_crypto_fields.apps.AppConfig")
@@ -158,14 +160,10 @@ class InstalledAppsBuilder:
         """
         apps = []
 
-        # Auto-enable tasks if needed by other features
-        if self.config.should_enable_tasks():
-            # No external app needed - ReArq is embedded
-            apps.append("django_cfg.apps.tasks")
-
-        # Add django-q2 if enabled
-        if hasattr(self.config, "django_q2") and self.config.django_q2 and self.config.django_q2.enabled:
-            apps.append("django_q")
+        # Add Django-RQ if enabled
+        if hasattr(self.config, "django_rq") and self.config.django_rq and self.config.django_rq.enabled:
+            apps.append("django_rq")  # Core django-rq package
+            apps.append("django_cfg.apps.integrations.rq")  # Django-CFG monitoring & API
 
         # Add DRF Tailwind theme module (uses Tailwind via CDN)
         if self.config.enable_drf_tailwind:

django_cfg/core/constants.py

@@ -45,6 +45,7 @@ DEFAULT_APPS: List[str] = [
     # Django CFG Core
     "django_cfg",
     "django_cfg.modules.django_client",
+    "django_cfg.modules.django_admin",
 ]
 
 # Default middleware stack

django_cfg/core/debug/README.md

@@ -0,0 +1,116 @@
+# Django-CFG Debug Utilities
+
+Debug utilities to help troubleshoot Django-CFG issues.
+
+## Warnings Debug Helper
+
+Shows full stack traceback for specific warnings to help identify their source.
+
+### Quick Start
+
+**Method 1: Via Config (Recommended)**
+
+```python
+# In your config.py
+from django_cfg import DjangoConfig
+
+class MyConfig(DjangoConfig):
+    project_name: str = "My Project"
+    debug_warnings: bool = True  # ← Enable warnings traceback
+```
+
+**Method 2: Via Environment Variable**
+
+```bash
+export DJANGO_CFG_DEBUG_WARNINGS=1
+python manage.py runserver
+```
+
+This will show full traceback for:
+- RuntimeWarnings about database access during app initialization
+- APPS_NOT_READY warnings
+- Other app initialization warnings
+
+### Example Output
+
+```
+================================================================================
+⚠️  WARNING TRACEBACK (to help find the source)
+================================================================================
+  File "/path/to/your/code/apps.py", line 42, in ready
+    self.setup_database()
+  File "/path/to/your/code/apps.py", line 55, in setup_database
+    MyModel.objects.all()
+    ^^^^^^^^^^^^^^^^^^^^
+
+--------------------------------------------------------------------------------
+⚠️  WARNING MESSAGE:
+/usr/lib/python3.12/site-packages/django/db/backends/utils.py:98: RuntimeWarning:
+Accessing the database during app initialization is discouraged. To fix this
+warning, avoid executing queries in AppConfig.ready() or when your app modules
+are imported.
+================================================================================
+```
+
+### Manual Usage
+
+```python
+# In your manage.py or wsgi.py, BEFORE django.setup():
+from django_cfg.core.debug import setup_warnings_debug
+
+# Enable with default settings
+setup_warnings_debug(enabled=True)
+
+# Or customize:
+setup_warnings_debug(
+    enabled=True,
+    categories=[RuntimeWarning, DeprecationWarning],
+    patterns=['.*database.*', '.*deprecated.*']
+)
+```
+
+### Common Issues Found
+
+1. **Database access in AppConfig.ready()**
+   ```python
+   # ❌ Bad
+   def ready(self):
+       from .models import MyModel
+       MyModel.objects.create(...)
+
+   # ✅ Good - use post_migrate signal
+   def ready(self):
+       from django.db.models.signals import post_migrate
+       post_migrate.connect(self.setup_data, sender=self)
+   ```
+
+2. **Model queries at module level**
+   ```python
+   # ❌ Bad - runs during import
+   from .models import MyModel
+   DEFAULT_SETTINGS = MyModel.objects.first()
+
+   # ✅ Good - lazy evaluation
+   def get_default_settings():
+       from .models import MyModel
+       return MyModel.objects.first()
+   ```
+
+3. **Database connection in __init__.py**
+   ```python
+   # ❌ Bad
+   from django.db import connection
+   cursor = connection.cursor()
+
+   # ✅ Good - move to views/services
+   ```
+
+### Disabling
+
+Simply unset or set to 0:
+
+```bash
+export DJANGO_CFG_DEBUG_WARNINGS=0
+# or
+unset DJANGO_CFG_DEBUG_WARNINGS
+```

django_cfg/core/debug/__init__.py

@@ -0,0 +1,7 @@
+"""
+Debug utilities for Django-CFG.
+"""
+
+from .warnings_helper import setup_warnings_debug
+
+__all__ = ['setup_warnings_debug']

django_cfg/core/debug/example_config.py

@@ -0,0 +1,63 @@
+"""
+Example configuration with debug_warnings enabled.
+
+This shows how to enable warnings traceback through DjangoConfig.
+"""
+
+from django_cfg import DjangoConfig, DatabaseConfig
+
+
+class DebugConfig(DjangoConfig):
+    """
+    Example configuration with warnings debug enabled.
+
+    Usage:
+        # In your settings.py or config.py
+        from path.to.config import DebugConfig
+
+        config = DebugConfig()
+        settings = config.get_all_settings()
+    """
+
+    # Project basics
+    project_name: str = "Debug Example"
+    secret_key: str = "django-insecure-example-key-change-in-production"
+
+    # Enable debug mode for development
+    debug: bool = True
+
+    # Enable warnings traceback for debugging
+    # This will show full stack trace for RuntimeWarnings about:
+    # - Database access during app initialization
+    # - APPS_NOT_READY warnings
+    # - Other app initialization issues
+    debug_warnings: bool = True
+
+    # Database configuration
+    databases: dict[str, DatabaseConfig] = {
+        "default": DatabaseConfig(
+            engine="django.db.backends.sqlite3",
+            name=":memory:",
+        )
+    }
+
+
+# Alternative: Enable only in development
+class SmartDebugConfig(DjangoConfig):
+    """Automatically enable debug_warnings in development mode."""
+
+    project_name: str = "Smart Debug Example"
+    secret_key: str = "django-insecure-example-key"
+
+    # Auto-enable debug_warnings in development
+    @property
+    def debug_warnings(self) -> bool:
+        """Enable warnings debug only in development."""
+        return self.env_mode.is_development
+
+    databases: dict[str, DatabaseConfig] = {
+        "default": DatabaseConfig(
+            engine="django.db.backends.sqlite3",
+            name=":memory:",
+        )
+    }

django_cfg/core/debug/warnings_helper.py

@@ -0,0 +1,121 @@
+"""
+Warnings debug helper for Django-CFG.
+
+Shows full traceback for specific warnings to help identify the source.
+
+Usage:
+    Set environment variable:
+    export DJANGO_CFG_DEBUG_WARNINGS=1
+
+    Or call manually in manage.py/wsgi.py BEFORE django.setup():
+    from django_cfg.core.debug import setup_warnings_debug
+    setup_warnings_debug()
+"""
+
+import os
+import sys
+import traceback
+import warnings
+
+
+def warning_with_traceback(message, category, filename, lineno, file=None, line=None):
+    """
+    Custom warning handler that shows full stack traceback.
+
+    This helps identify WHERE in the code the warning is triggered from.
+    """
+    log = file if hasattr(file, 'write') else sys.stderr
+
+    # Print separator for clarity
+    log.write("\n" + "="*80 + "\n")
+    log.write(f"⚠️  WARNING TRACEBACK (to help find the source)\n")
+    log.write("="*80 + "\n")
+
+    # Print the full stack trace
+    traceback.print_stack(file=log)
+
+    # Print the actual warning
+    log.write("\n" + "-"*80 + "\n")
+    log.write(f"⚠️  WARNING MESSAGE:\n")
+    log.write(warnings.formatwarning(message, category, filename, lineno, line))
+    log.write("="*80 + "\n\n")
+
+
+def setup_warnings_debug(
+    enabled: bool = None,
+    categories: list = None,
+    patterns: list = None
+):
+    """
+    Setup warnings to show full traceback.
+
+    Args:
+        enabled: Whether to enable debug mode. If None, checks:
+                 1. DjangoConfig.debug_warnings setting (if config exists)
+                 2. DJANGO_CFG_DEBUG_WARNINGS environment variable
+        categories: List of warning categories to track (default: [RuntimeWarning])
+        patterns: List of regex patterns to match in warning messages
+                 (default: ['.*database.*', '.*APPS_NOT_READY.*'])
+
+    Example:
+        # Enable all RuntimeWarnings with traceback
+        setup_warnings_debug(enabled=True)
+
+        # Enable only specific warnings
+        setup_warnings_debug(
+            enabled=True,
+            categories=[RuntimeWarning, DeprecationWarning],
+            patterns=['.*database.*']
+        )
+
+        # In your config.py:
+        class MyConfig(DjangoConfig):
+            debug_warnings: bool = True  # Enable warnings traceback
+    """
+    # Check if enabled (priority: explicit param > config > env var)
+    if enabled is None:
+        # Try to get from config first (if available)
+        try:
+            from django_cfg.core.config import get_current_config
+            config = get_current_config()
+            if config and hasattr(config, 'debug_warnings'):
+                enabled = config.debug_warnings
+            else:
+                enabled = False
+        except Exception:
+            # Config not available yet, check env var
+            enabled = False
+
+        # Fallback to environment variable
+        if not enabled:
+            enabled = os.environ.get('DJANGO_CFG_DEBUG_WARNINGS', '').lower() in ('1', 'true', 'yes')
+
+    if not enabled:
+        return
+
+    # Default categories
+    if categories is None:
+        categories = [RuntimeWarning]
+
+    # Default patterns
+    if patterns is None:
+        patterns = [
+            '.*database.*',
+            '.*APPS_NOT_READY.*',
+            '.*app.*initialization.*',
+        ]
+
+    # Install custom warning handler
+    warnings.showwarning = warning_with_traceback
+
+    # Configure filters for each category and pattern
+    for category in categories:
+        for pattern in patterns:
+            warnings.filterwarnings(
+                'default',
+                category=category,
+                message=pattern
+            )
+
+    print(f"🔍 Django-CFG Warnings Debug enabled for: {[c.__name__ for c in categories]}")
+    print(f"   Patterns: {patterns}")

django_cfg/core/generation/integration_generators/__init__.py

@@ -5,21 +5,18 @@ Contains generators for third-party integrations and frameworks:
 - Session configuration
 - External services (Telegram, Unfold, Constance)
 - API frameworks (JWT, DRF, Spectacular, OpenAPI Client)
-- Background tasks (ReArq)
-- Task scheduling (django-q2)
+- Task scheduling (django-rq)
 - Tailwind CSS configuration
 """
 
 from .api import APIFrameworksGenerator
-from .django_q2 import DjangoQ2SettingsGenerator
+from .django_rq import DjangoRQSettingsGenerator
 from .sessions import SessionSettingsGenerator
-from .tasks import TasksSettingsGenerator
 from .third_party import ThirdPartyIntegrationsGenerator
 
 __all__ = [
     "SessionSettingsGenerator",
     "ThirdPartyIntegrationsGenerator",
     "APIFrameworksGenerator",
-    "TasksSettingsGenerator",
-    "DjangoQ2SettingsGenerator",
+    "DjangoRQSettingsGenerator",
 ]

django_cfg/core/generation/integration_generators/django_rq.py

@@ -0,0 +1,80 @@
+"""
+Django-RQ Settings Generator.
+
+Generates Django settings for django-rq task queue and scheduler.
+Converts DjangoRQConfig Pydantic model to Django RQ_QUEUES and related settings.
+"""
+
+from typing import TYPE_CHECKING, Any, Dict, Optional
+
+from ....models.django.django_rq import DjangoRQConfig
+
+if TYPE_CHECKING:
+    from ...base.config_model import DjangoConfig
+
+
+class DjangoRQSettingsGenerator:
+    """
+    Settings generator for Django-RQ task queue.
+
+    Converts DjangoRQConfig to Django settings:
+    - RQ_QUEUES: Queue configurations
+    - RQ_SHOW_ADMIN_LINK: Show link in admin
+    - RQ_EXCEPTION_HANDLERS: Exception handlers
+    - RQ_API_TOKEN: API authentication token
+
+    Usage:
+        >>> from django_cfg.models.django.django_rq import DjangoRQConfig
+        >>> config = DjangoRQConfig(enabled=True)
+        >>> generator = DjangoRQSettingsGenerator(config)
+        >>> settings = generator.generate()
+        >>> 'RQ_QUEUES' in settings
+        True
+    """
+
+    def __init__(self, config: DjangoRQConfig, parent_config: Optional["DjangoConfig"] = None):
+        """
+        Initialize Django-RQ settings generator.
+
+        Args:
+            config: DjangoRQConfig instance
+            parent_config: Parent DjangoConfig for accessing global settings like redis_url
+        """
+        self.config = config
+        self.parent_config = parent_config
+
+    def generate(self) -> Dict[str, Any]:
+        """
+        Generate Django-RQ settings.
+
+        Returns:
+            Dictionary with RQ_QUEUES and related configuration
+        """
+        if not self.config.enabled:
+            return {}
+
+        # Use the model's built-in to_django_settings method
+        settings = self.config.to_django_settings(parent_config=self.parent_config)
+
+        return settings
+
+    def validate(self) -> None:
+        """
+        Validate Django-RQ configuration.
+
+        Ensures:
+        - At least 'default' queue exists (validated by Pydantic)
+        - Queue names are unique (validated by Pydantic)
+        - Queue configurations are valid
+
+        Raises:
+            ValueError: If configuration is invalid
+        """
+        if not self.config.enabled:
+            return
+
+        # Validation is now handled by Pydantic field validators
+        # This method is kept for potential custom validation logic
+
+
+__all__ = ['DjangoRQSettingsGenerator']