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

django_cfg/core/integration/display/grpc_display.py

@@ -0,0 +1,144 @@
+"""
+gRPC Server Display Manager.
+
+Displays startup information specific to gRPC server.
+"""
+
+from rich.table import Table
+from rich.text import Text
+
+from .base import BaseDisplayManager
+
+
+class GRPCDisplayManager(BaseDisplayManager):
+    """Manager for displaying gRPC server startup information."""
+
+    def display_grpc_startup(
+        self,
+        host: str,
+        port: int,
+        max_workers: int,
+        enable_reflection: bool,
+        enable_health_check: bool,
+        registered_services: int,
+        service_names: list = None,
+    ):
+        """
+        Display gRPC server startup information.
+
+        Args:
+            host: Server host
+            port: Server port
+            max_workers: Maximum worker threads
+            enable_reflection: Whether reflection is enabled
+            enable_health_check: Whether health check is enabled
+            registered_services: Number of registered services
+            service_names: List of registered service names (optional)
+        """
+        # Display header with gRPC indicator
+        header_text = self.create_header_text(show_update_check=True)
+        # Add gRPC server indicator
+        header_text.append(" • ", style="dim")
+        header_text.append("⚡ gRPC Server", style="magenta bold")
+
+        self.console.print(header_text)
+        self.print_spacing()
+
+        # Create server info table
+        server_table = self.create_table()
+        server_table.add_column("Setting", style="cyan", width=25)
+        server_table.add_column("Value", style="white")
+
+        # Server connection info
+        address = f"{host}:{port}"
+        server_table.add_row("⚡ gRPC Server", f"[bold green]{address}[/bold green]")
+        server_table.add_row("👷 Max Workers", str(max_workers))
+
+        # Features
+        reflection_status = "✅ Enabled" if enable_reflection else "❌ Disabled"
+        health_status = "✅ Enabled" if enable_health_check else "❌ Disabled"
+        server_table.add_row("🔍 Reflection", reflection_status)
+        server_table.add_row("❤️ Health Check", health_status)
+
+        # Services
+        services_text = (
+            f"[bold green]{registered_services}[/bold green]"
+            if registered_services > 0
+            else "[yellow]0 (no services registered)[/yellow]"
+        )
+        server_table.add_row("📦 Services", services_text)
+
+        # Create server panel
+        server_panel = self.create_panel(
+            server_table,
+            title="⚡ gRPC Server Configuration",
+            border_style="magenta",
+        )
+        self.console.print(server_panel)
+
+        # Display registered services if available
+        if service_names and len(service_names) > 0:
+            self.print_spacing()
+            self._display_services_list(service_names)
+
+        self.print_spacing()
+
+    def _display_services_list(self, service_names: list):
+        """
+        Display list of registered services.
+
+        Args:
+            service_names: List of service names
+        """
+        services_table = self.create_table()
+        services_table.add_column("Service Name", style="cyan")
+        services_table.add_column("Status", style="green")
+
+        for service_name in service_names:
+            services_table.add_row(
+                f"📡 {service_name}",
+                "✅ Registered"
+            )
+
+        services_panel = self.create_panel(
+            services_table,
+            title="📡 Registered Services",
+            border_style="blue",
+        )
+        self.console.print(services_panel)
+
+    def display_grpc_minimal(
+        self,
+        host: str,
+        port: int,
+        registered_services: int,
+    ):
+        """
+        Display minimal gRPC server startup info.
+
+        Args:
+            host: Server host
+            port: Server port
+            registered_services: Number of registered services
+        """
+        # Display header with gRPC indicator
+        header_text = self.create_header_text(show_update_check=True)
+        # Add gRPC server indicator
+        header_text.append(" • ", style="dim")
+        header_text.append("⚡ gRPC Server", style="magenta bold")
+
+        # Add server address and services count
+        address = f"{host}:{port}"
+        header_text.append(" • ", style="dim")
+        header_text.append(f"⚡ {address}", style="magenta bold")
+        header_text.append(" • ", style="dim")
+
+        if registered_services > 0:
+            header_text.append(f"📦 {registered_services} service(s)", style="green")
+        else:
+            header_text.append("📦 no services", style="yellow")
+
+        self.console.print(header_text)
+
+
+__all__ = ["GRPCDisplayManager"]

django_cfg/core/integration/display/startup.py

@@ -41,31 +41,8 @@ class StartupDisplayManager(BaseDisplayManager):
     def display_minimal_info(self):
         """Display minimal startup info (NONE mode)."""
         try:
-            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
-
+            # Use reusable header utility
+            info_text = self.create_header_text(show_update_check=True)
             self.console.print(info_text)
         except Exception as e:
             print(f"❌ ERROR in display_minimal_info: {e}")
@@ -76,17 +53,10 @@ class StartupDisplayManager(BaseDisplayManager):
     def display_essential_info(self):
         """Display essential startup info (SHORT mode)."""
         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")
+            # Create compact header using reusable utility
+            header_text = self.create_header_text(show_update_check=False)
 
             header_panel = self.create_panel(
                 header_text,
@@ -122,6 +92,11 @@ class StartupDisplayManager(BaseDisplayManager):
                 LIB_SUPPORT_URL,
             )
 
+            # Display header using reusable utility
+            header_text = self.create_header_text(show_update_check=False)
+            self.console.print(header_text)
+            self.print_spacing()
+
             # Create main info table
             info_table = self.create_table()
             info_table.add_column("Setting", style="cyan", width=30)
@@ -131,6 +106,11 @@ class StartupDisplayManager(BaseDisplayManager):
             info_table.add_row("🔗 Prefix", "/cfg/")
             info_table.add_row("🌍 Environment", self.config.env_mode)
             info_table.add_row("🔧 Debug", str(self.config.debug))
+
+            # Show debug_warnings status
+            if self.config.debug_warnings:
+                info_table.add_row("🔍 Warnings Debug", "[yellow]Enabled (full traceback)[/yellow]")
+
             info_table.add_row("🏗️ Project", self.config.project_name)
 
             # Add environment source
@@ -416,20 +396,20 @@ class StartupDisplayManager(BaseDisplayManager):
             task_table.add_column("Value", style="white")
 
             # Show real tasks status
-            tasks_enabled = self.config.should_enable_tasks()
+            tasks_enabled = self.config.should_enable_rq()
             if tasks_enabled:
                 task_table.add_row("Tasks Enabled", "[green]True[/green]")
             else:
                 task_table.add_row("Tasks Enabled", "[yellow]False[/yellow]")
 
-            if hasattr(self.config, 'tasks') and self.config.tasks:
-                queue_name = getattr(self.config.tasks, 'queue_name', 'default')
-                task_table.add_row("Queue", f"[yellow]{queue_name}[/yellow]")
+            if hasattr(self.config, 'django_rq') and self.config.django_rq:
+                queue_names = ', '.join(self.config.django_rq.get_queue_names())
+                task_table.add_row("Queues", f"[yellow]{queue_names}[/yellow]")
             else:
-                task_table.add_row("Queue", "[yellow]default[/yellow]")
+                task_table.add_row("Queues", "[yellow]default[/yellow]")
 
             # Add worker command
-            task_table.add_row("Start Workers", "[bright_blue]poetry run python manage.py runrearq[/bright_blue]")
+            task_table.add_row("Start Workers", "[bright_blue]poetry run python manage.py rqworker default[/bright_blue]")
 
             task_panel = self.create_full_width_panel(
                 task_table,
@@ -465,17 +445,10 @@ class StartupDisplayManager(BaseDisplayManager):
             payments_count = 0
 
             config = self.config
-            if config and config.should_enable_tasks():
-                try:
-                    from django_cfg.modules.django_tasks import extend_constance_config_with_tasks
-                    tasks_fields = extend_constance_config_with_tasks()
-                    tasks_count = len(tasks_fields)
-                except:
-                    pass
 
             if config and config.enable_knowbase:
                 try:
-                    from django_cfg.apps.knowbase.config import (
+                    from django_cfg.apps.business.knowbase.config import (
                         get_django_cfg_knowbase_constance_fields,
                     )
                     knowbase_fields = get_django_cfg_knowbase_constance_fields()
@@ -485,7 +458,7 @@ class StartupDisplayManager(BaseDisplayManager):
 
             if config and config.payments and config.payments.enabled:
                 try:
-                    from django_cfg.apps.payments.config import (
+                    from django_cfg.apps.business.payments.config import (
                         get_django_cfg_payments_constance_fields,
                     )
                     payments_fields = get_django_cfg_payments_constance_fields()
@@ -623,17 +596,10 @@ class StartupDisplayManager(BaseDisplayManager):
 
             # Try to get individual app field counts
             config = self.config
-            if config and config.should_enable_tasks():
-                try:
-                    from django_cfg.modules.django_tasks import extend_constance_config_with_tasks
-                    tasks_fields = extend_constance_config_with_tasks()
-                    tasks_count = len(tasks_fields)
-                except:
-                    pass
 
             if config and config.enable_knowbase:
                 try:
-                    from django_cfg.apps.knowbase.config import (
+                    from django_cfg.apps.business.knowbase.config import (
                         get_django_cfg_knowbase_constance_fields,
                     )
                     knowbase_fields = get_django_cfg_knowbase_constance_fields()
@@ -643,7 +609,7 @@ class StartupDisplayManager(BaseDisplayManager):
 
             if config and config.payments and config.payments.enabled:
                 try:
-                    from django_cfg.apps.payments.config import (
+                    from django_cfg.apps.business.payments.config import (
                         get_django_cfg_payments_constance_fields,
                     )
                     payments_fields = get_django_cfg_payments_constance_fields()

django_cfg/middleware/authentication.py

@@ -60,7 +60,7 @@ class JWTAuthenticationWithLastLogin(JWTAuthentication):
     Usage:
         Add to REST_FRAMEWORK settings:
         'DEFAULT_AUTHENTICATION_CLASSES': [
-            'django_cfg.apps.accounts.authentication.JWTAuthenticationWithLastLogin',
+            'django_cfg.apps.business.accounts.authentication.JWTAuthenticationWithLastLogin',
         ]
     """
 

django_cfg/mixins/__init__.py

@@ -5,8 +5,10 @@ Shared mixins for DRF views and viewsets.
 """
 from .admin_api import AdminAPIMixin
 from .client_api import ClientAPIMixin
+from .superadmin_api import SuperAdminAPIMixin
 
 __all__ = [
     "AdminAPIMixin",
     "ClientAPIMixin",
+    "SuperAdminAPIMixin",
 ]

django_cfg/mixins/superadmin_api.py

@@ -0,0 +1,59 @@
+"""
+SuperAdmin API Mixin.
+
+Common configuration for superuser-only API endpoints.
+More restrictive than AdminAPIMixin - requires is_superuser flag.
+"""
+from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+from rest_framework.permissions import BasePermission
+from rest_framework_simplejwt.authentication import JWTAuthentication
+
+
+class IsSuperUser(BasePermission):
+    """
+    Permission that allows access only to superusers.
+
+    More restrictive than IsAdminUser - requires is_superuser flag.
+    Use for sensitive operations like command execution.
+    """
+
+    def has_permission(self, request, view):
+        """Check if user is authenticated and is a superuser."""
+        return bool(
+            request.user and
+            request.user.is_authenticated and
+            request.user.is_superuser
+        )
+
+
+class SuperAdminAPIMixin:
+    """
+    Mixin for superuser-only API endpoints.
+
+    Provides:
+    - JWT, Session, and Basic authentication
+    - IsSuperUser permission requirement (is_superuser=True)
+
+    Usage:
+        class MyViewSet(SuperAdminAPIMixin, viewsets.ModelViewSet):
+            queryset = MyModel.objects.all()
+            serializer_class = MySerializer
+
+    Authentication Methods:
+        1. JWT Token (Bearer): For frontend SPA authentication
+        2. Session: For Django admin integration
+        3. Basic Auth: For testing and scripts
+
+    All endpoints require superuser privileges.
+    Only use this for sensitive operations like:
+    - Command execution
+    - System configuration changes
+    - Direct database operations
+    """
+
+    authentication_classes = [
+        JWTAuthentication,      # JWT tokens (Bearer)
+        SessionAuthentication,  # Django session (for admin)
+        BasicAuthentication,    # HTTP Basic (for testing)
+    ]
+    permission_classes = [IsSuperUser]

django_cfg/models/__init__.py

@@ -35,7 +35,7 @@ from .base.module import BaseCfgAutoModule
 from .django.axes import AxesConfig
 from .django.constance import ConstanceConfig, ConstanceField
 from .django.crypto_fields import CryptoFieldsConfig
-from .django.django_q2 import DjangoQ2Config, DjangoQ2ScheduleConfig
+from .django.django_rq import DjangoRQConfig, RQQueueConfig
 from .django.environment import EnvironmentConfig
 from .django.openapi import OpenAPIClientConfig
 from .infrastructure.cache import CacheConfig
@@ -80,8 +80,8 @@ __all__ = [
     "EnvironmentConfig",
     "ConstanceConfig",
     "ConstanceField",
-    "DjangoQ2Config",
-    "DjangoQ2ScheduleConfig",
+    "DjangoRQConfig",
+    "RQQueueConfig",
     "OpenAPIClientConfig",
     "UnfoldConfig",
     "AxesConfig",

django_cfg/models/api/grpc/__init__.py

@@ -0,0 +1,59 @@
+"""
+gRPC configuration models.
+
+Type-safe Pydantic v2 models for gRPC server, authentication, and proto generation.
+
+Requires: pip install django-cfg[grpc]
+
+Example:
+    >>> from django_cfg.models.api.grpc import GRPCConfig, GRPCServerConfig
+    >>> config = GRPCConfig(
+    ...     enabled=True,
+    ...     server=GRPCServerConfig(port=50051)
+    ... )
+"""
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .config import (
+        GRPCAuthConfig,
+        GRPCConfig,
+        GRPCProtoConfig,
+        GRPCServerConfig,
+    )
+
+__all__ = [
+    "GRPCConfig",
+    "GRPCServerConfig",
+    "GRPCAuthConfig",
+    "GRPCProtoConfig",
+]
+
+
+def __getattr__(name: str):
+    """Lazy import with helpful error message."""
+    if name in __all__:
+        try:
+            from .config import (
+                GRPCAuthConfig,
+                GRPCConfig,
+                GRPCProtoConfig,
+                GRPCServerConfig,
+            )
+
+            return {
+                "GRPCConfig": GRPCConfig,
+                "GRPCServerConfig": GRPCServerConfig,
+                "GRPCAuthConfig": GRPCAuthConfig,
+                "GRPCProtoConfig": GRPCProtoConfig,
+            }[name]
+
+        except ImportError as e:
+            raise ImportError(
+                f"gRPC support requires additional dependencies. "
+                f"Install with: pip install django-cfg[grpc]\n"
+                f"Missing module: {e.name}"
+            ) from e
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")