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

django_cfg/apps/centrifugo/apps.py

@@ -1,31 +0,0 @@
-"""
-Django app configuration for Centrifugo module.
-
-Provides Centrifugo pub/sub client with ACK tracking.
-"""
-
-from django.apps import AppConfig
-
-
-class CentrifugoConfig(AppConfig):
-    """
-    Centrifugo application configuration.
-
-    Provides:
-    - Async client for publishing messages to Centrifugo
-    - ACK tracking for delivery confirmation
-    - Logging of all publish operations
-    - Migration-friendly API (mirrors legacy WebSocket solution patterns)
-    """
-
-    default_auto_field = "django.db.models.BigAutoField"
-    name = "django_cfg.apps.centrifugo"
-    label = "django_cfg_centrifugo"
-    verbose_name = "Centrifugo WebSocket"
-
-    def ready(self):
-        """Initialize app when Django starts."""
-        from django_cfg.modules.django_logging import get_logger
-
-        logger = get_logger("centrifugo.apps")
-        logger.info("Centrifugo app initialized")

django_cfg/apps/centrifugo/serializers/publishes.py

@@ -1,18 +0,0 @@
-"""
-Publishes serializers for Centrifugo monitoring API.
-"""
-
-from pydantic import BaseModel, Field
-
-
-class RecentPublishesSerializer(BaseModel):
-    """Recent publishes list."""
-
-    publishes: list[dict] = Field(description="List of recent publishes")
-    count: int = Field(description="Number of publishes returned")
-    total_available: int = Field(description="Total publishes available")
-    offset: int = Field(default=0, description="Current offset for pagination")
-    has_more: bool = Field(default=False, description="Whether more results are available")
-
-
-__all__ = ["RecentPublishesSerializer"]

django_cfg/apps/dashboard/permissions.py

@@ -1,48 +0,0 @@
-"""
-Dashboard Permissions
-
-Custom permission classes for dashboard API endpoints.
-"""
-
-from rest_framework.permissions import BasePermission
-
-
-class IsSuperAdmin(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 IsStaffOrReadOnly(BasePermission):
-    """
-    Permission that allows read access to staff,
-    but write access only to superusers.
-    """
-
-    def has_permission(self, request, view):
-        """Check permissions based on request method."""
-        # Read permissions are allowed to any staff user
-        if request.method in ['GET', 'HEAD', 'OPTIONS']:
-            return bool(
-                request.user and
-                request.user.is_authenticated and
-                request.user.is_staff
-            )
-
-        # Write permissions are only allowed to superusers
-        return bool(
-            request.user and
-            request.user.is_authenticated and
-            request.user.is_superuser
-        )

django_cfg/apps/dashboard/serializers/django_q2.py

@@ -1,50 +0,0 @@
-"""
-Django-Q2 Task Serializers
-
-Serializers for displaying Django-Q2 scheduled tasks and task history.
-"""
-
-from rest_framework import serializers
-
-
-class DjangoQ2ScheduleSerializer(serializers.Serializer):
-    """Serializer for Django-Q2 scheduled tasks."""
-
-    id = serializers.IntegerField(read_only=True)
-    name = serializers.CharField(max_length=255)
-    func = serializers.CharField(max_length=512)
-    schedule_type = serializers.CharField(max_length=24)
-    repeats = serializers.IntegerField()
-    next_run = serializers.DateTimeField(allow_null=True)
-    last_run = serializers.DateTimeField(allow_null=True)
-
-
-class DjangoQ2TaskSerializer(serializers.Serializer):
-    """Serializer for Django-Q2 task execution history."""
-
-    id = serializers.CharField(max_length=32)
-    name = serializers.CharField(max_length=255)
-    func = serializers.CharField(max_length=512)
-    started = serializers.DateTimeField()
-    stopped = serializers.DateTimeField(allow_null=True)
-    success = serializers.BooleanField()
-    result = serializers.CharField(allow_null=True)
-
-
-class DjangoQ2StatusSerializer(serializers.Serializer):
-    """Serializer for Django-Q2 cluster status."""
-
-    cluster_running = serializers.BooleanField()
-    total_schedules = serializers.IntegerField()
-    active_schedules = serializers.IntegerField()
-    recent_tasks = serializers.IntegerField()
-    successful_tasks = serializers.IntegerField()
-    failed_tasks = serializers.IntegerField()
-
-
-class DjangoQ2SummarySerializer(serializers.Serializer):
-    """Summary serializer for Django-Q2 dashboard."""
-
-    status = DjangoQ2StatusSerializer()
-    schedules = DjangoQ2ScheduleSerializer(many=True)
-    recent_tasks = DjangoQ2TaskSerializer(many=True)

django_cfg/apps/dashboard/services/django_q2_service.py

@@ -1,159 +0,0 @@
-"""
-Django-Q2 Service
-
-Business logic for collecting Django-Q2 task data.
-"""
-
-from typing import Dict, List, Any
-
-
-class DjangoQ2Service:
-    """Service for aggregating Django-Q2 task information."""
-
-    @staticmethod
-    def get_schedules() -> List[Dict[str, Any]]:
-        """
-        Get all scheduled tasks from Django-Q2.
-
-        Returns:
-            List of scheduled tasks with their configurations
-        """
-        try:
-            from django_q.models import Schedule
-
-            schedules = Schedule.objects.all().order_by('-next_run')
-            return [
-                {
-                    'id': schedule.id,
-                    'name': schedule.name,
-                    'func': schedule.func,
-                    'schedule_type': schedule.schedule_type,
-                    'repeats': schedule.repeats,
-                    'next_run': schedule.next_run,
-                    'last_run': getattr(schedule, 'last_run', None),
-                }
-                for schedule in schedules
-            ]
-        except ImportError:
-            # django-q2 not installed
-            return []
-        except Exception:
-            # Database error or table doesn't exist yet
-            return []
-
-    @staticmethod
-    def get_recent_tasks(limit: int = 20) -> List[Dict[str, Any]]:
-        """
-        Get recent task executions from Django-Q2.
-
-        Args:
-            limit: Maximum number of tasks to return
-
-        Returns:
-            List of recent task executions with their results
-        """
-        try:
-            from django_q.models import Task
-
-            tasks = Task.objects.all().order_by('-started')[:limit]
-            return [
-                {
-                    'id': task.id,
-                    'name': task.name,
-                    'func': task.func,
-                    'started': task.started,
-                    'stopped': task.stopped,
-                    'success': task.success,
-                    'result': str(task.result) if task.result else None,
-                }
-                for task in tasks
-            ]
-        except ImportError:
-            # django-q2 not installed
-            return []
-        except Exception:
-            # Database error or table doesn't exist yet
-            return []
-
-    @staticmethod
-    def get_cluster_status() -> Dict[str, Any]:
-        """
-        Get Django-Q2 cluster status.
-
-        Returns:
-            Dictionary with cluster status information
-        """
-        try:
-            from django_q.models import Schedule, Task
-            from django_q.cluster import Cluster
-
-            # Count schedules
-            total_schedules = Schedule.objects.count()
-            active_schedules = Schedule.objects.filter(repeats__gt=0).count()
-
-            # Count recent tasks (last 24 hours)
-            from django.utils import timezone
-            from datetime import timedelta
-
-            last_24h = timezone.now() - timedelta(hours=24)
-            recent_tasks = Task.objects.filter(started__gte=last_24h).count()
-            successful_tasks = Task.objects.filter(
-                started__gte=last_24h, success=True
-            ).count()
-            failed_tasks = Task.objects.filter(
-                started__gte=last_24h, success=False
-            ).count()
-
-            # Check if cluster is running
-            cluster_running = False
-            try:
-                # Check for recent task activity as proxy for cluster status
-                recent_task = Task.objects.filter(
-                    started__gte=timezone.now() - timedelta(minutes=5)
-                ).exists()
-                cluster_running = recent_task
-            except Exception:
-                pass
-
-            return {
-                'cluster_running': cluster_running,
-                'total_schedules': total_schedules,
-                'active_schedules': active_schedules,
-                'recent_tasks': recent_tasks,
-                'successful_tasks': successful_tasks,
-                'failed_tasks': failed_tasks,
-            }
-        except ImportError:
-            # django-q2 not installed
-            return {
-                'cluster_running': False,
-                'total_schedules': 0,
-                'active_schedules': 0,
-                'recent_tasks': 0,
-                'successful_tasks': 0,
-                'failed_tasks': 0,
-            }
-        except Exception:
-            # Database error or table doesn't exist yet
-            return {
-                'cluster_running': False,
-                'total_schedules': 0,
-                'active_schedules': 0,
-                'recent_tasks': 0,
-                'successful_tasks': 0,
-                'failed_tasks': 0,
-            }
-
-    @classmethod
-    def get_summary(cls) -> Dict[str, Any]:
-        """
-        Get complete Django-Q2 summary for dashboard.
-
-        Returns:
-            Dictionary with status, schedules, and recent tasks
-        """
-        return {
-            'status': cls.get_cluster_status(),
-            'schedules': cls.get_schedules(),
-            'recent_tasks': cls.get_recent_tasks(limit=10),
-        }

django_cfg/apps/dashboard/views/django_q2_views.py

@@ -1,79 +0,0 @@
-"""
-Django-Q2 ViewSet
-
-API endpoints for Django-Q2 task monitoring.
-"""
-
-from rest_framework import viewsets, status
-from rest_framework.decorators import action
-from rest_framework.response import Response
-from rest_framework.permissions import IsAuthenticated
-
-from ..services.django_q2_service import DjangoQ2Service
-from ..serializers.django_q2 import (
-    DjangoQ2ScheduleSerializer,
-    DjangoQ2TaskSerializer,
-    DjangoQ2StatusSerializer,
-    DjangoQ2SummarySerializer,
-)
-
-
-class DjangoQ2ViewSet(viewsets.ViewSet):
-    """
-    ViewSet for Django-Q2 task monitoring.
-
-    Provides endpoints for:
-    - Scheduled tasks list
-    - Recent task executions
-    - Cluster status
-    - Complete summary
-    """
-
-    permission_classes = [IsAuthenticated]
-
-    @action(detail=False, methods=['get'])
-    def schedules(self, request):
-        """
-        Get all scheduled tasks.
-
-        GET /api/django_q2/schedules/
-        """
-        schedules = DjangoQ2Service.get_schedules()
-        serializer = DjangoQ2ScheduleSerializer(schedules, many=True)
-        return Response(serializer.data)
-
-    @action(detail=False, methods=['get'])
-    def tasks(self, request):
-        """
-        Get recent task executions.
-
-        GET /api/django_q2/tasks/
-        Query params:
-            - limit: Number of tasks to return (default: 20)
-        """
-        limit = int(request.query_params.get('limit', 20))
-        tasks = DjangoQ2Service.get_recent_tasks(limit=limit)
-        serializer = DjangoQ2TaskSerializer(tasks, many=True)
-        return Response(serializer.data)
-
-    @action(detail=False, methods=['get'])
-    def status(self, request):
-        """
-        Get Django-Q2 cluster status.
-
-        GET /api/django_q2/status/
-        """
-        status_data = DjangoQ2Service.get_cluster_status()
-        serializer = DjangoQ2StatusSerializer(status_data)
-        return Response(serializer.data)
-
-    def list(self, request):
-        """
-        Get complete Django-Q2 summary.
-
-        GET /api/django_q2/
-        Returns status, schedules, and recent tasks.
-        """
-        summary = DjangoQ2Service.get_summary()
-        serializer = DjangoQ2SummarySerializer(summary)
-        return Response(serializer.data)

django_cfg/apps/knowbase/examples/__init__.py

@@ -1,3 +0,0 @@
-"""
-Examples for using the External Data system in django_cfg.apps.knowbase.
-"""

django_cfg/apps/maintenance/__init__.py

@@ -1,56 +0,0 @@
-"""
-Simplified Django-CFG Maintenance Application.
-
-A simple maintenance mode management app with Cloudflare integration.
-Refactored from 119 files to ~10 files following KISS principles.
-
-Proper structure:
-- models/ - CloudflareSite and MaintenanceLog models
-- services/ - MaintenanceService for Cloudflare operations
-- admin/ - Simple admin interfaces
-- management/commands/ - CLI commands
-"""
-
-__version__ = "2.0.0"
-__author__ = "Django-CFG Team"
-
-# Lazy import registry to avoid Django initialization issues
-_LAZY_IMPORTS = {
-    # Models
-    'CloudflareApiKey': ('django_cfg.apps.maintenance.models', 'CloudflareApiKey'),
-    'CloudflareSite': ('django_cfg.apps.maintenance.models', 'CloudflareSite'),
-    'MaintenanceLog': ('django_cfg.apps.maintenance.models', 'MaintenanceLog'),
-    'ScheduledMaintenance': ('django_cfg.apps.maintenance.models', 'ScheduledMaintenance'),
-
-    # Services
-    'MaintenanceService': ('django_cfg.apps.maintenance.services', 'MaintenanceService'),
-    'SiteSyncService': ('django_cfg.apps.maintenance.services', 'SiteSyncService'),
-    'BulkOperationsService': ('django_cfg.apps.maintenance.services', 'BulkOperationsService'),
-    'ScheduledMaintenanceService': ('django_cfg.apps.maintenance.services', 'ScheduledMaintenanceService'),
-    'bulk_operations': ('django_cfg.apps.maintenance.services', 'bulk_operations'),
-    'scheduled_maintenance_service': ('django_cfg.apps.maintenance.services', 'scheduled_maintenance_service'),
-    'enable_maintenance_for_domain': ('django_cfg.apps.maintenance.services', 'enable_maintenance_for_domain'),
-    'disable_maintenance_for_domain': ('django_cfg.apps.maintenance.services', 'disable_maintenance_for_domain'),
-    'sync_site_from_cloudflare': ('django_cfg.apps.maintenance.services', 'sync_site_from_cloudflare'),
-    'enable_maintenance_for_domains': ('django_cfg.apps.maintenance.services', 'enable_maintenance_for_domains'),
-    'disable_maintenance_for_domains': ('django_cfg.apps.maintenance.services', 'disable_maintenance_for_domains'),
-    'bulk_sync_all_sites': ('django_cfg.apps.maintenance.services', 'bulk_sync_all_sites'),
-    'get_maintenance_status_report': ('django_cfg.apps.maintenance.services', 'get_maintenance_status_report'),
-    'schedule_maintenance_for_sites': ('django_cfg.apps.maintenance.services', 'schedule_maintenance_for_sites'),
-    'process_scheduled_maintenances': ('django_cfg.apps.maintenance.services', 'process_scheduled_maintenances'),
-}
-
-
-def __getattr__(name: str):
-    """Lazy import mechanism to avoid Django initialization issues."""
-    if name in _LAZY_IMPORTS:
-        module_path, attr_name = _LAZY_IMPORTS[name]
-
-        import importlib
-        module = importlib.import_module(module_path)
-        return getattr(module, attr_name)
-
-    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
-
-
-__all__ = list(_LAZY_IMPORTS.keys())

django_cfg/apps/maintenance/services/__init__.py

@@ -1,42 +0,0 @@
-"""
-Simplified maintenance services.
-
-Clean imports for the service classes with lazy loading.
-"""
-
-# Lazy import registry to avoid Django initialization issues
-_LAZY_IMPORTS = {
-    # Services
-    'MaintenanceService': ('django_cfg.apps.maintenance.services.maintenance_service', 'MaintenanceService'),
-    'SiteSyncService': ('django_cfg.apps.maintenance.services.site_sync_service', 'SiteSyncService'),
-    'BulkOperationsService': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'BulkOperationsService'),
-    'ScheduledMaintenanceService': ('django_cfg.apps.maintenance.services.scheduled_maintenance_service', 'ScheduledMaintenanceService'),
-
-    # Service functions
-    'enable_maintenance_for_domain': ('django_cfg.apps.maintenance.services.maintenance_service', 'enable_maintenance_for_domain'),
-    'disable_maintenance_for_domain': ('django_cfg.apps.maintenance.services.maintenance_service', 'disable_maintenance_for_domain'),
-    'sync_site_from_cloudflare': ('django_cfg.apps.maintenance.services.site_sync_service', 'sync_site_from_cloudflare'),
-    'bulk_operations': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'bulk_operations'),
-    'scheduled_maintenance_service': ('django_cfg.apps.maintenance.services.scheduled_maintenance_service', 'scheduled_maintenance_service'),
-    'enable_maintenance_for_domains': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'enable_maintenance_for_domains'),
-    'disable_maintenance_for_domains': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'disable_maintenance_for_domains'),
-    'bulk_sync_all_sites': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'bulk_sync_all_sites'),
-    'get_maintenance_status_report': ('django_cfg.apps.maintenance.services.bulk_operations_service', 'get_maintenance_status_report'),
-    'schedule_maintenance_for_sites': ('django_cfg.apps.maintenance.services.scheduled_maintenance_service', 'schedule_maintenance_for_sites'),
-    'process_scheduled_maintenances': ('django_cfg.apps.maintenance.services.scheduled_maintenance_service', 'process_scheduled_maintenances'),
-}
-
-
-def __getattr__(name: str):
-    """Lazy import mechanism to avoid Django initialization issues."""
-    if name in _LAZY_IMPORTS:
-        module_path, attr_name = _LAZY_IMPORTS[name]
-
-        import importlib
-        module = importlib.import_module(module_path)
-        return getattr(module, attr_name)
-
-    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
-
-
-__all__ = list(_LAZY_IMPORTS.keys())

django_cfg/apps/tasks/__init__.py

@@ -1,64 +0,0 @@
-"""
-ReArq tasks app for Django-CFG.
-
-Provides async background task processing with Redis queue.
-"""
-
-__all__ = [
-    "ReArqClient",
-    "get_rearq_client",
-    "get_tasks_config",
-    "get_tasks_config_or_default",
-    "task",
-    "cron_task",
-]
-
-
-def __getattr__(name):
-    """Lazy imports to avoid loading ReArq at Django startup."""
-    if name in ("ReArqClient", "get_rearq_client"):
-        from .services.client import ReArqClient, get_rearq_client
-        return ReArqClient if name == "ReArqClient" else get_rearq_client
-    elif name in ("get_tasks_config", "get_tasks_config_or_default"):
-        from .services.config_helper import get_tasks_config, get_tasks_config_or_default
-        return get_tasks_config if name == "get_tasks_config" else get_tasks_config_or_default
-    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
-
-
-def task(queue: str = "default", **kwargs):
-    """
-    Task decorator shortcut.
-
-    Example:
-        >>> from django_cfg.apps.tasks import task
-        >>>
-        >>> @task(queue="default")
-        >>> async def my_task(data: str):
-        ...     return f"Processed {data}"
-        >>>
-        >>> # Execute task
-        >>> job = await my_task.delay(data="test")
-        >>> result = await job.result(timeout=30)
-    """
-    from .services.client import get_rearq_client
-    client = get_rearq_client()
-    return client.task(queue=queue, **kwargs)
-
-
-def cron_task(cron: str, **kwargs):
-    """
-    Cron task decorator shortcut.
-
-    Args:
-        cron: Cron expression (e.g., "0 * * * *" for hourly)
-
-    Example:
-        >>> from django_cfg.apps.tasks import cron_task
-        >>>
-        >>> @cron_task(cron="0 0 * * *")  # Daily at midnight
-        >>> async def daily_cleanup():
-        ...     return "Cleanup complete"
-    """
-    from .services.client import get_rearq_client
-    client = get_rearq_client()
-    return client.cron_task(cron=cron, **kwargs)

django_cfg/apps/tasks/admin/__init__.py

@@ -1,4 +0,0 @@
-"""Admin configuration for tasks app."""
-from .config import tasklog_config
-
-__all__ = ["tasklog_config"]

django_cfg/apps/tasks/admin/config.py

@@ -1,98 +0,0 @@
-"""
-Admin configuration for Task models.
-
-Declarative AdminConfig using PydanticAdmin patterns.
-"""
-
-from django_cfg.modules.django_admin import (
-    AdminConfig,
-    BadgeField,
-    DateTimeField,
-    Icons,
-    UserField,
-)
-
-from ..models import TaskLog
-
-
-# Declarative configuration for TaskLog
-tasklog_config = AdminConfig(
-    model=TaskLog,
-
-    # Performance optimization
-    select_related=["user"],
-
-    # List display
-    list_display=[
-        "task_name",
-        "queue_badge",
-        "status_badge",
-        "user",
-        "duration_display",
-        "retry_count",
-        "created_at",
-        "completed_at",
-    ],
-
-    # Auto-generated display methods
-    display_fields=[
-        BadgeField(
-            name="queue_name",
-            title="Queue",
-            variant="info",
-            icon=Icons.LAYERS,
-        ),
-        BadgeField(
-            name="status",
-            title="Status",
-            label_map={
-                "queued": "secondary",
-                "in_progress": "info",
-                "completed": "success",
-                "failed": "danger",
-                "canceled": "warning",
-            },
-        ),
-        UserField(name="user", title="User", header=True),
-        DateTimeField(name="created_at", title="Created", ordering="created_at"),
-        DateTimeField(name="started_at", title="Started", ordering="started_at"),
-        DateTimeField(name="completed_at", title="Completed", ordering="completed_at"),
-    ],
-
-    # Filters
-    list_filter=["status", "task_name", "queue_name", "created_at"],
-    search_fields=[
-        "job_id",
-        "task_name",
-        "worker_id",
-        "error_message",
-        "user__username",
-        "user__email",
-    ],
-
-    # Autocomplete for user field
-    autocomplete_fields=["user"],
-
-    # Readonly fields
-    readonly_fields=[
-        "id",
-        "job_id",
-        "created_at",
-        "started_at",
-        "completed_at",
-        "duration_ms",
-        "worker_id",
-    ],
-
-    # Date hierarchy
-    date_hierarchy="created_at",
-
-    # Per page
-    list_per_page=50,
-
-    # Ordering
-    ordering=["-created_at"],
-)
-
-
-__all__ = ["tasklog_config"]