django-cfg 1.4.61__py3-none-any.whl → 1.4.63__py3-none-any.whl

django_cfg/apps/centrifugo/templatetags/centrifugo_tags.py

@@ -0,0 +1,81 @@
+"""
+Centrifugo Template Tags.
+
+Provides template tags for accessing Centrifugo configuration in templates.
+"""
+
+from django import template
+from ..services import get_centrifugo_config
+
+register = template.Library()
+
+
+@register.simple_tag
+def centrifugo_admin_url():
+    """
+    Get Centrifugo admin UI URL from configuration.
+
+    Returns the HTTP admin URL from centrifugo_api_url.
+    Example: http://localhost:8002
+
+    Usage in template:
+        {% load centrifugo_tags %}
+        {% centrifugo_admin_url %}
+    """
+    config = get_centrifugo_config()
+    if not config or not config.centrifugo_api_url:
+        return ""
+
+    # Return HTTP API URL (admin UI is on same host)
+    url = config.centrifugo_api_url
+
+    # Remove /api suffix if present
+    if url.endswith('/api'):
+        url = url[:-len('/api')]
+
+    # Remove trailing slash
+    url = url.rstrip('/')
+
+    return url
+
+
+@register.simple_tag
+def centrifugo_is_configured():
+    """
+    Check if Centrifugo is configured.
+    
+    Returns True if Centrifugo config exists and has URL.
+    
+    Usage in template:
+        {% load centrifugo_tags %}
+        {% centrifugo_is_configured as is_configured %}
+        {% if is_configured %}...{% endif %}
+    """
+    config = get_centrifugo_config()
+    return bool(config and config.centrifugo_url)
+
+
+@register.simple_tag
+def centrifugo_wrapper_url():
+    """
+    Get Centrifugo wrapper URL from configuration.
+    
+    Returns the wrapper URL (our Django proxy).
+    Example: http://localhost:8080
+    
+    Usage in template:
+        {% load centrifugo_tags %}
+        {% centrifugo_wrapper_url %}
+    """
+    config = get_centrifugo_config()
+    if not config or not config.wrapper_url:
+        return ""
+    
+    return config.wrapper_url.rstrip('/')
+
+
+__all__ = [
+    "centrifugo_admin_url",
+    "centrifugo_is_configured",
+    "centrifugo_wrapper_url",
+]

django_cfg/apps/centrifugo/urls.py

@@ -0,0 +1,31 @@
+"""
+URL patterns for Centrifugo module.
+
+Public API endpoints for Centrifugo monitoring and admin API proxy.
+"""
+
+from django.urls import include, path
+from rest_framework import routers
+
+from .views.admin_api import CentrifugoAdminAPIViewSet
+from .views.monitoring import CentrifugoMonitorViewSet
+from .views.testing_api import CentrifugoTestingAPIViewSet
+
+app_name = 'django_cfg_centrifugo'
+
+# Create router
+router = routers.DefaultRouter()
+
+# Monitoring endpoints (Django logs based)
+router.register(r'monitor', CentrifugoMonitorViewSet, basename='monitor')
+
+# Admin API proxy endpoints (Centrifugo server based)
+router.register(r'server', CentrifugoAdminAPIViewSet, basename='server')
+
+# Testing API endpoints (live testing from dashboard)
+router.register(r'testing', CentrifugoTestingAPIViewSet, basename='testing')
+
+urlpatterns = [
+    # Include router URLs
+    path('', include(router.urls)),
+]

django_cfg/apps/{ipc → centrifugo}/urls_admin.py

@@ -1,14 +1,14 @@
 """
-Admin URLs for IPC/RPC dashboard.
+Admin URLs for Centrifugo dashboard.
 
-Dashboard interface for monitoring RPC activity.
+Dashboard interface for monitoring Centrifugo publish activity.
 """
 
 from django.urls import include, path
 
 from .views import dashboard_view
 
-app_name = 'django_cfg_ipc_admin'
+app_name = 'django_cfg_centrifugo_admin'
 
 
 urlpatterns = [
@@ -16,5 +16,5 @@ urlpatterns = [
     path('', dashboard_view, name='dashboard'),
 
     # Include API endpoints for dashboard AJAX calls
-    path('api/', include('django_cfg.apps.ipc.urls')),
+    path('api/', include('django_cfg.apps.centrifugo.urls')),
 ]

django_cfg/apps/centrifugo/views/__init__.py

@@ -0,0 +1,15 @@
+"""
+Views for Centrifugo module.
+"""
+
+from .admin_api import CentrifugoAdminAPIViewSet
+from .dashboard import dashboard_view
+from .monitoring import CentrifugoMonitorViewSet
+from .testing_api import CentrifugoTestingAPIViewSet
+
+__all__ = [
+    'CentrifugoMonitorViewSet',
+    'CentrifugoAdminAPIViewSet',
+    'CentrifugoTestingAPIViewSet',
+    'dashboard_view',
+]

django_cfg/apps/centrifugo/views/admin_api.py

@@ -0,0 +1,374 @@
+"""
+Centrifugo Admin API Proxy.
+
+Proxies requests to Centrifugo server API with authentication and type safety.
+Provides Django endpoints that map to Centrifugo HTTP API methods.
+"""
+
+import asyncio
+import httpx
+from django.http import JsonResponse
+from django_cfg.modules.django_logging import get_logger
+from drf_spectacular.utils import OpenApiParameter, extend_schema
+from rest_framework import status, viewsets
+from rest_framework.authentication import SessionAuthentication
+from rest_framework.decorators import action
+from rest_framework.permissions import IsAdminUser
+from rest_framework.response import Response
+
+from ..serializers import (
+    CentrifugoInfoRequest,
+    CentrifugoInfoResponse,
+    CentrifugoChannelsRequest,
+    CentrifugoChannelsResponse,
+    CentrifugoPresenceRequest,
+    CentrifugoPresenceResponse,
+    CentrifugoPresenceStatsRequest,
+    CentrifugoPresenceStatsResponse,
+    CentrifugoHistoryRequest,
+    CentrifugoHistoryResponse,
+)
+from ..services import get_centrifugo_config
+
+logger = get_logger("centrifugo.admin_api")
+
+
+class CentrifugoAdminAPIViewSet(viewsets.ViewSet):
+    """
+    Centrifugo Admin API Proxy ViewSet.
+
+    Provides type-safe proxy endpoints to Centrifugo server API.
+    All requests are authenticated via Django session and proxied to Centrifugo.
+    """
+
+    authentication_classes = [SessionAuthentication]
+    permission_classes = [IsAdminUser]
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._http_client = None
+
+    @property
+    def http_client(self) -> httpx.AsyncClient:
+        """Get or create HTTP client for Centrifugo API calls."""
+        if self._http_client is None:
+            config = get_centrifugo_config()
+            if not config:
+                raise ValueError("Centrifugo not configured")
+
+            headers = {"Content-Type": "application/json"}
+            if config.centrifugo_api_key:
+                headers["X-API-Key"] = config.centrifugo_api_key
+
+            # Use base URL without /api suffix since we'll add it in requests
+            base_url = config.centrifugo_api_url.rstrip('/api').rstrip('/')
+
+            self._http_client = httpx.AsyncClient(
+                base_url=base_url,
+                headers=headers,
+                timeout=httpx.Timeout(10.0),
+            )
+
+        return self._http_client
+
+    async def _call_centrifugo_api(self, method: str, params: dict = None) -> dict:
+        """
+        Call Centrifugo API method.
+
+        Args:
+            method: API method name (e.g., "info", "channels", "presence")
+            params: Method parameters (optional)
+
+        Returns:
+            API response data or error dict
+
+        Raises:
+            httpx.HTTPError: If API call fails
+        """
+        payload = {"method": method, "params": params or {}}
+
+        try:
+            response = await self.http_client.post("/api", json=payload)
+            response.raise_for_status()
+            result = response.json()
+
+            # Return both error and result - let caller decide
+            return result
+
+        except httpx.HTTPError as e:
+            logger.error(f"Centrifugo API HTTP error: {e}", exc_info=True)
+            raise
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="Get Centrifugo server info",
+        description="Returns server information including node count, version, and uptime.",
+        request=CentrifugoInfoRequest,
+        responses={
+            200: CentrifugoInfoResponse,
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="info")
+    def info(self, request):
+        """Get Centrifugo server information."""
+        try:
+            result = asyncio.run(self._call_centrifugo_api("info", params={}))
+
+            # Check for Centrifugo API error
+            if "error" in result and result["error"]:
+                return Response(
+                    {"error": result["error"], "result": None},
+                    status=status.HTTP_200_OK  # Not a server error, just API error
+                )
+
+            # Success response
+            response = CentrifugoInfoResponse(error=None, result=result.get("result", {}))
+            return Response(response.model_dump())
+
+        except Exception as e:
+            logger.error(f"Failed to get server info: {e}", exc_info=True)
+            return Response(
+                {"error": {"code": 102, "message": str(e)}},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="List active channels",
+        description="Returns list of active channels with optional pattern filter.",
+        request=CentrifugoChannelsRequest,
+        responses={
+            200: CentrifugoChannelsResponse,
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="channels")
+    def channels(self, request):
+        """List active channels."""
+        try:
+            req_data = CentrifugoChannelsRequest(**request.data)
+            result = asyncio.run(self._call_centrifugo_api(
+                "channels", params=req_data.model_dump(exclude_none=True)
+            ))
+
+            # Check for Centrifugo API error
+            if "error" in result and result["error"]:
+                return Response(
+                    {"error": result["error"], "result": None},
+                    status=status.HTTP_200_OK
+                )
+
+            response = CentrifugoChannelsResponse(error=None, result=result.get("result", {}))
+            return Response(response.model_dump())
+
+        except Exception as e:
+            logger.error(f"Failed to list channels: {e}", exc_info=True)
+            return Response(
+                {"error": {"code": 102, "message": str(e)}},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="Get channel presence",
+        description="Returns list of clients currently subscribed to a channel.",
+        request=CentrifugoPresenceRequest,
+        responses={
+            200: CentrifugoPresenceResponse,
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="presence")
+    def presence(self, request):
+        """Get channel presence (active subscribers)."""
+        try:
+            req_data = CentrifugoPresenceRequest(**request.data)
+            result = asyncio.run(self._call_centrifugo_api(
+                "presence", params=req_data.model_dump()
+            ))
+
+            # Check for Centrifugo API error (e.g., code 108 "not available")
+            if "error" in result and result["error"]:
+                return Response(
+                    {"error": result["error"], "result": None},
+                    status=status.HTTP_200_OK
+                )
+
+            response = CentrifugoPresenceResponse(error=None, result=result.get("result", {}))
+            return Response(response.model_dump())
+
+        except Exception as e:
+            logger.error(f"Failed to get presence: {e}", exc_info=True)
+            return Response(
+                {"error": {"code": 102, "message": str(e)}},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="Get channel presence statistics",
+        description="Returns quick statistics about channel presence (num_clients, num_users).",
+        request=CentrifugoPresenceStatsRequest,
+        responses={
+            200: CentrifugoPresenceStatsResponse,
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="presence-stats")
+    def presence_stats(self, request):
+        """Get channel presence statistics."""
+        try:
+            req_data = CentrifugoPresenceStatsRequest(**request.data)
+            result = asyncio.run(self._call_centrifugo_api(
+                "presence_stats", params=req_data.model_dump()
+            ))
+
+            # Check for Centrifugo API error (e.g., code 108 "not available")
+            if "error" in result and result["error"]:
+                return Response(
+                    {"error": result["error"], "result": None},
+                    status=status.HTTP_200_OK
+                )
+
+            response = CentrifugoPresenceStatsResponse(error=None, result=result.get("result", {}))
+            return Response(response.model_dump())
+
+        except Exception as e:
+            logger.error(f"Failed to get presence stats: {e}", exc_info=True)
+            return Response(
+                {"error": {"code": 102, "message": str(e)}},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="Get channel history",
+        description="Returns message history for a channel.",
+        request=CentrifugoHistoryRequest,
+        responses={
+            200: CentrifugoHistoryResponse,
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="history")
+    def history(self, request):
+        """Get channel message history."""
+        try:
+            req_data = CentrifugoHistoryRequest(**request.data)
+            result = asyncio.run(self._call_centrifugo_api(
+                "history", params=req_data.model_dump(exclude_none=True)
+            ))
+
+            # Check for Centrifugo API error (e.g., code 108 "not available")
+            if "error" in result and result["error"]:
+                return Response(
+                    {"error": result["error"], "result": None},
+                    status=status.HTTP_200_OK
+                )
+
+            response = CentrifugoHistoryResponse(error=None, result=result.get("result", {}))
+            return Response(response.model_dump())
+
+        except Exception as e:
+            logger.error(f"Failed to get history: {e}", exc_info=True)
+            return Response(
+                {"error": {"code": 102, "message": str(e)}},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    @extend_schema(
+        tags=["Centrifugo Admin API"],
+        summary="Get connection token for dashboard",
+        description="Returns JWT token and config for WebSocket connection to Centrifugo.",
+        request=None,
+        responses={
+            200: {
+                "type": "object",
+                "properties": {
+                    "token": {"type": "string"},
+                    "config": {
+                        "type": "object",
+                        "properties": {
+                            "centrifugo_url": {"type": "string"},
+                            "expires_at": {"type": "string"},
+                        }
+                    }
+                }
+            },
+            400: {"description": "Centrifugo not configured"},
+            500: {"description": "Server error"},
+        },
+    )
+    @action(detail=False, methods=["post"], url_path="auth/token")
+    def auth_token(self, request):
+        """
+        Generate JWT token for dashboard WebSocket connection.
+
+        Returns token that authenticates the current user to subscribe
+        to the dashboard channel for real-time updates.
+        """
+        try:
+            import jwt
+            import time
+            from datetime import datetime, timezone
+
+            config = get_centrifugo_config()
+            if not config:
+                return Response(
+                    {"error": "Centrifugo is not configured"},
+                    status=status.HTTP_400_BAD_REQUEST
+                )
+
+            # Generate JWT token for current user
+            now = int(time.time())
+            exp = now + 3600  # 1 hour
+
+            payload = {
+                "sub": str(request.user.id),  # User ID
+                "exp": exp,  # Expiration
+                "iat": now,  # Issued at
+            }
+
+            # Subscribe to dashboard channel
+            payload["channels"] = ["centrifugo#dashboard"]
+
+            # Use HMAC secret from config or Django SECRET_KEY
+            secret = config.centrifugo_token_hmac_secret or ""
+            if not secret:
+                from django.conf import settings
+                secret = settings.SECRET_KEY
+
+            token = jwt.encode(payload, secret, algorithm="HS256")
+
+            return Response({
+                "token": token,
+                "config": {
+                    "centrifugo_url": config.centrifugo_url,
+                    "expires_at": datetime.fromtimestamp(exp, tz=timezone.utc).isoformat(),
+                }
+            })
+
+        except Exception as e:
+            logger.error(f"Failed to generate auth token: {e}", exc_info=True)
+            return Response(
+                {"error": str(e)},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR
+            )
+
+    def __del__(self):
+        """Cleanup HTTP client on deletion."""
+        if self._http_client:
+            import asyncio
+
+            try:
+                loop = asyncio.get_event_loop()
+                if loop.is_running():
+                    loop.create_task(self._http_client.aclose())
+                else:
+                    loop.run_until_complete(self._http_client.aclose())
+            except Exception:
+                pass  # Ignore cleanup errors
+
+
+__all__ = ["CentrifugoAdminAPIViewSet"]

django_cfg/apps/centrifugo/views/dashboard.py

@@ -0,0 +1,15 @@
+"""
+Dashboard view for Centrifugo monitoring.
+"""
+
+from django.contrib.admin.views.decorators import staff_member_required
+from django.shortcuts import render
+
+
+@staff_member_required
+def dashboard_view(request):
+    """Render the Centrifugo dashboard template."""
+    context = {
+        'page_title': 'Centrifugo Monitor Dashboard',
+    }
+    return render(request, 'django_cfg_centrifugo/pages/dashboard.html', context)