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

django_cfg/apps/integrations/grpc/{interceptors → services/interceptors}/request_logger.py

@@ -367,8 +367,8 @@ class RequestLoggerInterceptor(grpc.aio.ServerInterceptor):
     ):
         """Create initial log entry in database (async)."""
         try:
-            from ..models import GRPCRequestLog
-            from ..auth import get_current_grpc_user, get_current_grpc_api_key
+            from ...models import GRPCRequestLog
+            from ...auth import get_current_grpc_user, get_current_grpc_api_key
 
             # Get user and api_key from contextvars (set by ApiKeyAuthInterceptor)
             user = get_current_grpc_user()
@@ -380,9 +380,8 @@ class RequestLoggerInterceptor(grpc.aio.ServerInterceptor):
             # Extract client IP from peer
             client_ip = self._extract_ip_from_peer(peer)
 
-            # Create log entry (wrap Django ORM in asyncio.to_thread)
-            log_entry = await asyncio.to_thread(
-                GRPCRequestLog.objects.create,
+            # Create log entry (Django 5.2: Native async ORM)
+            log_entry = await GRPCRequestLog.objects.acreate(
                 request_id=request_id,
                 service_name=service_name,
                 method_name=method_name,
@@ -416,15 +415,14 @@ class RequestLoggerInterceptor(grpc.aio.ServerInterceptor):
             return
 
         try:
-            from ..models import GRPCRequestLog
+            from ...models import GRPCRequestLog
 
             # Prepare response data
             if response:
                 response_data = self._serialize_message(response)
 
-            # Wrap Django ORM in asyncio.to_thread
-            await asyncio.to_thread(
-                GRPCRequestLog.objects.mark_success,
+            # Django 5.2: Use async manager method
+            await GRPCRequestLog.objects.amark_success(
                 log_entry,
                 duration_ms=duration_ms,
                 response_data=response_data,
@@ -445,14 +443,13 @@ class RequestLoggerInterceptor(grpc.aio.ServerInterceptor):
             return
 
         try:
-            from ..models import GRPCRequestLog
+            from ...models import GRPCRequestLog
 
             # Get gRPC status code
             grpc_code = self._get_grpc_code(error, context)
 
-            # Wrap Django ORM in asyncio.to_thread
-            await asyncio.to_thread(
-                GRPCRequestLog.objects.mark_error,
+            # Django 5.2: Use async manager method
+            await GRPCRequestLog.objects.amark_error(
                 log_entry,
                 grpc_status_code=grpc_code,
                 error_message=str(error),

django_cfg/apps/integrations/grpc/services/management/__init__.py

@@ -0,0 +1,37 @@
+"""
+gRPC service management utilities.
+
+This package provides tools for managing protobuf files, configuration,
+and service lifecycle.
+
+**Components**:
+- proto_manager: Protobuf file management and compilation
+- config_helper: Configuration utilities for gRPC services
+
+**Usage Example**:
+```python
+from django_cfg.apps.integrations.grpc.services.management import (
+    ProtoFilesManager,
+    ConfigHelper,
+)
+
+# Manage proto files
+proto_mgr = ProtoFilesManager()
+proto_mgr.compile_all()
+
+# Configuration helpers
+config = ConfigHelper.get_grpc_config()
+```
+
+Created: 2025-11-07
+Status: %%PRODUCTION%%
+"""
+
+# Export when modules are refactored
+# from .proto_manager import ProtoFilesManager
+# from .config_helper import ConfigHelper
+
+__all__ = [
+    # 'ProtoFilesManager',
+    # 'ConfigHelper',
+]

django_cfg/apps/integrations/grpc/services/monitoring/__init__.py

@@ -0,0 +1,38 @@
+"""
+gRPC service monitoring and testing utilities.
+
+This package provides tools for monitoring gRPC service health,
+performance, and testing service functionality.
+
+**Components**:
+- monitoring: Service health monitoring and metrics
+- testing: Testing utilities for gRPC services
+
+**Usage Example**:
+```python
+from django_cfg.apps.integrations.grpc.services.monitoring import (
+    MonitoringService,
+    TestingService,
+)
+
+# Monitor service health
+monitor = MonitoringService()
+health = monitor.check_health()
+
+# Test service
+tester = TestingService()
+results = tester.run_tests()
+```
+
+Created: 2025-11-07
+Status: %%PRODUCTION%%
+"""
+
+# Export when modules are refactored
+# from .monitoring import MonitoringService
+# from .testing import TestingService
+
+__all__ = [
+    # 'MonitoringService',
+    # 'TestingService',
+]

django_cfg/apps/integrations/grpc/services/{monitoring_service.py → monitoring/monitoring.py}

@@ -12,8 +12,8 @@ from django.db.models import Avg, Count, Max
 from django.db.models.functions import TruncDay, TruncHour
 from django_cfg.modules.django_logging import get_logger
 
-from ..models import GRPCRequestLog, GRPCServerStatus
-from .config_helper import get_grpc_server_config
+from ...models import GRPCRequestLog, GRPCServerStatus
+from ..management.config_helper import get_grpc_server_config
 
 logger = get_logger("grpc.monitoring_service")
 

django_cfg/apps/integrations/grpc/services/{testing_service.py → monitoring/testing.py}

@@ -10,9 +10,9 @@ from django.db import models
 from django.db.models import Count
 from django_cfg.modules.django_logging import get_logger
 
-from ..models import GRPCRequestLog
-from ..testing import get_example
-from .service_registry import ServiceRegistryManager
+from ...models import GRPCRequestLog
+from ...testing import get_example
+from ..discovery.registry import ServiceRegistryManager
 
 logger = get_logger("grpc.testing_service")
 
@@ -197,8 +197,8 @@ class TestingService:
         import grpc
         from time import time
 
-        from .grpc_client import DynamicGRPCClient
-        from .config_helper import get_grpc_server_config
+        from ..client.client import DynamicGRPCClient
+        from ..management.config_helper import get_grpc_server_config
 
         # Get gRPC server config
         grpc_config = get_grpc_server_config()

django_cfg/apps/integrations/grpc/services/rendering/__init__.py

@@ -0,0 +1,27 @@
+"""
+gRPC content rendering services.
+
+This package provides tools for generating charts, graphs, and other
+visual content for gRPC responses.
+
+**Components**:
+- charts: Chart generation service
+
+**Usage Example**:
+```python
+from django_cfg.apps.integrations.grpc.services.rendering import ChartGenerator
+
+generator = ChartGenerator()
+chart_data = generator.generate_chart(data=timeseries, chart_type="line")
+```
+
+Created: 2025-11-07
+Status: %%PRODUCTION%%
+"""
+
+# Export when modules are refactored
+# from .charts import ChartGenerator
+
+__all__ = [
+    # 'ChartGenerator',
+]

django_cfg/apps/integrations/grpc/services/{chart_generator.py → rendering/charts.py}

@@ -13,7 +13,7 @@ from django.db.models import Avg, Count, Max, Min, Q
 from django.db.models.functions import TruncDay, TruncHour
 from django.utils import timezone
 
-from ..models import GRPCRequestLog, GRPCServerStatus
+from ...models import GRPCRequestLog, GRPCServerStatus
 
 
 class ChartGeneratorService:

django_cfg/apps/integrations/grpc/services/routing/__init__.py

@@ -0,0 +1,59 @@
+"""
+Cross-process command routing for Django multi-process architecture.
+
+This package provides automatic routing between direct calls (same process)
+and gRPC calls (cross-process) for scenarios where Django runs multiple processes
+(e.g., runserver + rungrpc).
+
+**Components**:
+- router: CrossProcessCommandRouter implementation
+- CrossProcessConfig: Pydantic configuration model
+
+**Usage Example**:
+```python
+from django_cfg.apps.integrations.grpc.services.routing import (
+    CrossProcessCommandRouter,
+    CrossProcessConfig,
+)
+
+# Configure router
+config = CrossProcessConfig(
+    grpc_host="localhost",
+    grpc_port=50051,
+    rpc_method_name="SendCommandToClient",
+)
+
+# Create router with factories
+router = CrossProcessCommandRouter(
+    config=config,
+    get_service_instance=lambda: get_global_service(),
+    stub_factory=create_grpc_stub,
+    request_factory=create_request,
+    extract_success=lambda r: r.success,
+)
+
+# Route commands (automatically chooses direct vs gRPC)
+await router.send_command("client_123", command_pb)
+```
+
+Created: 2025-11-07
+Status: %%PRODUCTION%%
+Phase: Phase 1 - Universal Components
+"""
+
+# Config can be imported directly (no grpc dependency)
+from .config import CrossProcessConfig
+
+# Lazy import for router (requires grpc)
+def __getattr__(name):
+    """Lazy import router to avoid grpc dependency."""
+    if name == 'CrossProcessCommandRouter':
+        from .router import CrossProcessCommandRouter
+        return CrossProcessCommandRouter
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+__all__ = [
+    'CrossProcessConfig',
+    'CrossProcessCommandRouter',
+]

django_cfg/apps/integrations/grpc/services/routing/config.py

@@ -0,0 +1,76 @@
+"""
+Configuration for cross-process command routing.
+
+This module provides Pydantic configuration models without gRPC dependencies.
+
+Created: 2025-11-07
+Status: %%PRODUCTION%%
+Phase: Phase 1 - Universal Components
+"""
+
+from pydantic import BaseModel, Field
+
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+class CrossProcessConfig(BaseModel):
+    """
+    Configuration for cross-process command routing.
+
+    **Parameters**:
+        grpc_host: gRPC server host (usually "localhost")
+        grpc_port: gRPC server port
+        rpc_method_name: Name of RPC method to call (e.g., "SendCommandToBot")
+        timeout: Timeout for gRPC calls in seconds
+        enable_logging: Enable detailed logging
+
+    **Example**:
+    ```python
+    config = CrossProcessConfig(
+        grpc_host="localhost",
+        grpc_port=50051,
+        rpc_method_name="SendCommandToClient",
+        timeout=5.0,
+    )
+    ```
+    """
+
+    grpc_host: str = Field(
+        default="localhost",
+        description="gRPC server host",
+    )
+
+    grpc_port: int = Field(
+        gt=0,
+        le=65535,
+        description="gRPC server port (1-65535)",
+    )
+
+    rpc_method_name: str = Field(
+        min_length=1,
+        description="Name of RPC method for cross-process calls",
+    )
+
+    timeout: float = Field(
+        default=5.0,
+        gt=0.0,
+        le=60.0,
+        description="Timeout for gRPC calls in seconds",
+    )
+
+    enable_logging: bool = Field(
+        default=True,
+        description="Enable detailed logging",
+    )
+
+    model_config = {
+        'extra': 'forbid',
+        'frozen': True,
+    }
+
+    @property
+    def grpc_address(self) -> str:
+        """Get full gRPC address (host:port)."""
+        return f"{self.grpc_host}:{self.grpc_port}"