django-cfg 1.5.24__tar.gz → 1.5.29__tar.gz

{django_cfg-1.5.24 → django_cfg-1.5.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.5.24
+Version: 1.5.29
 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
@@ -196,7 +196,7 @@ Description-Content-Type: text/markdown
 
 ### 🚀 The Modern Django Framework for Enterprise Applications
 
-**Type-safe configuration** • **Next.js Admin** • **AI Agents** • **Real-time WebSockets** • **8 Enterprise Apps**
+**Type-safe configuration** • **Next.js Admin** • **gRPC Streaming** • **Real-time WebSockets** • **AI Agents** • **8 Enterprise Apps**
 
 **[🎯 Live Demo](http://demo.djangocfg.com)** • **[📚 Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[🐙 GitHub](https://github.com/markolofsen/django-cfg)**
 
@@ -396,6 +396,72 @@ class MyConfig(DjangoConfig):
 
 ---
 
+### 🌐 gRPC Microservices & Streaming
+
+**Production-ready gRPC integration** - bidirectional streaming, WebSocket bridge, and type-safe Protobuf.
+
+```python
+from django_cfg.apps.integrations.grpc.services.centrifugo import (
+    CentrifugoBridgeMixin,
+    CentrifugoChannels,
+    ChannelConfig,
+)
+
+# Define type-safe channel mappings
+class BotChannels(CentrifugoChannels):
+    heartbeat: ChannelConfig = ChannelConfig(
+        template='bot#{bot_id}#heartbeat',
+        rate_limit=5.0,  # Max once per 5 seconds
+    )
+    status: ChannelConfig = ChannelConfig(
+        template='bot#{bot_id}#status',
+        critical=True,  # Bypass rate limiting
+    )
+
+# gRPC service with automatic WebSocket publishing
+class BotStreamingService(
+    pb2_grpc.BotStreamingServiceServicer,
+    CentrifugoBridgeMixin  # ← One-line WebSocket integration
+):
+    centrifugo_channels = BotChannels()
+    
+    async def ConnectBot(self, request_iterator, context):
+        async for message in request_iterator:
+            # Your business logic
+            await process_message(message)
+            
+            # Auto-publish to WebSocket (1 line!)
+            await self._notify_centrifugo(message, bot_id=bot_id)
+```
+
+**Built-in features:**
+- 🔄 **Bidirectional Streaming** - Full-duplex gRPC communication
+- 🌉 **Centrifugo Bridge** - Auto-publish gRPC events to WebSocket
+- 🛡️ **Circuit Breaker** - Graceful degradation if Centrifugo unavailable
+- 🔁 **Auto Retry** - Exponential backoff for critical events
+- 📦 **Dead Letter Queue** - Never lose important messages
+- ⚡ **Rate Limiting** - Per-channel throttling with critical bypass
+- 🎯 **Type-Safe Config** - Pydantic v2 validation for channels
+
+**Architecture:**
+```
+Trading Bot ──gRPC──> Django gRPC Service ──WebSocket──> Browser
+                            ↓
+                      [Business Logic]
+                      [Database Save]
+                      [Centrifugo Publish]
+```
+
+**Why this approach?**
+- ✅ Django controls all business logic and validation
+- ✅ Single source of truth for data transformations
+- ✅ Graceful degradation - gRPC works even if WebSocket fails
+- ✅ Production-ready resilience patterns built-in
+
+**[📚 gRPC Integration Guide →](https://djangocfg.com/docs/features/integrations/grpc)**
+
+---
+
 ### 🤖 AI-Ready Infrastructure
 
 **Built-in AI agent framework** - LLM workflow automation with Django ORM integration.
@@ -587,9 +653,11 @@ class ProductionConfig(DjangoConfig):
 - **[Quick Start](https://djangocfg.com/docs/features/integrations/nextjs-admin/quick-start)** - 5-minute setup
 - **[Configuration](https://djangocfg.com/docs/features/integrations/nextjs-admin/configuration)** - All options
 
-### 📡 Real-Time Features
+### 📡 Real-Time & Microservices
 - **[Centrifugo Integration](https://djangocfg.com/docs/features/integrations/centrifugo)** - WebSocket setup
 - **[Live Updates](https://djangocfg.com/docs/features/integrations/centrifugo/live-updates)** - Real-time data
+- **[gRPC Streaming](https://djangocfg.com/docs/features/integrations/grpc)** - Bidirectional streaming
+- **[gRPC → WebSocket Bridge](https://djangocfg.com/docs/features/integrations/grpc/centrifugo-bridge)** - Auto-publish to clients
 
 ### 🏗️ Core Features
 - **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps/overview)** - 8 enterprise apps
@@ -634,9 +702,9 @@ class ProductionConfig(DjangoConfig):
 
 <div align="center">
 
-**Modern Django Framework** • **Type-Safe Configuration** • **Next.js Admin** • **Real-Time WebSockets** • **AI-Ready**
+**Modern Django Framework** • **Type-Safe Configuration** • **Next.js Admin** • **gRPC Streaming** • **Real-Time WebSockets** • **AI-Ready**
 
-Django-CFG is the modern Django framework for enterprise applications. Built with Pydantic v2 for type-safe configuration, includes Next.js admin integration, Centrifugo WebSocket support, AI agent framework, and 8 production-ready apps. Perfect for building scalable Django applications with reduced boilerplate and enterprise features out of the box.
+Django-CFG is the modern Django framework for enterprise applications. Built with Pydantic v2 for type-safe configuration, includes Next.js admin integration, gRPC bidirectional streaming with WebSocket bridge, Centrifugo real-time support, AI agent framework, and 8 production-ready apps. Perfect for building scalable microservices and real-time Django applications with reduced boilerplate and enterprise features out of the box.
 
 ---
 

{django_cfg-1.5.24 → django_cfg-1.5.29}/README.md

@@ -17,7 +17,7 @@
 
 ### 🚀 The Modern Django Framework for Enterprise Applications
 
-**Type-safe configuration** • **Next.js Admin** • **AI Agents** • **Real-time WebSockets** • **8 Enterprise Apps**
+**Type-safe configuration** • **Next.js Admin** • **gRPC Streaming** • **Real-time WebSockets** • **AI Agents** • **8 Enterprise Apps**
 
 **[🎯 Live Demo](http://demo.djangocfg.com)** • **[📚 Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[🐙 GitHub](https://github.com/markolofsen/django-cfg)**
 
@@ -217,6 +217,72 @@ class MyConfig(DjangoConfig):
 
 ---
 
+### 🌐 gRPC Microservices & Streaming
+
+**Production-ready gRPC integration** - bidirectional streaming, WebSocket bridge, and type-safe Protobuf.
+
+```python
+from django_cfg.apps.integrations.grpc.services.centrifugo import (
+    CentrifugoBridgeMixin,
+    CentrifugoChannels,
+    ChannelConfig,
+)
+
+# Define type-safe channel mappings
+class BotChannels(CentrifugoChannels):
+    heartbeat: ChannelConfig = ChannelConfig(
+        template='bot#{bot_id}#heartbeat',
+        rate_limit=5.0,  # Max once per 5 seconds
+    )
+    status: ChannelConfig = ChannelConfig(
+        template='bot#{bot_id}#status',
+        critical=True,  # Bypass rate limiting
+    )
+
+# gRPC service with automatic WebSocket publishing
+class BotStreamingService(
+    pb2_grpc.BotStreamingServiceServicer,
+    CentrifugoBridgeMixin  # ← One-line WebSocket integration
+):
+    centrifugo_channels = BotChannels()
+    
+    async def ConnectBot(self, request_iterator, context):
+        async for message in request_iterator:
+            # Your business logic
+            await process_message(message)
+            
+            # Auto-publish to WebSocket (1 line!)
+            await self._notify_centrifugo(message, bot_id=bot_id)
+```
+
+**Built-in features:**
+- 🔄 **Bidirectional Streaming** - Full-duplex gRPC communication
+- 🌉 **Centrifugo Bridge** - Auto-publish gRPC events to WebSocket
+- 🛡️ **Circuit Breaker** - Graceful degradation if Centrifugo unavailable
+- 🔁 **Auto Retry** - Exponential backoff for critical events
+- 📦 **Dead Letter Queue** - Never lose important messages
+- ⚡ **Rate Limiting** - Per-channel throttling with critical bypass
+- 🎯 **Type-Safe Config** - Pydantic v2 validation for channels
+
+**Architecture:**
+```
+Trading Bot ──gRPC──> Django gRPC Service ──WebSocket──> Browser
+                            ↓
+                      [Business Logic]
+                      [Database Save]
+                      [Centrifugo Publish]
+```
+
+**Why this approach?**
+- ✅ Django controls all business logic and validation
+- ✅ Single source of truth for data transformations
+- ✅ Graceful degradation - gRPC works even if WebSocket fails
+- ✅ Production-ready resilience patterns built-in
+
+**[📚 gRPC Integration Guide →](https://djangocfg.com/docs/features/integrations/grpc)**
+
+---
+
 ### 🤖 AI-Ready Infrastructure
 
 **Built-in AI agent framework** - LLM workflow automation with Django ORM integration.
@@ -408,9 +474,11 @@ class ProductionConfig(DjangoConfig):
 - **[Quick Start](https://djangocfg.com/docs/features/integrations/nextjs-admin/quick-start)** - 5-minute setup
 - **[Configuration](https://djangocfg.com/docs/features/integrations/nextjs-admin/configuration)** - All options
 
-### 📡 Real-Time Features
+### 📡 Real-Time & Microservices
 - **[Centrifugo Integration](https://djangocfg.com/docs/features/integrations/centrifugo)** - WebSocket setup
 - **[Live Updates](https://djangocfg.com/docs/features/integrations/centrifugo/live-updates)** - Real-time data
+- **[gRPC Streaming](https://djangocfg.com/docs/features/integrations/grpc)** - Bidirectional streaming
+- **[gRPC → WebSocket Bridge](https://djangocfg.com/docs/features/integrations/grpc/centrifugo-bridge)** - Auto-publish to clients
 
 ### 🏗️ Core Features
 - **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps/overview)** - 8 enterprise apps
@@ -455,9 +523,9 @@ class ProductionConfig(DjangoConfig):
 
 <div align="center">
 
-**Modern Django Framework** • **Type-Safe Configuration** • **Next.js Admin** • **Real-Time WebSockets** • **AI-Ready**
+**Modern Django Framework** • **Type-Safe Configuration** • **Next.js Admin** • **gRPC Streaming** • **Real-Time WebSockets** • **AI-Ready**
 
-Django-CFG is the modern Django framework for enterprise applications. Built with Pydantic v2 for type-safe configuration, includes Next.js admin integration, Centrifugo WebSocket support, AI agent framework, and 8 production-ready apps. Perfect for building scalable Django applications with reduced boilerplate and enterprise features out of the box.
+Django-CFG is the modern Django framework for enterprise applications. Built with Pydantic v2 for type-safe configuration, includes Next.js admin integration, gRPC bidirectional streaming with WebSocket bridge, Centrifugo real-time support, AI agent framework, and 8 production-ready apps. Perfect for building scalable microservices and real-time Django applications with reduced boilerplate and enterprise features out of the box.
 
 ---
 

{django_cfg-1.5.24 → django_cfg-1.5.29}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.5.24"
+version = "1.5.29"
 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",]

{django_cfg-1.5.24 → django_cfg-1.5.29}/src/django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.5.24"
+__version__ = "1.5.29"
 __license__ = "MIT"
 
 # Setup warnings debug early (checks env var only at this point)

{django_cfg-1.5.24 → django_cfg-1.5.29}/src/django_cfg/models/infrastructure/database/config.py

@@ -81,6 +81,18 @@ class DatabaseConfig(BaseModel):
         description="Additional database-specific options",
     )
 
+    # Connection pooling options (CRITICAL for preventing connection exhaustion)
+    conn_max_age: int = Field(
+        default=0,  # 0 disables persistent connections when using connection pooling
+        description="Maximum age of database connections in seconds. Must be 0 when using connection pooling.",
+        ge=0,
+    )
+
+    conn_health_checks: bool = Field(
+        default=True,
+        description="Enable database connection health checks",
+    )
+
     # Database routing configuration
     apps: List[str] = Field(
         default_factory=list,
@@ -223,6 +235,8 @@ class DatabaseConfig(BaseModel):
         apps: Optional[List[str]] = None,
         operations: Optional[List[Literal["read", "write", "migrate"]]] = None,
         routing_description: str = "",
+        conn_max_age: int = 0,  # 0 disables persistent connections when using connection pooling
+        conn_health_checks: bool = True,
         **kwargs
     ) -> "DatabaseConfig":
         """
@@ -254,6 +268,8 @@ class DatabaseConfig(BaseModel):
             apps=apps or [],
             operations=operations or ["read", "write", "migrate"],
             routing_description=routing_description,
+            conn_max_age=conn_max_age,
+            conn_health_checks=conn_health_checks,
             **kwargs
         )
 

{django_cfg-1.5.24 → django_cfg-1.5.29}/src/django_cfg/models/infrastructure/database/converters.py

@@ -25,6 +25,8 @@ def to_django_config(config: "DatabaseConfig") -> Dict[str, Any]:  # type: ignor
         django_config = {
             "ENGINE": config.engine,
             "OPTIONS": {**config.options},
+            "CONN_MAX_AGE": config.conn_max_age,
+            "CONN_HEALTH_CHECKS": config.conn_health_checks,
         }
 
         # Add database-specific options

{django_cfg-1.5.24 → django_cfg-1.5.29}/src/django_cfg/modules/django_client/core/groups/manager.py

@@ -230,25 +230,32 @@ from django_cfg.apps.urls import urlpatterns
             for app_name in apps:
                 # Try to include app URLs
                 try:
-                    # Find app config by full name
-                    app_config = None
-                    for config in django_apps.get_app_configs():
-                        if config.name == app_name:
-                            app_config = config
-                            break
-
-                    if app_config:
-                        # Use actual label from AppConfig
-                        app_label = app_config.label
-                        # Add API prefix from config (e.g., "api/workspaces/" instead of just "workspaces/")
-                        api_prefix = getattr(self.config, 'api_prefix', '').strip('/')
-                        if api_prefix:
-                            url_path = f"{api_prefix}/{app_label}/"
-                        else:
-                            url_path = f"{app_label}/"
-                        urlpatterns.append(f'    path("{url_path}", include("{app_name}.urls")),')
+                    # Check if app has urls.py module
+                    import importlib
+                    urls_module = f"{app_name}.urls"
+                    try:
+                        importlib.import_module(urls_module)
+                        has_urls = True
+                    except ImportError:
+                        has_urls = False
+                    
+                    if not has_urls:
+                        logger.debug(f"App '{app_name}' has no urls.py - skipping")
+                        continue
+                    
+                    # Determine URL path based on whether app has urls.py
+                    # If app has urls.py, use basename (matches url_integration.py logic)
+                    # e.g., "apps.web.controls" -> "controls"
+                    app_basename = app_name.split('.')[-1]
+                    
+                    # Add API prefix from config (e.g., "api/controls/" instead of just "controls/")
+                    api_prefix = getattr(self.config, 'api_prefix', '').strip('/')
+                    if api_prefix:
+                        url_path = f"{api_prefix}/{app_basename}/"
                     else:
-                        logger.debug(f"App '{app_name}' not found in installed apps")
+                        url_path = f"{app_basename}/"
+                    
+                    urlpatterns.append(f'    path("{url_path}", include("{app_name}.urls")),')
                 except Exception as e:
                     logger.debug(f"App '{app_name}' skipped: {e}")
                     continue

{django_cfg-1.5.24 → django_cfg-1.5.29}/src/django_cfg/templates/admin/index.html

@@ -179,8 +179,6 @@
                     iframeId = 'nextjs-dashboard-iframe-builtin';
                 } else if (tab === 'nextjs') {
                     iframeId = 'nextjs-dashboard-iframe-nextjs';
-                } else if (tab === 'docs') {
-                    iframeId = 'nextjs-dashboard-iframe-docs';
                 }
 
                 const iframe = document.getElementById(iframeId);
@@ -200,8 +198,6 @@
                     iframeId = 'nextjs-dashboard-iframe-builtin';
                 } else if (this.activeTab === 'nextjs') {
                     iframeId = 'nextjs-dashboard-iframe-nextjs';
-                } else if (this.activeTab === 'docs') {
-                    iframeId = 'nextjs-dashboard-iframe-docs';
                 }
 
                 const iframe = document.getElementById(iframeId);
@@ -298,17 +294,6 @@
                             <span class="hidden sm:inline">{% nextjs_external_admin_title %}</span>
                             <span class="sm:hidden">Admin</span>
                         </button>
-
-                        {% if is_development %}
-                        <button @click="switchTab('docs')"
-                                class="whitespace-nowrap py-4 px-2 border-b-2 font-medium text-sm flex items-center gap-2 transition-all duration-200"
-                                :class="activeTab === 'docs'
-                                    ? 'border-primary-600 text-primary-600 dark:border-primary-500 dark:text-primary-500'
-                                    : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300 dark:text-gray-400 dark:hover:text-gray-300 dark:hover:border-gray-700'">
-                            <span class="material-icons text-base">description</span>
-                            <span>Docs</span>
-                        </button>
-                        {% endif %}
                             </nav>
 
                             <!-- Actions & Version -->
@@ -372,27 +357,6 @@
                     ></iframe>
                 </div>
             </div>
-
-            <!-- Docs Tab Content (Development Mode Only) -->
-            {% if is_development %}
-            <div x-show="activeTab === 'docs'" style="display: none;">
-                <div class="iframe-container">
-                    <div class="iframe-loading" id="iframe-loading-docs">
-                        <div class="spinner"></div>
-                        <p id="loading-text-docs">Loading documentation...</p>
-                    </div>
-
-                    <iframe
-                        id="nextjs-dashboard-iframe-docs"
-                        class="nextjs-dashboard-iframe"
-                        src="{% lib_docs_url %}"
-                        data-original-src="{% lib_docs_url %}"
-                        title="Documentation"
-                        sandbox="allow-same-origin allow-scripts allow-forms allow-popups allow-modals allow-storage-access-by-user-activation"
-                    ></iframe>
-                </div>
-            </div>
-            {% endif %}
         </div>
     {% endcomponent %}
 {% endblock %}
@@ -807,9 +771,6 @@
 
                 manager.register('nextjs-dashboard-iframe-builtin', 'iframe-loading-builtin');
                 manager.register('nextjs-dashboard-iframe-nextjs', 'iframe-loading-nextjs');
-                {% if is_development %}
-                manager.register('nextjs-dashboard-iframe-docs', 'iframe-loading-docs', { external: true });
-                {% endif %}
                 // console.log('[Django-CFG] Iframe registration completed');
             }