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

django_cfg/apps/integrations/grpc/serializers/config.py

@@ -0,0 +1,120 @@
+"""
+DRF serializers for gRPC configuration and server info.
+
+These serializers define the structure for configuration and server
+information endpoints.
+"""
+
+from rest_framework import serializers
+
+
+class GRPCServerConfigSerializer(serializers.Serializer):
+    """gRPC server configuration details."""
+
+    host = serializers.CharField(help_text="Server host address")
+    port = serializers.IntegerField(help_text="Server port")
+    enabled = serializers.BooleanField(help_text="Whether gRPC server is enabled")
+    max_concurrent_streams = serializers.IntegerField(
+        allow_null=True, required=False, help_text="Maximum concurrent streams (async server)"
+    )
+    max_concurrent_rpcs = serializers.IntegerField(
+        allow_null=True, required=False, help_text="Maximum concurrent RPCs"
+    )
+
+
+class GRPCFrameworkConfigSerializer(serializers.Serializer):
+    """gRPC framework configuration details."""
+
+    enabled = serializers.BooleanField(help_text="Whether framework is enabled")
+    auto_discover = serializers.BooleanField(help_text="Auto-discover services")
+    services_path = serializers.CharField(help_text="Services discovery path pattern")
+    interceptors = serializers.ListField(
+        child=serializers.CharField(),
+        default=list,
+        help_text="Registered interceptors",
+    )
+
+
+class GRPCFeaturesSerializer(serializers.Serializer):
+    """gRPC features configuration."""
+
+    api_key_auth = serializers.BooleanField(help_text="API key authentication enabled")
+    request_logging = serializers.BooleanField(help_text="Request logging enabled")
+    metrics = serializers.BooleanField(help_text="Metrics collection enabled")
+    reflection = serializers.BooleanField(help_text="gRPC reflection enabled")
+
+
+class GRPCConfigSerializer(serializers.Serializer):
+    """Complete gRPC configuration response."""
+
+    server = GRPCServerConfigSerializer(help_text="Server configuration")
+    framework = GRPCFrameworkConfigSerializer(help_text="Framework configuration")
+    features = GRPCFeaturesSerializer(help_text="Feature flags")
+    registered_services = serializers.IntegerField(
+        help_text="Number of registered services"
+    )
+    total_methods = serializers.IntegerField(help_text="Total number of methods")
+
+
+class GRPCServiceInfoSerializer(serializers.Serializer):
+    """Information about a single gRPC service."""
+
+    name = serializers.CharField(help_text="Service name")
+    methods = serializers.ListField(
+        child=serializers.CharField(), default=list, help_text="Service methods"
+    )
+    full_name = serializers.CharField(help_text="Full service name with package")
+    description = serializers.CharField(
+        default="", allow_blank=True, help_text="Service description"
+    )
+
+
+class GRPCInterceptorInfoSerializer(serializers.Serializer):
+    """Information about an interceptor."""
+
+    name = serializers.CharField(help_text="Interceptor name")
+    enabled = serializers.BooleanField(help_text="Whether interceptor is enabled")
+
+
+class GRPCStatsSerializer(serializers.Serializer):
+    """Runtime statistics summary."""
+
+    total_requests = serializers.IntegerField(help_text="Total number of requests")
+    success_rate = serializers.FloatField(help_text="Success rate percentage")
+    avg_duration_ms = serializers.FloatField(
+        help_text="Average duration in milliseconds"
+    )
+
+
+class GRPCServerInfoSerializer(serializers.Serializer):
+    """Complete gRPC server information response."""
+
+    server_status = serializers.CharField(
+        help_text="Server status (running, stopped)"
+    )
+    address = serializers.CharField(help_text="Server address (host:port)")
+    started_at = serializers.CharField(
+        allow_null=True, required=False, help_text="Server start timestamp"
+    )
+    uptime_seconds = serializers.IntegerField(
+        allow_null=True, required=False, help_text="Server uptime in seconds"
+    )
+    services = GRPCServiceInfoSerializer(
+        many=True, default=list, help_text="Registered services"
+    )
+    interceptors = GRPCInterceptorInfoSerializer(
+        many=True, default=list, help_text="Active interceptors"
+    )
+    stats = GRPCStatsSerializer(help_text="Runtime statistics")
+
+
+__all__ = [
+    "GRPCConfigSerializer",
+    "GRPCServerInfoSerializer",
+    "GRPCServerConfigSerializer",
+    "GRPCFrameworkConfigSerializer",
+    "GRPCFeaturesSerializer",
+    "GRPCServiceInfoSerializer",
+    "GRPCInterceptorInfoSerializer",
+    "GRPCStatsSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/health.py

@@ -0,0 +1,18 @@
+"""
+Health check serializer for gRPC monitoring API.
+"""
+
+from rest_framework import serializers
+
+
+class GRPCHealthCheckSerializer(serializers.Serializer):
+    """gRPC health check response."""
+
+    status = serializers.CharField(help_text="Health status: healthy or unhealthy")
+    server_host = serializers.CharField(help_text="Configured gRPC server host")
+    server_port = serializers.IntegerField(help_text="Configured gRPC server port")
+    enabled = serializers.BooleanField(help_text="Whether gRPC is enabled")
+    timestamp = serializers.CharField(help_text="Current timestamp")
+
+
+__all__ = ["GRPCHealthCheckSerializer"]

django_cfg/apps/integrations/grpc/serializers/proto_files.py

@@ -0,0 +1,74 @@
+"""
+Serializers for gRPC proto files API.
+"""
+
+from rest_framework import serializers
+
+
+class ProtoFileDetailSerializer(serializers.Serializer):
+    """Proto file metadata."""
+
+    app_label = serializers.CharField()
+    filename = serializers.CharField()
+    size_bytes = serializers.IntegerField()
+    package = serializers.CharField(allow_blank=True)
+    messages_count = serializers.IntegerField()
+    services_count = serializers.IntegerField()
+    created_at = serializers.FloatField()
+    modified_at = serializers.FloatField()
+    download_url = serializers.CharField(
+        required=False,
+        help_text="API endpoint to download this proto file"
+    )
+
+
+class ProtoFileListSerializer(serializers.Serializer):
+    """List of proto files."""
+
+    files = ProtoFileDetailSerializer(many=True)
+    total_files = serializers.IntegerField()
+    proto_dir = serializers.CharField()
+    download_all_url = serializers.CharField(
+        required=False,
+        help_text="API endpoint to download all proto files as .zip archive"
+    )
+
+
+class ProtoGenerateRequestSerializer(serializers.Serializer):
+    """Request to generate proto files."""
+
+    apps = serializers.ListField(
+        child=serializers.CharField(),
+        required=False,
+        help_text="List of app labels to generate protos for (uses enabled_apps from config if not specified)",
+    )
+    force = serializers.BooleanField(
+        default=False,
+        required=False,
+        help_text="Force regeneration even if proto file exists",
+    )
+
+
+class ProtoGenerateErrorSerializer(serializers.Serializer):
+    """Proto generation error."""
+
+    app = serializers.CharField()
+    error = serializers.CharField()
+
+
+class ProtoGenerateResponseSerializer(serializers.Serializer):
+    """Response from proto generation."""
+
+    status = serializers.CharField()
+    generated = serializers.ListField(child=serializers.CharField())
+    generated_count = serializers.IntegerField()
+    errors = ProtoGenerateErrorSerializer(many=True)
+    proto_dir = serializers.CharField()
+
+
+__all__ = [
+    "ProtoFileDetailSerializer",
+    "ProtoFileListSerializer",
+    "ProtoGenerateRequestSerializer",
+    "ProtoGenerateResponseSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/requests.py

@@ -0,0 +1,24 @@
+"""
+Requests serializers for gRPC monitoring API.
+"""
+
+from rest_framework import serializers
+
+
+class RecentRequestsSerializer(serializers.Serializer):
+    """Recent gRPC requests list."""
+
+    requests = serializers.ListField(
+        child=serializers.DictField(), help_text="List of recent requests"
+    )
+    count = serializers.IntegerField(help_text="Number of requests returned")
+    total_available = serializers.IntegerField(help_text="Total requests available")
+    offset = serializers.IntegerField(
+        default=0, help_text="Current offset for pagination"
+    )
+    has_more = serializers.BooleanField(
+        default=False, help_text="Whether more results are available"
+    )
+
+
+__all__ = ["RecentRequestsSerializer"]

django_cfg/apps/integrations/grpc/serializers/service_registry.py

@@ -0,0 +1,260 @@
+"""
+DRF serializers for gRPC Service Registry API.
+
+These serializers define the structure for service registry endpoints
+that provide detailed information about registered gRPC services and their methods.
+"""
+
+from rest_framework import serializers
+
+
+class ServiceSummarySerializer(serializers.Serializer):
+    """Summary information for a single service."""
+
+    name = serializers.CharField(help_text="Service name (e.g., myapp.UserService)")
+    full_name = serializers.CharField(help_text="Full service name with package")
+    package = serializers.CharField(help_text="Package name")
+    methods_count = serializers.IntegerField(help_text="Number of methods in service")
+    total_requests = serializers.IntegerField(
+        default=0, help_text="Total requests to this service"
+    )
+    success_rate = serializers.FloatField(
+        default=0.0, help_text="Success rate percentage"
+    )
+    avg_duration_ms = serializers.FloatField(
+        default=0.0, help_text="Average duration in milliseconds"
+    )
+    last_activity_at = serializers.CharField(
+        allow_null=True, required=False, help_text="Last activity timestamp"
+    )
+
+
+class ServiceListSerializer(serializers.Serializer):
+    """List of services response."""
+
+    services = ServiceSummarySerializer(
+        many=True, default=list, help_text="List of services"
+    )
+    total_services = serializers.IntegerField(help_text="Total number of services")
+
+
+class MethodInfoSerializer(serializers.Serializer):
+    """Information about a service method."""
+
+    name = serializers.CharField(help_text="Method name")
+    full_name = serializers.CharField(help_text="Full method name (/service/method)")
+    request_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Request message type"
+    )
+    response_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Response message type"
+    )
+    streaming = serializers.BooleanField(
+        default=False, help_text="Whether method uses streaming"
+    )
+    auth_required = serializers.BooleanField(
+        default=False, help_text="Whether authentication is required"
+    )
+
+
+class ServiceStatsSerializer(serializers.Serializer):
+    """Service statistics."""
+
+    total_requests = serializers.IntegerField(default=0, help_text="Total requests")
+    successful = serializers.IntegerField(default=0, help_text="Successful requests")
+    errors = serializers.IntegerField(default=0, help_text="Failed requests")
+    success_rate = serializers.FloatField(
+        default=0.0, help_text="Success rate percentage"
+    )
+    avg_duration_ms = serializers.FloatField(
+        default=0.0, help_text="Average duration in milliseconds"
+    )
+    last_24h_requests = serializers.IntegerField(
+        default=0, help_text="Requests in last 24 hours"
+    )
+
+
+class RecentErrorSerializer(serializers.Serializer):
+    """Recent error information."""
+
+    method = serializers.CharField(help_text="Method name where error occurred")
+    error_message = serializers.CharField(help_text="Error message")
+    grpc_status_code = serializers.CharField(help_text="gRPC status code")
+    occurred_at = serializers.CharField(
+        help_text="When error occurred (ISO timestamp)"
+    )
+
+
+class ServiceDetailSerializer(serializers.Serializer):
+    """Detailed information about a service."""
+
+    name = serializers.CharField(help_text="Service name")
+    full_name = serializers.CharField(help_text="Full service name with package")
+    package = serializers.CharField(help_text="Package name")
+    description = serializers.CharField(
+        default="", allow_blank=True, help_text="Service description from docstring"
+    )
+    file_path = serializers.CharField(
+        default="", allow_blank=True, help_text="Path to service file"
+    )
+    class_name = serializers.CharField(help_text="Service class name")
+    base_class = serializers.CharField(
+        default="", allow_blank=True, help_text="Base class name"
+    )
+    methods = MethodInfoSerializer(many=True, default=list, help_text="Service methods")
+    stats = ServiceStatsSerializer(help_text="Service statistics")
+    recent_errors = RecentErrorSerializer(
+        many=True, default=list, help_text="Recent errors"
+    )
+
+
+class MethodStatsSerializer(serializers.Serializer):
+    """Statistics for a single method."""
+
+    total_requests = serializers.IntegerField(default=0, help_text="Total requests")
+    successful = serializers.IntegerField(default=0, help_text="Successful requests")
+    errors = serializers.IntegerField(default=0, help_text="Failed requests")
+    success_rate = serializers.FloatField(
+        default=0.0, help_text="Success rate percentage"
+    )
+    avg_duration_ms = serializers.FloatField(
+        default=0.0, help_text="Average duration in milliseconds"
+    )
+    p50_duration_ms = serializers.FloatField(
+        default=0.0, help_text="P50 duration in milliseconds"
+    )
+    p95_duration_ms = serializers.FloatField(
+        default=0.0, help_text="P95 duration in milliseconds"
+    )
+    p99_duration_ms = serializers.FloatField(
+        default=0.0, help_text="P99 duration in milliseconds"
+    )
+
+
+class MethodSummarySerializer(serializers.Serializer):
+    """Summary information for a method."""
+
+    name = serializers.CharField(help_text="Method name")
+    full_name = serializers.CharField(help_text="Full method path")
+    service_name = serializers.CharField(help_text="Service name")
+    request_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Request message type"
+    )
+    response_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Response message type"
+    )
+    stats = MethodStatsSerializer(help_text="Method statistics")
+
+
+class ServiceMethodsSerializer(serializers.Serializer):
+    """List of methods for a service."""
+
+    service_name = serializers.CharField(help_text="Service name")
+    methods = MethodSummarySerializer(many=True, default=list, help_text="List of methods")
+    total_methods = serializers.IntegerField(help_text="Total number of methods")
+
+
+class RequestSchemaField(serializers.Serializer):
+    """Schema field information."""
+
+    name = serializers.CharField(help_text="Field name")
+    type = serializers.CharField(help_text="Field type")
+    required = serializers.BooleanField(
+        default=False, help_text="Whether field is required"
+    )
+    description = serializers.CharField(
+        default="", allow_blank=True, help_text="Field description"
+    )
+
+
+class RequestSchemaSerializer(serializers.Serializer):
+    """Request message schema."""
+
+    fields = RequestSchemaField(many=True, default=list, help_text="Schema fields")
+
+
+class RecentRequestSerializer(serializers.Serializer):
+    """Recent request information."""
+
+    id = serializers.IntegerField(help_text="Database ID")
+    request_id = serializers.CharField(help_text="Request ID")
+    service_name = serializers.CharField(help_text="Service name")
+    method_name = serializers.CharField(help_text="Method name")
+    status = serializers.CharField(help_text="Request status")
+    duration_ms = serializers.IntegerField(default=0, help_text="Duration in milliseconds")
+    grpc_status_code = serializers.CharField(
+        default="", allow_blank=True, help_text="gRPC status code"
+    )
+    error_message = serializers.CharField(
+        default="", allow_blank=True, help_text="Error message if failed"
+    )
+    created_at = serializers.CharField(help_text="Request timestamp")
+    client_ip = serializers.CharField(
+        default="", allow_blank=True, help_text="Client IP address"
+    )
+    # User information
+    user_id = serializers.IntegerField(
+        allow_null=True, required=False, help_text="User ID (if authenticated)"
+    )
+    username = serializers.CharField(
+        default="", allow_blank=True, allow_null=True, help_text="Username (if authenticated)"
+    )
+    is_authenticated = serializers.BooleanField(
+        default=False, help_text="Whether request was authenticated"
+    )
+    # API Key information
+    api_key_id = serializers.IntegerField(
+        allow_null=True, required=False, help_text="API Key ID (if used)"
+    )
+    api_key_name = serializers.CharField(
+        default="", allow_blank=True, allow_null=True, help_text="API Key name (if used)"
+    )
+
+
+class MethodDetailSerializer(serializers.Serializer):
+    """Detailed information about a method."""
+
+    name = serializers.CharField(help_text="Method name")
+    full_name = serializers.CharField(help_text="Full method path")
+    service_name = serializers.CharField(help_text="Service name")
+    request_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Request message type"
+    )
+    response_type = serializers.CharField(
+        default="", allow_blank=True, help_text="Response message type"
+    )
+    streaming = serializers.BooleanField(
+        default=False, help_text="Whether method uses streaming"
+    )
+    auth_required = serializers.BooleanField(
+        default=False, help_text="Whether authentication is required"
+    )
+    description = serializers.CharField(
+        default="", allow_blank=True, help_text="Method description"
+    )
+    request_schema = RequestSchemaSerializer(help_text="Request message schema")
+    response_schema = RequestSchemaSerializer(help_text="Response message schema")
+    stats = MethodStatsSerializer(help_text="Method statistics")
+    recent_requests = RecentRequestSerializer(
+        many=True, default=list, help_text="Recent requests"
+    )
+    error_distribution = serializers.DictField(
+        default=dict, help_text="Error distribution by status code"
+    )
+
+
+__all__ = [
+    "ServiceSummarySerializer",
+    "ServiceListSerializer",
+    "ServiceDetailSerializer",
+    "ServiceStatsSerializer",
+    "MethodInfoSerializer",
+    "MethodSummarySerializer",
+    "ServiceMethodsSerializer",
+    "MethodStatsSerializer",
+    "MethodDetailSerializer",
+    "RecentErrorSerializer",
+    "RecentRequestSerializer",
+    "RequestSchemaSerializer",
+    "RequestSchemaField",
+]

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

@@ -0,0 +1,32 @@
+"""
+Services serializers for gRPC monitoring API.
+"""
+
+from rest_framework import serializers
+
+
+class MethodStatsSerializer(serializers.Serializer):
+    """Statistics for a single gRPC method."""
+
+    method_name = serializers.CharField(help_text="Method name")
+    service_name = serializers.CharField(help_text="Service name")
+    total = serializers.IntegerField(help_text="Total requests")
+    successful = serializers.IntegerField(help_text="Successful requests")
+    errors = serializers.IntegerField(help_text="Error requests")
+    avg_duration_ms = serializers.FloatField(help_text="Average duration")
+    last_activity_at = serializers.CharField(
+        allow_null=True, help_text="Last activity timestamp"
+    )
+
+
+class MethodListSerializer(serializers.Serializer):
+    """List of gRPC methods with statistics."""
+
+    methods = MethodStatsSerializer(many=True, help_text="Method statistics")
+    total_methods = serializers.IntegerField(help_text="Total number of methods")
+
+
+__all__ = [
+    "MethodStatsSerializer",
+    "MethodListSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/stats.py

@@ -0,0 +1,60 @@
+"""
+Statistics serializers for gRPC monitoring API.
+"""
+
+from rest_framework import serializers
+
+
+class GRPCRegisteredServiceSerializer(serializers.Serializer):
+    """Information about a registered gRPC service."""
+
+    name = serializers.CharField(help_text="Service name")
+    full_name = serializers.CharField(help_text="Full service name with package")
+    methods_count = serializers.IntegerField(help_text="Number of methods in service")
+    request_count = serializers.IntegerField(help_text="Total requests to this service in period")
+    error_count = serializers.IntegerField(help_text="Error requests to this service in period")
+    success_rate = serializers.FloatField(help_text="Success rate percentage for this service")
+
+
+class GRPCServerStatusSerializer(serializers.Serializer):
+    """gRPC server status and information for overview stats."""
+
+    status = serializers.CharField(help_text="Server status (running, stopped, error, etc.)")
+    is_running = serializers.BooleanField(help_text="Whether server is currently running")
+    host = serializers.CharField(help_text="Server host address")
+    port = serializers.IntegerField(help_text="Server port")
+    address = serializers.CharField(help_text="Full server address (host:port)")
+    pid = serializers.IntegerField(allow_null=True, help_text="Process ID")
+    started_at = serializers.DateTimeField(allow_null=True, help_text="Server start time")
+    uptime_seconds = serializers.IntegerField(help_text="Server uptime in seconds")
+    uptime_display = serializers.CharField(help_text="Human-readable uptime")
+    registered_services_count = serializers.IntegerField(help_text="Number of registered services")
+    enable_reflection = serializers.BooleanField(help_text="Whether reflection is enabled")
+    enable_health_check = serializers.BooleanField(help_text="Whether health check is enabled")
+    last_heartbeat = serializers.DateTimeField(allow_null=True, help_text="Last heartbeat timestamp")
+    services = GRPCRegisteredServiceSerializer(many=True, help_text="List of registered services with stats")
+    services_healthy = serializers.BooleanField(help_text="Whether all services are healthy (no recent errors)")
+
+
+class GRPCOverviewStatsSerializer(serializers.Serializer):
+    """Overview statistics for gRPC requests."""
+
+    total = serializers.IntegerField(help_text="Total requests in period")
+    successful = serializers.IntegerField(help_text="Successful requests")
+    errors = serializers.IntegerField(help_text="Error requests")
+    cancelled = serializers.IntegerField(help_text="Cancelled requests")
+    timeout = serializers.IntegerField(help_text="Timeout requests")
+    success_rate = serializers.FloatField(help_text="Success rate percentage")
+    avg_duration_ms = serializers.FloatField(help_text="Average duration in milliseconds")
+    p95_duration_ms = serializers.FloatField(
+        allow_null=True, help_text="95th percentile duration in milliseconds"
+    )
+    period_hours = serializers.IntegerField(help_text="Statistics period in hours")
+    server = GRPCServerStatusSerializer(help_text="gRPC server information")
+
+
+__all__ = [
+    "GRPCOverviewStatsSerializer",
+    "GRPCServerStatusSerializer",
+    "GRPCRegisteredServiceSerializer",
+]