django-cfg 1.4.106__py3-none-any.whl → 1.4.108__py3-none-any.whl

django_cfg/modules/django_admin/config/resource_config.py

@@ -0,0 +1,129 @@
+"""
+Resource configuration for import/export functionality.
+"""
+
+from typing import Any, Callable, Dict, List, Optional, Union
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ResourceConfig(BaseModel):
+    """
+    Configuration for django-import-export Resource class.
+
+    Provides declarative configuration for import/export behavior without
+    needing to manually create Resource classes.
+
+    Example:
+        ```python
+        resource_config = ResourceConfig(
+            fields=['host', 'port', 'username', 'password', 'provider'],
+            exclude=['metadata', 'config'],
+            import_id_fields=['host', 'port'],
+            after_import_row='apps.proxies.services.test_proxy_async',
+            skip_unchanged=True,
+        )
+        ```
+    """
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        arbitrary_types_allowed=True
+    )
+
+    # Field configuration
+    fields: List[str] = Field(
+        default_factory=list,
+        description="Fields to include in import/export (empty = all fields)"
+    )
+    exclude: List[str] = Field(
+        default_factory=list,
+        description="Fields to exclude from import/export"
+    )
+    import_id_fields: List[str] = Field(
+        default_factory=lambda: ['id'],
+        description="Fields used to identify existing rows during import"
+    )
+
+    # Import behavior
+    skip_unchanged: bool = Field(
+        True,
+        description="Skip rows that haven't changed during import"
+    )
+    report_skipped: bool = Field(
+        True,
+        description="Include skipped rows in import report"
+    )
+    skip_diff: bool = Field(
+        False,
+        description="Skip diff generation for faster imports (large datasets)"
+    )
+    use_transactions: bool = Field(
+        True,
+        description="Use database transactions for imports"
+    )
+
+    # Validation and hooks (can be string paths or callables)
+    before_import: Optional[Union[str, Callable]] = Field(
+        None,
+        description="Hook called before import starts (receives dataset, dry_run)"
+    )
+    after_import: Optional[Union[str, Callable]] = Field(
+        None,
+        description="Hook called after import completes (receives dataset, result, dry_run)"
+    )
+    before_import_row: Optional[Union[str, Callable]] = Field(
+        None,
+        description="Hook called before each row import (receives row, row_number, dry_run)"
+    )
+    after_import_row: Optional[Union[str, Callable]] = Field(
+        None,
+        description="Hook called after each row import (receives row, row_result, row_number)"
+    )
+
+    # Export options
+    export_order: List[str] = Field(
+        default_factory=list,
+        description="Field order in exported files (empty = model field order)"
+    )
+
+    # Field widgets/customization
+    field_widgets: Dict[str, Any] = Field(
+        default_factory=dict,
+        description="Custom widgets for fields (e.g., {'date': {'format': '%Y-%m-%d'}})"
+    )
+
+    # Batch processing
+    batch_size: Optional[int] = Field(
+        None,
+        description="Process imports in batches (for large datasets)"
+    )
+
+    def get_callable(self, hook_name: str) -> Optional[Callable]:
+        """
+        Get callable for a hook by name.
+
+        Args:
+            hook_name: Name of the hook ('before_import', 'after_import_row', etc.)
+
+        Returns:
+            Callable function or None if not set
+        """
+        hook_value = getattr(self, hook_name, None)
+
+        if hook_value is None:
+            return None
+
+        # If already a callable, return it
+        if callable(hook_value):
+            return hook_value
+
+        # If string, import it
+        if isinstance(hook_value, str):
+            import importlib
+            module_path, function_name = hook_value.rsplit('.', 1)
+            module = importlib.import_module(module_path)
+            return getattr(module, function_name)
+
+        return None

django_cfg/modules/django_client/management/commands/generate_client.py

@@ -74,6 +74,12 @@ class Command(BaseCommand):
         )
 
         # Utility options
+        parser.add_argument(
+            "--no-build",
+            action="store_true",
+            help="Skip Next.js admin build (useful when calling from Makefile)",
+        )
+
         parser.add_argument(
             "--dry-run",
             action="store_true",
@@ -515,7 +521,13 @@ class Command(BaseCommand):
             # First copy API clients
             self._copy_to_nextjs_admin(service)
             # Then build Next.js (so clients are included in build)
-            self._build_nextjs_admin()
+            # Skip build if --no-build flag is set
+            if not options.get("no_build"):
+                self._build_nextjs_admin()
+            else:
+                self.stdout.write(self.style.WARNING(
+                    "\n⏭️  Skipping Next.js build (--no-build flag set)"
+                ))
 
         # Summary
         self.stdout.write("\n" + "=" * 60)

django_cfg/modules/django_unfold/navigation.py

@@ -4,15 +4,19 @@ Default Navigation Configuration for Django CFG Unfold
 Provides default navigation sections based on enabled django-cfg modules.
 """
 
-from typing import Any, Dict, List
+import logging
+import traceback
+from typing import Any, Dict, List, Optional
 
-from django.urls import reverse_lazy
+from django.urls import reverse_lazy, NoReverseMatch
 
 from django_cfg.modules.django_admin.icons import Icons
 from django_cfg.modules.base import BaseCfgModule
 
 from .models.navigation import NavigationItem, NavigationSection
 
+logger = logging.getLogger(__name__)
+
 
 class NavigationManager(BaseCfgModule):
     """
@@ -39,19 +43,92 @@ class NavigationManager(BaseCfgModule):
                 self._config_loaded = True
         return self._config
 
+    def _safe_reverse(self, url_name: str, fallback: Optional[str] = None) -> Optional[str]:
+        """
+        Safely resolve URL with error logging.
+
+        Args:
+            url_name: Django URL name to reverse
+            fallback: Optional fallback URL if reverse fails
+
+        Returns:
+            Resolved URL string or fallback, None if both fail
+        """
+        try:
+            return str(reverse_lazy(url_name))
+        except NoReverseMatch as e:
+            logger.error(
+                f"Failed to reverse URL '{url_name}': {e}\n"
+                f"Traceback:\n{''.join(traceback.format_tb(e.__traceback__))}"
+            )
+            if fallback:
+                logger.warning(f"Using fallback URL: {fallback}")
+                return fallback
+            return None
+        except Exception as e:
+            logger.error(
+                f"Unexpected error reversing URL '{url_name}': {e}\n"
+                f"Traceback:\n{''.join(traceback.format_exc())}"
+            )
+            return fallback
+
+    def _create_nav_item(
+        self,
+        title: str,
+        icon: str,
+        url_name: str,
+        fallback_link: Optional[str] = None
+    ) -> Optional[NavigationItem]:
+        """
+        Create NavigationItem with safe URL resolution.
+
+        Args:
+            title: Navigation item title
+            icon: Icon identifier
+            url_name: Django URL name to reverse
+            fallback_link: Optional fallback URL
+
+        Returns:
+            NavigationItem or None if URL resolution fails
+        """
+        link = self._safe_reverse(url_name, fallback_link)
+        if link is None:
+            logger.warning(f"Skipping navigation item '{title}' - URL '{url_name}' could not be resolved")
+            return None
+
+        return NavigationItem(title=title, icon=icon, link=link)
+
     def get_navigation_config(self) -> List[Dict[str, Any]]:
         """Get complete default navigation configuration for Unfold sidebar."""
+        # Dashboard section with safe URL resolution
+        dashboard_items = []
+
+        # Overview
+        overview_item = self._create_nav_item("Overview", Icons.DASHBOARD, "admin:index")
+        if overview_item:
+            dashboard_items.append(overview_item)
+
+        # Settings
+        settings_item = self._create_nav_item("Settings", Icons.SETTINGS, "admin:constance_config_changelist")
+        if settings_item:
+            dashboard_items.append(settings_item)
+
+        # Health Check
+        health_item = self._create_nav_item("Health Check", Icons.HEALTH_AND_SAFETY, "django_cfg_drf_health", "/cfg/health/")
+        if health_item:
+            dashboard_items.append(health_item)
+
+        # Endpoints Status
+        endpoints_item = self._create_nav_item("Endpoints Status", Icons.API, "endpoints_status_drf", "/cfg/endpoints/")
+        if endpoints_item:
+            dashboard_items.append(endpoints_item)
+
         navigation_sections = [
             NavigationSection(
                 title="Dashboard",
                 separator=True,
                 collapsible=True,
-                items=[
-                    NavigationItem(title="Overview", icon=Icons.DASHBOARD, link=str(reverse_lazy("admin:index"))),
-                    NavigationItem(title="Settings", icon=Icons.SETTINGS, link=str(reverse_lazy("admin:constance_config_changelist"))),
-                    NavigationItem(title="Health Check", icon=Icons.HEALTH_AND_SAFETY, link=str(reverse_lazy("django_cfg_drf_health"))),
-                    NavigationItem(title="Endpoints Status", icon=Icons.API, link=str(reverse_lazy("endpoints_status_drf"))),
-                ]
+                items=dashboard_items
             ),
         ]
 
@@ -69,29 +146,51 @@ class NavigationManager(BaseCfgModule):
                 )
             )
 
-        # Add Operations section (System & Monitoring tools)
-        operations_items = []
-
-        # Background Tasks (if enabled)
+        # Background Tasks section (if enabled)
         if self.should_enable_tasks():
-            operations_items.extend([
-                NavigationItem(title="Background Tasks", icon=Icons.TASK, link=str(reverse_lazy("admin:django_dramatiq_task_changelist"))),
-                NavigationItem(title="Task Dashboard", icon=Icons.SETTINGS_APPLICATIONS, link=str(reverse_lazy("dashboard"))),
-            ])
+            tasks_items = []
+
+            tasks_items.append(
+                NavigationItem(title="Dashboard", icon=Icons.SETTINGS_APPLICATIONS, link="/cfg/admin/admin/tasks")
+            )
+
+            # Try to add Tasks Logs with safe URL resolution
+            logs_item = self._create_nav_item(
+                title="Logs",
+                icon=Icons.TASK,
+                url_name="admin:django_cfg_tasks_tasklog_changelist",
+                fallback_link="/admin/django_cfg_tasks/tasklog/"
+            )
+            if logs_item:
+                tasks_items.append(logs_item)
+
+            navigation_sections.append(NavigationSection(
+                title="Background Tasks",
+                separator=True,
+                collapsible=True,
+                items=tasks_items
+            ))
+
+        # System Operations section
+        system_items = []
 
         # Maintenance Mode (if enabled)
         if self.is_maintenance_enabled():
-            operations_items.append(
-                NavigationItem(title="Maintenance", icon=Icons.BUILD, link=str(reverse_lazy("admin:maintenance_cloudflaresite_changelist")))
+            maintenance_item = self._create_nav_item(
+                title="Maintenance",
+                icon=Icons.BUILD,
+                url_name="admin:maintenance_cloudflaresite_changelist"
             )
+            if maintenance_item:
+                system_items.append(maintenance_item)
 
-        # Add Operations section if there are any items
-        if operations_items:
+        # Add System Operations section if there are any items
+        if system_items:
             navigation_sections.append(NavigationSection(
-                title="Operations",
+                title="System Operations",
                 separator=True,
                 collapsible=True,
-                items=operations_items
+                items=system_items
             ))
 
         # Add Accounts section if enabled

django_cfg/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.106"
+version = "1.4.108"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]
 classifiers = [ "Development Status :: 4 - Beta", "Framework :: Django", "Framework :: Django :: 5.2", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Typing :: Typed",]
 requires-python = ">=3.12,<3.14"
-dependencies = [ "pydantic>=2.11.0,<3.0", "pydantic[email]>=2.11.0,<3.0", "PyYAML>=6.0,<7.0", "click>=8.2.0,<9.0", "questionary>=2.1.0,<3.0", "rich>=14.0.0,<15.0", "cloudflare>=4.3.0,<5.0", "loguru>=0.7.0,<1.0", "colorlog>=6.9.0,<7.0", "cachetools>=5.3.0,<7.0", "toml>=0.10.2,<0.11.0", "ngrok>=1.5.1; python_version>='3.12'", "psycopg[binary,pool]>=3.2.0,<4.0", "dj-database-url>=3.0.0,<4.0", "whitenoise>=6.8.0,<7.0", "django-cors-headers>=4.7.0,<5.0", "djangorestframework>=3.16.0,<4.0", "djangorestframework-simplejwt>=5.5.0,<6.0", "djangorestframework-simplejwt[token-blacklist]>=5.5.0,<6.0", "drf-nested-routers>=0.94.0,<1.0", "django-filter>=25.0,<26.0", "django-ratelimit>=4.1.0,<5.0.0", "drf-spectacular>=0.28.0,<1.0", "drf-spectacular-sidecar>=2025.8.0,<2026.0", "django-json-widget>=2.0.0,<3.0", "django-import-export>=4.3.0,<5.0", "django-extensions>=4.1.0,<5.0", "django-constance>=4.3.0,<5.0", "django-unfold>=0.64.0,<1.0", "django-redis>=6.0.0,<7.0", "redis>=6.4.0,<7.0", "hiredis>=2.0.0,<4.0", "dramatiq[redis]>=1.18.0,<2.0", "django-dramatiq>=0.14.0,<1.0", "pyTelegramBotAPI>=4.28.0,<5.0", "coolname>=2.2.0,<3.0", "django-admin-rangefilter>=0.13.0,<1.0", "python-json-logger>=3.3.0,<4.0", "requests>=2.32.0,<3.0", "tiktoken>=0.11.0,<1.0", "openai>=1.107.0,<2.0", "twilio>=9.8.0,<10.0", "sendgrid>=6.12.0,<7.0", "beautifulsoup4>=4.13.0,<5.0", "lxml>=6.0.0,<7.0", "pgvector>=0.4.0,<1.0", "tenacity>=9.1.2,<10.0.0", "mypy (>=1.18.2,<2.0.0)", "django-tailwind[reload] (>=4.2.0,<5.0.0)", "jinja2 (>=3.1.6,<4.0.0)", "django-axes[ipware] (>=8.0.0,<9.0.0)", "pydantic-settings (>=2.11.0,<3.0.0)",]
+dependencies = [ "pydantic>=2.11.0,<3.0", "pydantic[email]>=2.11.0,<3.0", "PyYAML>=6.0,<7.0", "click>=8.2.0,<9.0", "questionary>=2.1.0,<3.0", "rich>=14.0.0,<15.0", "cloudflare>=4.3.0,<5.0", "loguru>=0.7.0,<1.0", "colorlog>=6.9.0,<7.0", "cachetools>=5.3.0,<7.0", "toml>=0.10.2,<0.11.0", "ngrok>=1.5.1; python_version>='3.12'", "psycopg[binary,pool]>=3.2.0,<4.0", "dj-database-url>=3.0.0,<4.0", "whitenoise>=6.8.0,<7.0", "django-cors-headers>=4.7.0,<5.0", "djangorestframework>=3.16.0,<4.0", "djangorestframework-simplejwt>=5.5.0,<6.0", "djangorestframework-simplejwt[token-blacklist]>=5.5.0,<6.0", "drf-nested-routers>=0.94.0,<1.0", "django-filter>=25.0,<26.0", "django-ratelimit>=4.1.0,<5.0.0", "drf-spectacular>=0.28.0,<1.0", "drf-spectacular-sidecar>=2025.8.0,<2026.0", "django-json-widget>=2.0.0,<3.0", "django-import-export>=4.3.0,<5.0", "django-extensions>=4.1.0,<5.0", "django-constance>=4.3.0,<5.0", "django-unfold>=0.64.0,<1.0", "django-redis>=6.0.0,<7.0", "redis>=6.4.0,<7.0", "hiredis>=2.0.0,<4.0", "rearq>=0.2.0,<1.0", "setuptools>=75.0.0; python_version>='3.13'", "pyTelegramBotAPI>=4.28.0,<5.0", "coolname>=2.2.0,<3.0", "django-admin-rangefilter>=0.13.0,<1.0", "python-json-logger>=3.3.0,<4.0", "requests>=2.32.0,<3.0", "tiktoken>=0.11.0,<1.0", "openai>=1.107.0,<2.0", "twilio>=9.8.0,<10.0", "sendgrid>=6.12.0,<7.0", "beautifulsoup4>=4.13.0,<5.0", "lxml>=6.0.0,<7.0", "pgvector>=0.4.0,<1.0", "tenacity>=9.1.2,<10.0.0", "mypy (>=1.18.2,<2.0.0)", "django-tailwind[reload] (>=4.2.0,<5.0.0)", "jinja2 (>=3.1.6,<4.0.0)", "django-axes[ipware] (>=8.0.0,<9.0.0)", "pydantic-settings (>=2.11.0,<3.0.0)", "pytz>=2025.1", "httpx>=0.28.1,<1.0",]
 [[project.authors]]
 name = "Django-CFG Team"
 email = "info@djangocfg.com"

django_cfg/registry/core.py

@@ -49,7 +49,7 @@ CORE_REGISTRY = {
 
     # Task and queue models
     "TaskConfig": ("django_cfg.models.tasks.config", "TaskConfig"),
-    "DramatiqConfig": ("django_cfg.models.tasks.config", "DramatiqConfig"),
+    "RearqConfig": ("django_cfg.models.tasks.config", "RearqConfig"),
 
     # Payment system models (BaseCfgAutoModule)
     "PaymentsConfig": ("django_cfg.models.payments.config", "PaymentsConfig"),

{django_cfg-1.4.106.dist-info → django_cfg-1.4.108.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.106
+Version: 1.4.108
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com
@@ -39,7 +39,6 @@ Requires-Dist: django-admin-rangefilter<1.0,>=0.13.0
 Requires-Dist: django-axes[ipware]<9.0.0,>=8.0.0
 Requires-Dist: django-constance<5.0,>=4.3.0
 Requires-Dist: django-cors-headers<5.0,>=4.7.0
-Requires-Dist: django-dramatiq<1.0,>=0.14.0
 Requires-Dist: django-extensions<5.0,>=4.1.0
 Requires-Dist: django-filter<26.0,>=25.0
 Requires-Dist: django-import-export<5.0,>=4.3.0
@@ -51,11 +50,11 @@ Requires-Dist: django-unfold<1.0,>=0.64.0
 Requires-Dist: djangorestframework-simplejwt<6.0,>=5.5.0
 Requires-Dist: djangorestframework-simplejwt[token-blacklist]<6.0,>=5.5.0
 Requires-Dist: djangorestframework<4.0,>=3.16.0
-Requires-Dist: dramatiq[redis]<2.0,>=1.18.0
 Requires-Dist: drf-nested-routers<1.0,>=0.94.0
 Requires-Dist: drf-spectacular-sidecar<2026.0,>=2025.8.0
 Requires-Dist: drf-spectacular<1.0,>=0.28.0
 Requires-Dist: hiredis<4.0,>=2.0.0
+Requires-Dist: httpx<1.0,>=0.28.1
 Requires-Dist: jinja2<4.0.0,>=3.1.6
 Requires-Dist: loguru<1.0,>=0.7.0
 Requires-Dist: lxml<7.0,>=6.0.0
@@ -69,12 +68,15 @@ Requires-Dist: pydantic<3.0,>=2.11.0
 Requires-Dist: pydantic[email]<3.0,>=2.11.0
 Requires-Dist: pytelegrambotapi<5.0,>=4.28.0
 Requires-Dist: python-json-logger<4.0,>=3.3.0
+Requires-Dist: pytz>=2025.1
 Requires-Dist: pyyaml<7.0,>=6.0
 Requires-Dist: questionary<3.0,>=2.1.0
+Requires-Dist: rearq<1.0,>=0.2.0
 Requires-Dist: redis<7.0,>=6.4.0
 Requires-Dist: requests<3.0,>=2.32.0
 Requires-Dist: rich<15.0,>=14.0.0
 Requires-Dist: sendgrid<7.0,>=6.12.0
+Requires-Dist: setuptools>=75.0.0; python_version >= '3.13'
 Requires-Dist: tenacity<10.0.0,>=9.1.2
 Requires-Dist: tiktoken<1.0,>=0.11.0
 Requires-Dist: toml<0.11.0,>=0.10.2