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

django_cfg/apps/integrations/grpc/services/discovery.py

@@ -53,6 +53,10 @@ class ServiceDiscovery:
         # Get config from django-cfg using Pydantic2 pattern
         self.config = get_grpc_config()
 
+        logger.warning(f"🔍 ServiceDiscovery.__init__: config = {self.config}")
+        if self.config:
+            logger.warning(f"🔍 handlers_hook = {self.config.handlers_hook}")
+
         if self.config:
             self.auto_register = self.config.auto_register_apps
             self.enabled_apps = self.config.enabled_apps if self.config.auto_register_apps else []
@@ -452,11 +456,13 @@ class ServiceDiscovery:
             >>> if handlers_hook:
             ...     services = handlers_hook(server)
         """
+        logger.warning(f"🔍 get_handlers_hook called")
         if not self.config:
-            logger.debug("No gRPC config available")
+            logger.warning("❌ No gRPC config available")
             return None
 
         handlers_hook_path = self.config.handlers_hook
+        logger.warning(f"🔍 handlers_hook_path = '{handlers_hook_path}'")
 
         if not handlers_hook_path:
             logger.debug("No handlers_hook configured")

django_cfg/apps/integrations/grpc/utils/SERVER_LOGGING.md

@@ -0,0 +1,164 @@
+# Server Lifecycle Logging Utilities
+
+Reusable functions for logging server startup and shutdown with timestamps and uptime tracking.
+
+**Uses Rich** for beautiful output with panels, tables, and colors! 🎨
+
+## 📦 Functions
+
+### `log_server_start()`
+
+Logs server startup with timestamp and configuration.
+
+```python
+from django_cfg.apps.integrations.grpc.utils import log_server_start
+
+start_time = log_server_start(
+    logger,
+    server_type="gRPC Server",       # Server type
+    mode="Development",               # Production/Development
+    hotreload_enabled=True,           # Is hotreload enabled?
+    host="0.0.0.0",                   # Additional parameters
+    port=50051
+)
+```
+
+**Output (Rich Panel):**
+```
+╭────────────── 🚀 gRPC Server Starting ───────────────╮
+│                                                      │
+│  ⏰ Started at    2025-11-05 14:30:15               │
+│  Mode            Development                        │
+│  Hotreload       Enabled ⚡                          │
+│  Host            0.0.0.0                            │
+│  Port            50051                              │
+│                                                      │
+╰──────────────────────────────────────────────────────╯
+⚠️  Hotreload active - connections may be dropped on code changes
+```
+(with green border and colors!)
+
+**Returns:** `datetime` object of start time (for use in `log_server_shutdown`)
+
+---
+
+### `log_server_shutdown()`
+
+Logs server shutdown with uptime calculation.
+
+```python
+from django_cfg.apps.integrations.grpc.utils import log_server_shutdown
+
+log_server_shutdown(
+    logger,
+    start_time,                       # datetime from log_server_start()
+    server_type="gRPC Server",
+    reason="Hotreload triggered",     # Shutdown reason
+    active_connections=5              # Additional parameters
+)
+```
+
+**Output (Rich Panel):**
+```
+╭───────────── 🧹 Shutting down gRPC Server ──────────────╮
+│                                                          │
+│  📋 Reason            Hotreload triggered               │
+│  ⏱️  Uptime            0h 2m 35s                         │
+│  🕐 Stopped at        2025-11-05 14:32:50               │
+│  Active Connections  5                                  │
+│                                                          │
+╰──────────────────────────────────────────────────────────╯
+✅ Server shutdown complete
+```
+(with red border and colors!)
+
+---
+
+## 🎯 Complete Usage Example
+
+```python
+from django_cfg.apps.integrations.grpc.utils import (
+    setup_streaming_logger,
+    log_server_start,
+    log_server_shutdown,
+)
+
+# Create logger
+logger = setup_streaming_logger('my_server')
+
+# Log server start
+start_time = log_server_start(
+    logger,
+    server_type="WebSocket Server",
+    mode="Production",
+    hotreload_enabled=False,
+    host="0.0.0.0",
+    port=8000
+)
+
+try:
+    # Server work...
+    await server.serve_forever()
+    shutdown_reason = "Normal termination"
+except KeyboardInterrupt:
+    shutdown_reason = "Keyboard interrupt"
+finally:
+    # Log server shutdown
+    log_server_shutdown(
+        logger,
+        start_time,
+        server_type="WebSocket Server",
+        reason=shutdown_reason,
+        total_connections=1250
+    )
+```
+
+---
+
+## 📊 Used in:
+
+- ✅ `rungrpc` - gRPC server command
+- ✅ Can be used for any servers (WebSocket, HTTP, etc.)
+
+---
+
+## 🔧 Parameters
+
+### `log_server_start()`
+
+| Parameter | Type | Required | Description |
+|----------|-----|----------|-------------|
+| `logger` | `logging.Logger` | ✅ Yes | Logger instance |
+| `server_type` | `str` | ❌ No | Server type (default: "Server") |
+| `mode` | `str` | ❌ No | Running mode (default: "Development") |
+| `hotreload_enabled` | `bool` | ❌ No | Is hotreload enabled (default: False) |
+| `use_rich` | `bool` | ❌ No | Use Rich for output (default: True) |
+| `**extra_info` | `dict` | ❌ No | Additional key-value pairs to log |
+
+### `log_server_shutdown()`
+
+| Parameter | Type | Required | Description |
+|----------|-----|----------|-------------|
+| `logger` | `logging.Logger` | ✅ Yes | Logger instance |
+| `start_time` | `datetime` | ✅ Yes | Start time from `log_server_start()` |
+| `server_type` | `str` | ❌ No | Server type (default: "Server") |
+| `reason` | `str` | ❌ No | Shutdown reason |
+| `use_rich` | `bool` | ❌ No | Use Rich for output (default: True) |
+| `**extra_info` | `dict` | ❌ No | Additional key-value pairs to log |
+
+---
+
+## 💡 Benefits
+
+1. ✅ **DRY** - single code for all servers
+2. ✅ **Consistency** - uniform log format
+3. ✅ **Rich UI** - beautiful panels, tables, colors 🎨
+4. ✅ **Uptime tracking** - automatic time calculation
+5. ✅ **Flexible** - can add arbitrary parameters via `**extra_info`
+6. ✅ **Hotreload aware** - special warning for hotreload mode
+7. ✅ **Fallback** - works without Rich (if `use_rich=False`)
+
+---
+
+**Author:** django-cfg team
+**Date:** 2025-11-05

django_cfg/apps/integrations/grpc/utils/streaming_logger.py

@@ -12,6 +12,12 @@ from pathlib import Path
 from typing import Optional
 from django.utils import timezone
 
+# Rich for beautiful console output
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
 
 class AutoTracebackHandler(logging.Handler):
     """
@@ -128,11 +134,14 @@ def setup_streaming_logger(
     file_handler = AutoTracebackHandler(base_file_handler)
     streaming_logger.addHandler(file_handler)
 
-    # Console handler - important messages only
-    console_handler = logging.StreamHandler()
-    console_handler.setLevel(console_level)
+    # Console handler - important messages only (also with auto-traceback)
+    base_console_handler = logging.StreamHandler()
+    base_console_handler.setLevel(console_level)
     console_formatter = logging.Formatter('%(levelname)s: %(message)s')
-    console_handler.setFormatter(console_formatter)
+    base_console_handler.setFormatter(console_formatter)
+
+    # Wrap console handler with auto-traceback too
+    console_handler = AutoTracebackHandler(base_console_handler)
     streaming_logger.addHandler(console_handler)
 
     # Prevent propagation to avoid duplicate logs
@@ -174,4 +183,196 @@ def get_streaming_logger(name: str = "grpc_streaming") -> logging.Logger:
     return logger
 
 
-__all__ = ["setup_streaming_logger", "get_streaming_logger"]
+def log_server_start(
+    logger: logging.Logger,
+    server_type: str = "Server",
+    mode: str = "Development",
+    hotreload_enabled: bool = False,
+    use_rich: bool = True,
+    **extra_info
+):
+    """
+    Log server startup with timestamp and configuration using Rich panels.
+
+    Args:
+        logger: Logger instance to use
+        server_type: Type of server (e.g., "gRPC Server", "WebSocket Server")
+        mode: Running mode (Development/Production)
+        hotreload_enabled: Whether hot-reload is enabled
+        use_rich: Use Rich for beautiful output (default: True)
+        **extra_info: Additional key-value pairs to log
+
+    Example:
+        ```python
+        from django_cfg.apps.integrations.grpc.utils import log_server_start
+        from datetime import datetime
+
+        start_time = log_server_start(
+            logger,
+            server_type="gRPC Server",
+            mode="Development",
+            hotreload_enabled=True,
+            host="0.0.0.0",
+            port=50051
+        )
+        ```
+
+    Returns:
+        datetime object of start time for later use in log_server_shutdown
+    """
+    from datetime import datetime
+
+    start_time = datetime.now()
+
+    if use_rich:
+        # Create Rich table for server info
+        console = Console()
+
+        table = Table(show_header=False, box=None, padding=(0, 1))
+        table.add_column("Key", style="cyan")
+        table.add_column("Value", style="white")
+
+        table.add_row("⏰ Started at", start_time.strftime('%Y-%m-%d %H:%M:%S'))
+        table.add_row("Mode", f"[{'red' if mode == 'Production' else 'green'}]{mode}[/]")
+        table.add_row("Hotreload", f"[{'yellow' if hotreload_enabled else 'dim'}]{'Enabled ⚡' if hotreload_enabled else 'Disabled'}[/]")
+
+        # Add extra info
+        for key, value in extra_info.items():
+            key_display = key.replace('_', ' ').title()
+            table.add_row(key_display, str(value))
+
+        # Create panel
+        panel = Panel(
+            table,
+            title=f"[bold green]🚀 {server_type} Starting[/bold green]",
+            border_style="green",
+            padding=(1, 2)
+        )
+
+        console.print(panel)
+
+        if hotreload_enabled:
+            console.print(
+                "[yellow]⚠️  Hotreload active - connections may be dropped on code changes[/yellow]",
+                style="bold"
+            )
+    else:
+        # Fallback to simple logging
+        logger.info("=" * 80)
+        logger.info(f"🚀 {server_type} Starting")
+        logger.info(f"   ⏰ Started at: {start_time.strftime('%Y-%m-%d %H:%M:%S')}")
+        logger.info(f"   Mode: {mode}")
+        logger.info(f"   Hotreload: {'Enabled' if hotreload_enabled else 'Disabled'}")
+
+        for key, value in extra_info.items():
+            key_display = key.replace('_', ' ').title()
+            logger.info(f"   {key_display}: {value}")
+
+        if hotreload_enabled:
+            logger.warning(
+                "⚠️  Hotreload active - connections may be dropped on code changes"
+            )
+
+        logger.info("=" * 80)
+
+    return start_time
+
+
+def log_server_shutdown(
+    logger: logging.Logger,
+    start_time,
+    server_type: str = "Server",
+    reason: str = None,
+    use_rich: bool = True,
+    **extra_info
+):
+    """
+    Log server shutdown with uptime calculation using Rich panels.
+
+    Args:
+        logger: Logger instance to use
+        start_time: datetime object from log_server_start()
+        server_type: Type of server (e.g., "gRPC Server", "WebSocket Server")
+        reason: Shutdown reason (e.g., "Keyboard interrupt", "Hotreload")
+        use_rich: Use Rich for beautiful output (default: True)
+        **extra_info: Additional key-value pairs to log
+
+    Example:
+        ```python
+        from django_cfg.apps.integrations.grpc.utils import log_server_shutdown
+
+        log_server_shutdown(
+            logger,
+            start_time,
+            server_type="gRPC Server",
+            reason="Hotreload triggered",
+            active_connections=5
+        )
+        ```
+    """
+    from datetime import datetime
+
+    end_time = datetime.now()
+    uptime = end_time - start_time
+    uptime_seconds = int(uptime.total_seconds())
+
+    # Format uptime
+    hours = uptime_seconds // 3600
+    minutes = (uptime_seconds % 3600) // 60
+    seconds = uptime_seconds % 60
+    uptime_str = f"{hours}h {minutes}m {seconds}s"
+
+    if use_rich:
+        # Create Rich table for shutdown info
+        console = Console()
+
+        table = Table(show_header=False, box=None, padding=(0, 1))
+        table.add_column("Key", style="cyan")
+        table.add_column("Value", style="white")
+
+        if reason:
+            table.add_row("📋 Reason", reason)
+
+        table.add_row("⏱️  Uptime", f"[bold]{uptime_str}[/bold]")
+        table.add_row("🕐 Stopped at", end_time.strftime('%Y-%m-%d %H:%M:%S'))
+
+        # Add extra info
+        for key, value in extra_info.items():
+            key_display = key.replace('_', ' ').title()
+            table.add_row(key_display, str(value))
+
+        # Create panel
+        panel = Panel(
+            table,
+            title=f"[bold red]🧹 Shutting down {server_type}[/bold red]",
+            border_style="red",
+            padding=(1, 2)
+        )
+
+        console.print(panel)
+        console.print("[green]✅ Server shutdown complete[/green]", style="bold")
+    else:
+        # Fallback to simple logging
+        logger.info("=" * 80)
+        logger.info(f"🧹 Shutting down {server_type}...")
+
+        if reason:
+            logger.info(f"   📋 Reason: {reason}")
+
+        logger.info(f"   ⏱️  Uptime: {uptime_str}")
+        logger.info(f"   🕐 Stopped at: {end_time.strftime('%Y-%m-%d %H:%M:%S')}")
+
+        for key, value in extra_info.items():
+            key_display = key.replace('_', ' ').title()
+            logger.info(f"   {key_display}: {value}")
+
+        logger.info("✅ Server shutdown complete")
+        logger.info("=" * 80)
+
+
+__all__ = [
+    "setup_streaming_logger",
+    "get_streaming_logger",
+    "log_server_start",
+    "log_server_shutdown",
+]

django_cfg/apps/system/dashboard/serializers/config.py

@@ -5,6 +5,8 @@ Serializers for displaying user's DjangoConfig settings.
 """
 
 from rest_framework import serializers
+from drf_spectacular.utils import extend_schema_field
+from drf_spectacular.types import OpenApiTypes
 
 
 # Nested serializers for complex structures
@@ -89,6 +91,18 @@ class RedisQueueConfigSerializer(serializers.Serializer):
     socket_timeout = serializers.IntegerField(required=False, allow_null=True)
 
 
+class RQScheduleSerializer(serializers.Serializer):
+    """Redis Queue schedule configuration."""
+    func = serializers.CharField(required=False, allow_null=True)
+    cron_string = serializers.CharField(required=False, allow_null=True)
+    queue = serializers.CharField(required=False, allow_null=True)
+    kwargs = serializers.DictField(required=False, allow_null=True)
+    args = serializers.ListField(required=False, allow_null=True)
+    meta = serializers.DictField(required=False, allow_null=True)
+    repeat = serializers.IntegerField(required=False, allow_null=True)
+    result_ttl = serializers.IntegerField(required=False, allow_null=True)
+
+
 class DjangoRQConfigSerializer(serializers.Serializer):
     """Django-RQ configuration."""
     enabled = serializers.BooleanField(required=False, allow_null=True)
@@ -97,7 +111,7 @@ class DjangoRQConfigSerializer(serializers.Serializer):
     exception_handlers = serializers.ListField(required=False, allow_null=True)
     api_token = serializers.CharField(required=False, allow_null=True)
     prometheus_enabled = serializers.BooleanField(required=False, allow_null=True)
-    schedules = serializers.ListField(child=serializers.DictField(), required=False, allow_null=True)
+    schedules = serializers.ListField(child=RQScheduleSerializer(), required=False, allow_null=True)
 
 
 class DRFConfigSerializer(serializers.Serializer):
@@ -126,6 +140,78 @@ class ConfigMetaSerializer(serializers.Serializer):
     secret_key_configured = serializers.BooleanField()
 
 
+class TelegramConfigSerializer(serializers.Serializer):
+    """Telegram service configuration."""
+    bot_token = serializers.CharField(required=False, allow_null=True)
+    chat_id = serializers.IntegerField(required=False, allow_null=True)
+    parse_mode = serializers.CharField(required=False, allow_null=True)
+    disable_notification = serializers.BooleanField(required=False, allow_null=True)
+    disable_web_page_preview = serializers.BooleanField(required=False, allow_null=True)
+    timeout = serializers.IntegerField(required=False, allow_null=True)
+    webhook_url = serializers.CharField(required=False, allow_null=True)
+    webhook_secret = serializers.CharField(required=False, allow_null=True)
+    max_retries = serializers.IntegerField(required=False, allow_null=True)
+    retry_delay = serializers.FloatField(required=False, allow_null=True)
+
+
+class NgrokConfigSerializer(serializers.Serializer):
+    """Ngrok tunneling configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    authtoken = serializers.CharField(required=False, allow_null=True)
+    basic_auth = serializers.ListField(required=False, allow_null=True)
+    compression = serializers.BooleanField(required=False, allow_null=True)
+
+
+class AxesConfigSerializer(serializers.Serializer):
+    """Django-Axes brute-force protection configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    failure_limit = serializers.IntegerField(required=False, allow_null=True)
+    cooloff_time = serializers.IntegerField(required=False, allow_null=True)
+    lock_out_at_failure = serializers.BooleanField(required=False, allow_null=True)
+    reset_on_success = serializers.BooleanField(required=False, allow_null=True)
+    only_user_failures = serializers.BooleanField(required=False, allow_null=True)
+    lockout_template = serializers.CharField(required=False, allow_null=True)
+    lockout_url = serializers.CharField(required=False, allow_null=True)
+    verbose = serializers.BooleanField(required=False, allow_null=True)
+    enable_access_failure_log = serializers.BooleanField(required=False, allow_null=True)
+    ipware_proxy_count = serializers.IntegerField(required=False, allow_null=True)
+    ipware_meta_precedence_order = serializers.ListField(required=False, allow_null=True)
+    allowed_ips = serializers.ListField(required=False, allow_null=True)
+    denied_ips = serializers.ListField(required=False, allow_null=True)
+    cache_name = serializers.CharField(required=False, allow_null=True)
+    use_user_agent = serializers.BooleanField(required=False, allow_null=True)
+    username_form_field = serializers.CharField(required=False, allow_null=True)
+
+
+class NextJSAdminConfigSerializer(serializers.Serializer):
+    """Next.js Admin application configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    url = serializers.CharField(required=False, allow_null=True)
+    api_base_url = serializers.CharField(required=False, allow_null=True)
+
+
+class ConstanceConfigSerializer(serializers.Serializer):
+    """Django-Constance dynamic settings configuration."""
+    config = serializers.DictField(required=False, allow_null=True)
+    config_fieldsets = serializers.DictField(required=False, allow_null=True)
+    backend = serializers.CharField(required=False, allow_null=True)
+    database_prefix = serializers.CharField(required=False, allow_null=True)
+    database_cache_backend = serializers.CharField(required=False, allow_null=True)
+    additional_config = serializers.DictField(required=False, allow_null=True)
+
+
+class OpenAPIClientConfigSerializer(serializers.Serializer):
+    """OpenAPI Client generation configuration."""
+    enabled = serializers.BooleanField(required=False, allow_null=True)
+    output_dir = serializers.CharField(required=False, allow_null=True)
+    client_name = serializers.CharField(required=False, allow_null=True)
+    schema_url = serializers.CharField(required=False, allow_null=True)
+    generator = serializers.CharField(required=False, allow_null=True)
+    additional_properties = serializers.DictField(required=False, allow_null=True)
+    templates = serializers.ListField(required=False, allow_null=True)
+    global_properties = serializers.DictField(required=False, allow_null=True)
+
+
 class DjangoConfigSerializer(serializers.Serializer):
     """
     Typed serializer for user's DjangoConfig settings.
@@ -188,10 +274,10 @@ class DjangoConfigSerializer(serializers.Serializer):
     spectacular = SpectacularConfigSerializer(required=False, allow_null=True)
     jwt = JWTConfigSerializer(required=False, allow_null=True)
 
-    # Other configs (pass-through for flexibility)
-    telegram = serializers.DictField(required=False, allow_null=True)
-    ngrok = serializers.DictField(required=False, allow_null=True)
-    axes = serializers.DictField(required=False, allow_null=True)
+    # Services & Security (now typed!)
+    telegram = TelegramConfigSerializer(required=False, allow_null=True)
+    ngrok = NgrokConfigSerializer(required=False, allow_null=True)
+    axes = AxesConfigSerializer(required=False, allow_null=True)
     crypto_fields = serializers.DictField(required=False, allow_null=True)
     unfold = serializers.CharField(required=False, allow_null=True)  # String representation of Unfold config
     tailwind_app_name = serializers.CharField(required=False, allow_null=True)
@@ -199,10 +285,10 @@ class DjangoConfigSerializer(serializers.Serializer):
     limits = serializers.DictField(required=False, allow_null=True)
     api_keys = serializers.DictField(required=False, allow_null=True)
     custom_middleware = serializers.ListField(required=False, allow_null=True)
-    nextjs_admin = serializers.DictField(required=False, allow_null=True)
+    nextjs_admin = NextJSAdminConfigSerializer(required=False, allow_null=True)
     admin_emails = serializers.ListField(required=False, allow_null=True)
-    constance = serializers.DictField(required=False, allow_null=True)
-    openapi_client = serializers.DictField(required=False, allow_null=True)
+    constance = ConstanceConfigSerializer(required=False, allow_null=True)
+    openapi_client = OpenAPIClientConfigSerializer(required=False, allow_null=True)
 
     # Metadata
     _meta = ConfigMetaSerializer(required=False, allow_null=True)
@@ -238,7 +324,7 @@ class ConfigDataSerializer(serializers.Serializer):
         help_text="User's DjangoConfig settings"
     )
     django_settings = serializers.DictField(
-        help_text="Complete Django settings (sanitized)"
+        help_text="Complete Django settings (sanitized, contains mixed types)"
     )
     _validation = ConfigValidationSerializer(
         help_text="Validation result comparing serializer with actual config"

django_cfg/apps/system/dashboard/serializers/statistics.py

@@ -36,11 +36,16 @@ class UserStatisticsSerializer(serializers.Serializer):
     superusers = serializers.IntegerField(help_text="Number of superusers")
 
 
+class AppStatisticsDataSerializer(serializers.Serializer):
+    """Serializer for application statistics data."""
+
+    name = serializers.CharField(help_text="Human-readable app name")
+    total_records = serializers.IntegerField(help_text="Total records count")
+    model_count = serializers.IntegerField(help_text="Number of models")
+
+
 class AppStatisticsSerializer(serializers.Serializer):
     """Serializer for application-specific statistics."""
 
     app_name = serializers.CharField(help_text="Application name")
-    statistics = serializers.DictField(
-        child=serializers.IntegerField(),
-        help_text="Application statistics"
-    )
+    statistics = AppStatisticsDataSerializer(help_text="Application statistics")