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

django_cfg/registry/third_party.py

@@ -0,0 +1,52 @@
+"""
+Third-party integrations registry.
+"""
+
+THIRD_PARTY_REGISTRY = {
+    # Django Revolution
+    "RevolutionConfig": ("django_cfg.models.revolution", "RevolutionConfig"),
+    "APIZone": ("django_revolution.config", "ZoneModel"),
+    "ZoneModel": ("django_revolution.config", "ZoneModel"),
+    "ZoneConfig": ("django_revolution.app_config", "ZoneConfig"),
+    "DjangoRevolutionSettings": ("django_revolution.config", "DjangoRevolutionSettings"),
+    
+    # Unfold Admin
+    "UnfoldConfig": ("django_cfg.modules.django_unfold.models.config", "UnfoldConfig"),
+    "UnfoldTheme": ("django_cfg.modules.django_unfold.models.config", "UnfoldTheme"),
+    "UnfoldThemeConfig": ("django_cfg.modules.django_unfold.models.config", "UnfoldThemeConfig"),
+    "UnfoldColors": ("django_cfg.modules.django_unfold.models.config", "UnfoldColors"),
+    "UnfoldSidebar": ("django_cfg.modules.django_unfold.models.config", "UnfoldSidebar"),
+    "UnfoldDashboardConfig": ("django_cfg.modules.django_unfold.models.config", "UnfoldDashboardConfig"),
+    "NavigationItem": ("django_cfg.modules.django_unfold.models.navigation", "NavigationItem"),
+    "NavigationSection": ("django_cfg.modules.django_unfold.models.navigation", "NavigationSection"),
+    "NavigationItemType": ("django_cfg.modules.django_unfold.models.navigation", "NavigationItemType"),
+    "SiteDropdownItem": ("django_cfg.modules.django_unfold.models.dropdown", "SiteDropdownItem"),
+    "StatCard": ("django_cfg.modules.django_unfold.models.dashboard", "StatCard"),
+    "SystemHealthItem": ("django_cfg.modules.django_unfold.models.dashboard", "SystemHealthItem"),
+    "QuickAction": ("django_cfg.modules.django_unfold.models.dashboard", "QuickAction"),
+    "DashboardWidget": ("django_cfg.modules.django_unfold.models.dashboard", "DashboardWidget"),
+    "DashboardData": ("django_cfg.modules.django_unfold.models.dashboard", "DashboardData"),
+    "ChartDataset": ("django_cfg.modules.django_unfold.models.dashboard", "ChartDataset"),
+    "ChartData": ("django_cfg.modules.django_unfold.models.dashboard", "ChartData"),
+    "TabConfiguration": ("django_cfg.modules.django_unfold.models.tabs", "TabConfiguration"),
+    "TabItem": ("django_cfg.modules.django_unfold.models.tabs", "TabItem"),
+    
+    # Django REST Framework
+    "DRFConfig": ("django_cfg.models.drf", "DRFConfig"),
+    "SpectacularConfig": ("django_cfg.models.drf", "SpectacularConfig"),
+    "SwaggerUISettings": ("django_cfg.models.drf", "SwaggerUISettings"),
+    "RedocUISettings": ("django_cfg.models.drf", "RedocUISettings"),
+    
+    # Constance
+    "ConstanceConfig": ("django_cfg.models.constance", "ConstanceConfig"),
+    "ConstanceField": ("django_cfg.models.constance", "ConstanceField"),
+    
+    # Ngrok
+    "NgrokConfig": ("django_cfg.models.ngrok", "NgrokConfig"),
+    "NgrokAuthConfig": ("django_cfg.models.ngrok", "NgrokAuthConfig"),
+    "NgrokTunnelConfig": ("django_cfg.models.ngrok", "NgrokTunnelConfig"),
+    
+    # Material Icons
+    "Icons": ("django_cfg.modules.django_unfold.icons", "Icons"),
+    "IconCategories": ("django_cfg.modules.django_unfold.icons", "IconCategories"),
+}

django_cfg/routing/__init__.py

@@ -0,0 +1,19 @@
+"""
+Django-CFG Routing
+
+URL routing and callback utilities.
+"""
+
+from .routers import *
+from .callbacks import *
+
+__all__ = [
+    # From routers
+    "DynamicRouter",
+    "APIRouter", 
+    "AdminRouter",
+    
+    # From callbacks
+    "health_callback",
+    "status_callback",
+]

django_cfg/routing/callbacks.py

@@ -0,0 +1,198 @@
+"""
+Dashboard Callback System
+
+Provides callback utilities for Unfold dashboard integration.
+"""
+
+from typing import Dict, Any, List, Optional, Callable
+from datetime import datetime, timedelta
+from django.http import HttpRequest
+from django.contrib.auth import get_user_model
+from django.contrib.contenttypes.models import ContentType
+from django.db import connection
+from django.conf import settings
+from ..modules.base import BaseCfgModule
+
+
+def dashboard_callback(request: HttpRequest, context: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Default dashboard callback for Unfold admin.
+    
+    Returns enhanced context with dashboard data.
+    """
+    User = get_user_model()
+    
+    # Get basic stats
+    user_count = User.objects.count()
+    
+    # Database info
+    with connection.cursor() as cursor:
+        cursor.execute("SELECT COUNT(*) FROM django_session")
+        session_count = cursor.fetchone()[0]
+    
+    # Add dashboard data to context
+    context.update({
+        "dashboard": [
+            {
+                "title": "System Overview",
+                "metric": f"{user_count} users",
+                "footer": f"{session_count} active sessions",
+                "chart": {
+                    "labels": ["Users", "Sessions"],
+                    "data": [user_count, session_count],
+                }
+            },
+            {
+                "title": "Quick Actions",
+                "metric": "Admin Tools",
+                "footer": "Manage your system",
+                "link": "/admin/",
+            }
+        ]
+    })
+    
+    return context
+
+
+def environment_callback(request: HttpRequest) -> Dict[str, Any]:
+    """
+    Environment callback for Unfold admin.
+    
+    Returns environment information and system status.
+    """
+
+    
+    # Use BaseCfgModule to get config
+    base_module = BaseCfgModule()
+    config = base_module.get_config()
+    
+    return {
+        "environment": getattr(config, 'environment', 'development'),
+        "debug": getattr(config, 'debug', False),
+        "version": getattr(settings, 'VERSION', '1.0.0'),
+        "database": {
+            "engine": "PostgreSQL" if config and hasattr(config, 'database_default') else "Unknown",
+            "name": config.database_default.name if config and hasattr(config, 'database_default') else "Unknown",
+        },
+        "cache": {
+            "backend": "Redis" if config and hasattr(config, 'cache_default') else "default",
+        },
+        "features": {
+            "unfold": True,  # Unfold always enabled
+            "revolution": True,  # Revolution always enabled
+            "constance": getattr(config, 'enable_constance', False) if config else False,
+        }
+    }
+
+
+def permission_callback(request: HttpRequest) -> Dict[str, Any]:
+    """
+    Permission callback for Unfold admin.
+    
+    Returns user permission information.
+    """
+    if not request.user.is_authenticated:
+        return {"permissions": [], "groups": []}
+    
+    user_permissions = list(request.user.get_all_permissions())
+    user_groups = list(request.user.groups.values_list('name', flat=True))
+    
+    return {
+        "permissions": user_permissions,
+        "groups": user_groups,
+        "is_staff": request.user.is_staff,
+        "is_superuser": request.user.is_superuser,
+    }
+
+
+def search_callback(request: HttpRequest, query: str) -> List[Dict[str, Any]]:
+    """
+    Search callback for Unfold admin.
+    
+    Provides search functionality across models.
+    """
+
+    
+    results = []
+    
+    if len(query) < 2:
+        return results
+    
+    # Search users
+    User = get_user_model()
+    users = User.objects.filter(
+        username__icontains=query
+    ).values('id', 'username', 'email')[:5]
+    
+    for user in users:
+        results.append({
+            "title": f"User: {user['username']}",
+            "url": f"/admin/auth/user/{user['id']}/change/",
+            "description": user.get('email', ''),
+        })
+    
+    # Search content types (as a proxy for apps/models)
+    content_types = ContentType.objects.filter(
+        model__icontains=query
+    ).values('app_label', 'model')[:5]
+    
+    for ct in content_types:
+        results.append({
+            "title": f"Model: {ct['app_label']}.{ct['model']}",
+            "url": f"/admin/{ct['app_label']}/{ct['model']}/",
+            "description": f"Manage {ct['model']} objects",
+        })
+    
+    return results
+
+
+def badge_callback(request: HttpRequest) -> List[Dict[str, Any]]:
+    """
+    Badge callback for Unfold admin.
+    
+    Returns notification badges and counters.
+    """
+    from django.contrib.auth import get_user_model
+    
+    User = get_user_model()
+    
+    # Count new users in last 24 hours
+    from datetime import datetime, timedelta
+    yesterday = datetime.now() - timedelta(days=1)
+    new_users = User.objects.filter(date_joined__gte=yesterday).count()
+    
+    badges = []
+    
+    if new_users > 0:
+        badges.append({
+            "title": "New Users",
+            "count": new_users,
+            "color": "primary",
+            "url": "/admin/auth/user/?date_joined__gte=" + yesterday.strftime('%Y-%m-%d'),
+        })
+    
+    # Add system health badge
+    badges.append({
+        "title": "System",
+        "count": "OK",
+        "color": "success",
+        "url": "/admin/",
+    })
+    
+    return badges
+
+
+# Helper function to register callbacks in Unfold config
+def get_unfold_callbacks() -> Dict[str, str]:
+    """
+    Get callback function paths for Unfold configuration.
+    
+    Returns dictionary mapping callback types to function paths.
+    """
+    return {
+        "dashboard_callback": "django_cfg.routing.callbacks.dashboard_callback",
+        "environment_callback": "django_cfg.routing.callbacks.environment_callback", 
+        "permission_callback": "django_cfg.routing.callbacks.permission_callback",
+        "search_callback": "django_cfg.routing.callbacks.search_callback",
+        "badge_callback": "django_cfg.routing.callbacks.badge_callback",
+    }

django_cfg/routing/routers.py

@@ -0,0 +1,48 @@
+"""
+Database Router for Django Config Toolkit
+
+Simple and reliable database routing.
+"""
+
+from django.conf import settings
+
+
+class DatabaseRouter:
+    """
+    Simple database router that routes based on app labels.
+    
+    Uses DATABASE_ROUTING_RULES setting to determine which apps
+    should use which databases.
+    """
+
+    def db_for_read(self, model, **hints):
+        """Route reads to correct database."""
+        rules = getattr(settings, 'DATABASE_ROUTING_RULES', {})
+        return rules.get(model._meta.app_label)
+
+    def db_for_write(self, model, **hints):
+        """Route writes to correct database.""" 
+        rules = getattr(settings, 'DATABASE_ROUTING_RULES', {})
+        return rules.get(model._meta.app_label)
+
+    def allow_relation(self, obj1, obj2, **hints):
+        """Allow relations between same database."""
+        rules = getattr(settings, 'DATABASE_ROUTING_RULES', {})
+        db1 = rules.get(obj1._meta.app_label)
+        db2 = rules.get(obj2._meta.app_label)
+        return db1 == db2 if db1 and db2 else None
+
+    def allow_migrate(self, db, app_label, **hints):
+        """Allow migrations to correct database."""
+        rules = getattr(settings, 'DATABASE_ROUTING_RULES', {})
+        target_db = rules.get(app_label)
+
+        if target_db:
+            # This app IS configured in the rules
+            return db == target_db
+        elif db in rules.values():
+            # This app is NOT configured, but the target DB is used by other apps
+            return db == 'default'
+        
+        # Allow migration to default
+        return None

django_cfg/templates/admin/layouts/dashboard_with_tabs.html

@@ -429,15 +429,14 @@
         <!-- Footer Section -->
         <div class="text-center py-8 border-t border-base-200 dark:border-base-700 mt-5">
             <p class="text-sm text-font-subtle-light dark:text-font-subtle-dark">
-            Django Config Toolkit
-            <span class="mx-2">•</span>
-            <a href="/health/" class="text-primary-600 hover:text-primary-700">
-                System Health
-            </a>
-            <span class="mx-2">•</span>
-            <a href="/admin/" class="text-primary-600 hover:text-primary-700">
-                Administration
-            </a>
+                {% load django_cfg %}
+                <a href="{% lib_site_url %}" class="text-primary-600 hover:text-primary-700 font-medium">
+                    {% lib_name %}
+                </a>
+                <span class="mx-2">•</span>
+                <a href="{% lib_health_url %}" class="text-primary-600 hover:text-primary-700">
+                    System Health
+                </a>
             </p>
         </div>
 

django_cfg/templatetags/django_cfg.py

@@ -0,0 +1,33 @@
+"""
+Django-CFG Template Tags
+
+Provides template tags for accessing django-cfg configuration constants.
+"""
+
+from django import template
+
+register = template.Library()
+
+
+@register.simple_tag
+def lib_name():
+    """Get the library name."""
+    # Lazy import to avoid AppRegistryNotReady error
+    from django_cfg.config import LIB_NAME
+    return LIB_NAME
+
+
+@register.simple_tag
+def lib_site_url():
+    """Get the library site URL."""
+    # Lazy import to avoid AppRegistryNotReady error
+    from django_cfg.config import LIB_SITE_URL
+    return LIB_SITE_URL
+
+
+@register.simple_tag
+def lib_health_url():
+    """Get the library health URL."""
+    # Lazy import to avoid AppRegistryNotReady error
+    from django_cfg.config import LIB_HEALTH_URL
+    return LIB_HEALTH_URL

django_cfg/urls.py

@@ -0,0 +1,33 @@
+"""
+URL Configuration for Django Config Toolkit
+
+Provides URL patterns for health checks and other toolkit endpoints.
+"""
+
+from django.urls import path, include
+from .health import HealthCheckView, SimpleHealthView
+
+
+app_name = 'django_cfg'
+
+urlpatterns = [
+    # Health check endpoints
+    path('health/', HealthCheckView.as_view(), name='health-check'),
+    path('health/simple/', SimpleHealthView.as_view(), name='simple-health'),
+]
+
+
+def get_toolkit_urls():
+    """
+    Get URL patterns for Django Config Toolkit.
+    
+    Include in your main urls.py:
+    
+        from django_cfg.urls import get_toolkit_urls
+        
+        urlpatterns = [
+            path('admin/', admin.site.urls),
+            path('toolkit/', include(get_toolkit_urls())),
+        ]
+    """
+    return urlpatterns

django_cfg/utils/path_resolution.py

@@ -13,7 +13,7 @@ import sys
 from typing import Optional, List, Dict, Any
 from pathlib import Path
 
-from django_cfg.exceptions import ConfigurationError
+from django_cfg.core.exceptions import ConfigurationError
 
 
 class PathResolver:

django_cfg/utils/smart_defaults.py

@@ -11,9 +11,9 @@ Following CRITICAL_REQUIREMENTS.md:
 from typing import Dict, Any, Optional, List
 from pathlib import Path
 
-from django_cfg.models.cache import CacheBackend
+from django_cfg.models.cache import CacheConfig
 from django_cfg.models.services import EmailConfig
-from django_cfg.exceptions import ConfigurationError
+from django_cfg.core.exceptions import ConfigurationError
 
 
 class SmartDefaults:
@@ -30,10 +30,10 @@ class SmartDefaults:
     @classmethod
     def configure_cache_backend(
         cls,
-        cache_config: CacheBackend,
+        cache_config: CacheConfig,
         environment: Optional[str] = None,
         debug: bool = False
-    ) -> CacheBackend:
+    ) -> CacheConfig:
         """
         Configure cache backend with environment-aware defaults.
         
@@ -50,7 +50,7 @@ class SmartDefaults:
         """
         try:
             # Create a copy to avoid modifying the original
-            config: CacheBackend = cache_config.model_copy()
+            config: CacheConfig = cache_config.model_copy()
             
             # Environment-specific adjustments
             if environment == "testing":
@@ -168,8 +168,7 @@ class SmartDefaults:
         domains: List[str],
         environment: Optional[str] = None,
         debug: bool = False,
-        ssl_redirect: Optional[bool] = None,
-        cors_allow_headers: Optional[List[str]] = None
+        ssl_redirect: Optional[bool] = None
     ) -> Dict[str, Any]:
         """
         Get security defaults based on environment and domains.
@@ -179,7 +178,6 @@ class SmartDefaults:
             environment: Current environment
             debug: Django DEBUG setting
             ssl_redirect: Force SSL redirect on/off (None = auto based on domains)
-            cors_allow_headers: Custom CORS allowed headers
             
         Returns:
             Security settings dictionary
@@ -194,24 +192,6 @@ class SmartDefaults:
                     settings['CORS_ALLOW_ALL_ORIGINS'] = True
                     settings['CORS_ALLOW_CREDENTIALS'] = True
                     
-                    # Add CORS headers (custom or smart defaults)
-                    if cors_allow_headers:
-                        settings['CORS_ALLOW_HEADERS'] = cors_allow_headers
-                    else:
-                        # Smart defaults including X-API-Key
-                        settings['CORS_ALLOW_HEADERS'] = [
-                            "accept",
-                            "accept-encoding", 
-                            "authorization",
-                            "content-type",
-                            "dnt",
-                            "origin",
-                            "user-agent",
-                            "x-csrftoken",
-                            "x-requested-with",
-                            "x-api-key",  # Add X-API-Key by default
-                        ]
-                    
                     # For development, add ALL domains to CSRF trusted origins
                     # This allows testing with production domains in dev environment
                     csrf_trusted_origins = []
@@ -261,24 +241,6 @@ class SmartDefaults:
                     settings['CORS_ALLOWED_ORIGINS'] = allowed_origins
                     settings['CORS_ALLOW_CREDENTIALS'] = True
                     
-                    # Add CORS headers (custom or smart defaults)
-                    if cors_allow_headers:
-                        settings['CORS_ALLOW_HEADERS'] = cors_allow_headers
-                    else:
-                        # Smart defaults including X-API-Key
-                        settings['CORS_ALLOW_HEADERS'] = [
-                            "accept",
-                            "accept-encoding", 
-                            "authorization",
-                            "content-type",
-                            "dnt",
-                            "origin",
-                            "user-agent",
-                            "x-csrftoken",
-                            "x-requested-with",
-                            "x-api-key",  # Add X-API-Key by default
-                        ]
-                    
                     # Set CSRF trusted origins for HTTPS domains
                     if csrf_trusted_origins:
                         settings['CSRF_TRUSTED_ORIGINS'] = csrf_trusted_origins
@@ -442,7 +404,7 @@ class SmartDefaults:
                 }
                 
             elif environment == "development" or debug:
-                # Development: Console and file logging
+                # Development: Console logging with colors
                 return {
                     'version': 1,
                     'disable_existing_loggers': False,
@@ -451,23 +413,12 @@ class SmartDefaults:
                             'format': '{levelname} {asctime} {module} {process:d} {thread:d} {message}',
                             'style': '{',
                         },
-                        'simple': {
-                            'format': '{levelname} {asctime} {name} {message}',
-                            'style': '{',
-                        },
                     },
                     'handlers': {
                         'console': {
                             'class': 'logging.StreamHandler',
                             'formatter': 'verbose',
                         },
-                        'file': {
-                            'class': 'logging.handlers.RotatingFileHandler',
-                            'filename': 'logs/django-cfg.log',
-                            'maxBytes': 1024*1024*5,  # 5MB
-                            'backupCount': 3,
-                            'formatter': 'simple',
-                        },
                     },
                     'root': {
                         'handlers': ['console'],
@@ -479,11 +430,6 @@ class SmartDefaults:
                             'level': 'INFO',
                             'propagate': False,
                         },
-                        'django_cfg': {
-                            'handlers': ['console', 'file'],
-                            'level': 'DEBUG',
-                            'propagate': False,
-                        },
                     },
                 }