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

django_cfg/middleware/pagination.py

@@ -190,62 +190,62 @@ class NoPagination(PageNumberPagination):
         return Response(data)
 
 
-class CursorPaginationEnhanced(PageNumberPagination):
-    """
-    Enhanced cursor-based pagination for large datasets.
+# class CursorPaginationEnhanced(PageNumberPagination):
+#     """
+#     Enhanced cursor-based pagination for large datasets.
     
-    Better performance for large datasets but doesn't support jumping to arbitrary pages.
-    """
-    page_size = 100
-    page_size_query_param = 'page_size'
-    max_page_size = 1000
-    cursor_query_param = 'cursor'
-    ordering = '-created_at'  # Default ordering, should be overridden
+#     Better performance for large datasets but doesn't support jumping to arbitrary pages.
+#     """
+#     page_size = 100
+#     page_size_query_param = 'page_size'
+#     max_page_size = 1000
+#     cursor_query_param = 'cursor'
+#     ordering = '-created_at'  # Default ordering, should be overridden
 
-    def get_paginated_response(self, data):
-        """
-        Return cursor-paginated response with enhanced format.
-        """
-        return Response({
-            'next': self.get_next_link(),
-            'previous': self.get_previous_link(),
-            'page_size': self.page_size,
-            'results': data,
-        })
+#     def get_paginated_response(self, data):
+#         """
+#         Return cursor-paginated response with enhanced format.
+#         """
+#         return Response({
+#             'next': self.get_next_link(),
+#             'previous': self.get_previous_link(),
+#             'page_size': self.page_size,
+#             'results': data,
+#         })
 
-    def get_paginated_response_schema(self, schema):
-        """
-        Return the OpenAPI schema for cursor-paginated responses.
-        """
-        return {
-            'type': 'object',
-            'required': ['results'],
-            'properties': {
-                'next': {
-                    'type': 'string',
-                    'nullable': True,
-                    'format': 'uri',
-                    'description': 'URL to next page of results',
-                    'example': 'http://api.example.org/accounts/?cursor=cD0yMDIzLTEyLTE1KzAyJTNBMDA%3D'
-                },
-                'previous': {
-                    'type': 'string',
-                    'nullable': True,
-                    'format': 'uri',
-                    'description': 'URL to previous page of results',
-                    'example': 'http://api.example.org/accounts/?cursor=bD0yMDIzLTEyLTEzKzAyJTNBMDA%3D'
-                },
-                'page_size': {
-                    'type': 'integer',
-                    'description': 'Number of items per page',
-                    'example': 100
-                },
-                'results': {
-                    **schema,
-                    'description': 'Array of items for current page'
-                },
-            },
-        }
+#     def get_paginated_response_schema(self, schema):
+#         """
+#         Return the OpenAPI schema for cursor-paginated responses.
+#         """
+#         return {
+#             'type': 'object',
+#             'required': ['results'],
+#             'properties': {
+#                 'next': {
+#                     'type': 'string',
+#                     'nullable': True,
+#                     'format': 'uri',
+#                     'description': 'URL to next page of results',
+#                     'example': 'http://api.example.org/accounts/?cursor=cD0yMDIzLTEyLTE1KzAyJTNBMDA%3D'
+#                 },
+#                 'previous': {
+#                     'type': 'string',
+#                     'nullable': True,
+#                     'format': 'uri',
+#                     'description': 'URL to previous page of results',
+#                     'example': 'http://api.example.org/accounts/?cursor=bD0yMDIzLTEyLTEzKzAyJTNBMDA%3D'
+#                 },
+#                 'page_size': {
+#                     'type': 'integer',
+#                     'description': 'Number of items per page',
+#                     'example': 100
+#                 },
+#                 'results': {
+#                     **schema,
+#                     'description': 'Array of items for current page'
+#                 },
+#             },
+#         }
 
 
 # Export all pagination classes
@@ -254,5 +254,4 @@ __all__ = [
     'LargePagination',
     'SmallPagination',
     'NoPagination',
-    'CursorPaginationEnhanced',
 ]

django_cfg/mixins/__init__.py

@@ -5,8 +5,10 @@ Shared mixins for DRF views and viewsets.
 """
 from .admin_api import AdminAPIMixin
 from .client_api import ClientAPIMixin
+from .superadmin_api import SuperAdminAPIMixin
 
 __all__ = [
     "AdminAPIMixin",
     "ClientAPIMixin",
+    "SuperAdminAPIMixin",
 ]

django_cfg/mixins/superadmin_api.py

@@ -0,0 +1,59 @@
+"""
+SuperAdmin API Mixin.
+
+Common configuration for superuser-only API endpoints.
+More restrictive than AdminAPIMixin - requires is_superuser flag.
+"""
+from rest_framework.authentication import BasicAuthentication, SessionAuthentication
+from rest_framework.permissions import BasePermission
+from rest_framework_simplejwt.authentication import JWTAuthentication
+
+
+class IsSuperUser(BasePermission):
+    """
+    Permission that allows access only to superusers.
+
+    More restrictive than IsAdminUser - requires is_superuser flag.
+    Use for sensitive operations like command execution.
+    """
+
+    def has_permission(self, request, view):
+        """Check if user is authenticated and is a superuser."""
+        return bool(
+            request.user and
+            request.user.is_authenticated and
+            request.user.is_superuser
+        )
+
+
+class SuperAdminAPIMixin:
+    """
+    Mixin for superuser-only API endpoints.
+
+    Provides:
+    - JWT, Session, and Basic authentication
+    - IsSuperUser permission requirement (is_superuser=True)
+
+    Usage:
+        class MyViewSet(SuperAdminAPIMixin, viewsets.ModelViewSet):
+            queryset = MyModel.objects.all()
+            serializer_class = MySerializer
+
+    Authentication Methods:
+        1. JWT Token (Bearer): For frontend SPA authentication
+        2. Session: For Django admin integration
+        3. Basic Auth: For testing and scripts
+
+    All endpoints require superuser privileges.
+    Only use this for sensitive operations like:
+    - Command execution
+    - System configuration changes
+    - Direct database operations
+    """
+
+    authentication_classes = [
+        JWTAuthentication,      # JWT tokens (Bearer)
+        SessionAuthentication,  # Django session (for admin)
+        BasicAuthentication,    # HTTP Basic (for testing)
+    ]
+    permission_classes = [IsSuperUser]

django_cfg/models/__init__.py

@@ -35,7 +35,7 @@ from .base.module import BaseCfgAutoModule
 from .django.axes import AxesConfig
 from .django.constance import ConstanceConfig, ConstanceField
 from .django.crypto_fields import CryptoFieldsConfig
-from .django.django_q2 import DjangoQ2Config, DjangoQ2ScheduleConfig
+from .django.django_rq import DjangoRQConfig, RQQueueConfig
 from .django.environment import EnvironmentConfig
 from .django.openapi import OpenAPIClientConfig
 from .infrastructure.cache import CacheConfig
@@ -80,8 +80,8 @@ __all__ = [
     "EnvironmentConfig",
     "ConstanceConfig",
     "ConstanceField",
-    "DjangoQ2Config",
-    "DjangoQ2ScheduleConfig",
+    "DjangoRQConfig",
+    "RQQueueConfig",
     "OpenAPIClientConfig",
     "UnfoldConfig",
     "AxesConfig",

django_cfg/models/api/grpc/__init__.py

@@ -0,0 +1,53 @@
+"""
+gRPC configuration models.
+
+Type-safe Pydantic v2 models for gRPC integration.
+
+Requires: pip install django-cfg[grpc]
+
+Example:
+    Flat API (recommended - no nested config imports needed):
+    >>> from django_cfg import GRPCConfig
+    >>> config = GRPCConfig(
+    ...     enabled=True,
+    ...     enabled_apps=["crypto"],
+    ...     port=50051,
+    ...     package_prefix="api",
+    ... )
+
+    Advanced with nested configs (optional):
+    >>> from django_cfg.models.api.grpc.config import GRPCServerConfig
+    >>> config = GRPCConfig(
+    ...     enabled=True,
+    ...     server=GRPCServerConfig(max_workers=50, compression="gzip")
+    ... )
+"""
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .config import GRPCConfig
+
+__all__ = [
+    "GRPCConfig",
+]
+
+
+def __getattr__(name: str):
+    """Lazy import with helpful error message."""
+    if name in __all__:
+        try:
+            from .config import GRPCConfig
+
+            return {
+                "GRPCConfig": GRPCConfig,
+            }[name]
+
+        except ImportError as e:
+            raise ImportError(
+                f"gRPC support requires additional dependencies. "
+                f"Install with: pip install django-cfg[grpc]\n"
+                f"Missing module: {e.name}"
+            ) from e
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")