django-cfg 1.4.120__py3-none-any.whl → 1.5.2__py3-none-any.whl

django_cfg/apps/tasks/filters/task_log.py

@@ -1,121 +0,0 @@
-"""
-TaskLog FilterSet for advanced filtering.
-
-Provides comprehensive filtering capabilities for task logs.
-"""
-import django_filters
-from django.db.models import Q
-
-from ..models import TaskLog
-
-
-class TaskLogFilter(django_filters.FilterSet):
-    """
-    Advanced FilterSet for TaskLog.
-
-    Matches ReArq API query parameters where possible.
-
-    Provides filters for:
-    - Task name (exact, contains)
-    - Queue name (exact, in)
-    - Status (exact, in) - matching ReArq JobStatus
-    - Date ranges (enqueue, start, finish)
-    - Duration ranges
-    - Retry count ranges
-    - Success/failure flags
-    """
-
-    # Task name filters (matching ReArq "task" param)
-    task = django_filters.CharFilter(field_name='task_name', lookup_expr='exact')
-    task_name = django_filters.CharFilter(lookup_expr='icontains')
-    task_name_exact = django_filters.CharFilter(field_name='task_name', lookup_expr='exact')
-
-    # Queue filters
-    queue_name = django_filters.CharFilter(lookup_expr='exact')
-    queue_name_in = django_filters.BaseInFilter(field_name='queue_name')
-
-    # Status filters (matching ReArq "status" param)
-    status = django_filters.CharFilter(lookup_expr='exact')
-    status_in = django_filters.BaseInFilter(field_name='status')
-
-    # Success filter (matching ReArq JobResult)
-    success = django_filters.BooleanFilter()
-
-    # Boolean flags (computed properties)
-    is_completed = django_filters.BooleanFilter(method='filter_is_completed')
-    is_successful = django_filters.BooleanFilter(method='filter_is_successful')
-    is_failed = django_filters.BooleanFilter(method='filter_is_failed')
-
-    # Date range filters (matching ReArq "start_time" / "end_time")
-    start_time = django_filters.DateTimeFilter(field_name='enqueue_time', lookup_expr='gte')
-    end_time = django_filters.DateTimeFilter(field_name='enqueue_time', lookup_expr='lte')
-
-    # Additional date filters
-    enqueue_after = django_filters.DateTimeFilter(field_name='enqueue_time', lookup_expr='gte')
-    enqueue_before = django_filters.DateTimeFilter(field_name='enqueue_time', lookup_expr='lte')
-
-    start_after = django_filters.DateTimeFilter(field_name='start_time', lookup_expr='gte')
-    start_before = django_filters.DateTimeFilter(field_name='start_time', lookup_expr='lte')
-
-    finish_after = django_filters.DateTimeFilter(field_name='finish_time', lookup_expr='gte')
-    finish_before = django_filters.DateTimeFilter(field_name='finish_time', lookup_expr='lte')
-
-    # Django-specific filters
-    created_after = django_filters.DateTimeFilter(field_name='created_at', lookup_expr='gte')
-    created_before = django_filters.DateTimeFilter(field_name='created_at', lookup_expr='lte')
-
-    # Duration filters (milliseconds)
-    duration_min = django_filters.NumberFilter(field_name='duration_ms', lookup_expr='gte')
-    duration_max = django_filters.NumberFilter(field_name='duration_ms', lookup_expr='lte')
-
-    # Retry filters (matching ReArq Job fields)
-    job_retries_min = django_filters.NumberFilter(field_name='job_retries', lookup_expr='gte')
-    job_retries_max = django_filters.NumberFilter(field_name='job_retries', lookup_expr='lte')
-
-    # Job ID filter (matching ReArq "job_id" param)
-    job_id = django_filters.CharFilter(lookup_expr='exact')
-
-    # Worker filter (matching ReArq JobResult "worker" param)
-    worker = django_filters.CharFilter(field_name='worker_id', lookup_expr='exact')
-
-    # Error message search
-    has_error = django_filters.BooleanFilter(method='filter_has_error')
-
-    class Meta:
-        model = TaskLog
-        fields = [
-            'task_name',
-            'queue_name',
-            'status',
-            'success',
-            'job_id',
-            'worker_id',
-        ]
-
-    def filter_has_error(self, queryset, name, value):
-        """Filter tasks with/without errors."""
-        if value:
-            return queryset.filter(error_message__isnull=False).exclude(error_message='')
-        else:
-            return queryset.filter(Q(error_message__isnull=True) | Q(error_message=''))
-
-    def filter_is_completed(self, queryset, name, value):
-        """Filter by completed status."""
-        if value:
-            return queryset.filter(status__in=['success', 'failed', 'expired', 'canceled'])
-        else:
-            return queryset.filter(status__in=['deferred', 'queued', 'in_progress'])
-
-    def filter_is_successful(self, queryset, name, value):
-        """Filter by successful completion."""
-        if value:
-            return queryset.filter(status='success', success=True)
-        else:
-            return queryset.exclude(status='success', success=True)
-
-    def filter_is_failed(self, queryset, name, value):
-        """Filter by failed status."""
-        if value:
-            return queryset.filter(Q(status__in=['failed', 'expired']) | Q(success=False))
-        else:
-            return queryset.exclude(Q(status__in=['failed', 'expired']) | Q(success=False))

django_cfg/apps/tasks/migrations/0001_initial.py

@@ -1,196 +0,0 @@
-# Generated by Django 5.2.7 on 2025-10-30 11:15
-
-import django.db.models.deletion
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-    initial = True
-
-    dependencies = [
-        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
-    ]
-
-    operations = [
-        migrations.CreateModel(
-            name="TaskLog",
-            fields=[
-                (
-                    "id",
-                    models.BigAutoField(
-                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
-                    ),
-                ),
-                (
-                    "job_id",
-                    models.CharField(
-                        db_index=True,
-                        help_text="Unique job identifier from ReArq",
-                        max_length=100,
-                        unique=True,
-                    ),
-                ),
-                (
-                    "task_name",
-                    models.CharField(
-                        db_index=True, help_text="Name of the task function", max_length=200
-                    ),
-                ),
-                (
-                    "queue_name",
-                    models.CharField(
-                        db_index=True, help_text="Queue where task was executed", max_length=100
-                    ),
-                ),
-                (
-                    "args",
-                    models.JSONField(default=list, help_text="Positional arguments passed to task"),
-                ),
-                (
-                    "kwargs",
-                    models.JSONField(default=dict, help_text="Keyword arguments passed to task"),
-                ),
-                (
-                    "status",
-                    models.CharField(
-                        choices=[
-                            ("deferred", "Deferred"),
-                            ("queued", "Queued"),
-                            ("in_progress", "In Progress"),
-                            ("success", "Success"),
-                            ("failed", "Failed"),
-                            ("expired", "Expired"),
-                            ("canceled", "Canceled"),
-                        ],
-                        db_index=True,
-                        default="queued",
-                        help_text="Current task status",
-                        max_length=20,
-                    ),
-                ),
-                (
-                    "duration_ms",
-                    models.IntegerField(
-                        blank=True, help_text="Task execution duration in milliseconds", null=True
-                    ),
-                ),
-                (
-                    "job_retry",
-                    models.IntegerField(
-                        default=0,
-                        help_text="Maximum number of retries allowed (from task definition)",
-                    ),
-                ),
-                (
-                    "job_retries",
-                    models.IntegerField(default=0, help_text="Number of retries performed so far"),
-                ),
-                (
-                    "job_retry_after",
-                    models.IntegerField(default=60, help_text="Seconds to wait before retry"),
-                ),
-                (
-                    "success",
-                    models.BooleanField(
-                        blank=True,
-                        help_text="Whether task completed successfully (null = not finished)",
-                        null=True,
-                    ),
-                ),
-                (
-                    "result",
-                    models.TextField(blank=True, help_text="Task result (JSON string)", null=True),
-                ),
-                (
-                    "error_message",
-                    models.TextField(
-                        blank=True, help_text="Error message if task failed", null=True
-                    ),
-                ),
-                (
-                    "worker_id",
-                    models.CharField(
-                        blank=True,
-                        help_text="ID of worker that processed the task",
-                        max_length=100,
-                        null=True,
-                    ),
-                ),
-                (
-                    "enqueue_time",
-                    models.DateTimeField(
-                        db_index=True,
-                        help_text="When job was enqueued to ReArq (from Job.enqueue_time)",
-                    ),
-                ),
-                (
-                    "expire_time",
-                    models.DateTimeField(
-                        blank=True,
-                        help_text="When job will expire (from Job.expire_time)",
-                        null=True,
-                    ),
-                ),
-                (
-                    "start_time",
-                    models.DateTimeField(
-                        blank=True,
-                        help_text="When task execution started (from JobResult.start_time)",
-                        null=True,
-                    ),
-                ),
-                (
-                    "finish_time",
-                    models.DateTimeField(
-                        blank=True,
-                        help_text="When task execution finished (from JobResult.finish_time)",
-                        null=True,
-                    ),
-                ),
-                (
-                    "created_at",
-                    models.DateTimeField(
-                        auto_now_add=True, help_text="When TaskLog record was created in Django DB"
-                    ),
-                ),
-                (
-                    "updated_at",
-                    models.DateTimeField(
-                        auto_now=True, help_text="When TaskLog record was last updated"
-                    ),
-                ),
-                (
-                    "user",
-                    models.ForeignKey(
-                        blank=True,
-                        help_text="User who triggered the task (if applicable)",
-                        null=True,
-                        on_delete=django.db.models.deletion.SET_NULL,
-                        to=settings.AUTH_USER_MODEL,
-                    ),
-                ),
-            ],
-            options={
-                "verbose_name": "Task Log",
-                "verbose_name_plural": "Task Logs",
-                "db_table": "django_cfg_task_log",
-                "ordering": ["-enqueue_time"],
-                "indexes": [
-                    models.Index(
-                        fields=["task_name", "-enqueue_time"], name="django_cfg__task_na_e84031_idx"
-                    ),
-                    models.Index(
-                        fields=["status", "-enqueue_time"], name="django_cfg__status_a59726_idx"
-                    ),
-                    models.Index(
-                        fields=["queue_name", "status"], name="django_cfg__queue_n_b8a67b_idx"
-                    ),
-                    models.Index(
-                        fields=["success", "-enqueue_time"], name="django_cfg__success_85e48e_idx"
-                    ),
-                    models.Index(fields=["-created_at"], name="django_cfg__created_4eea05_idx"),
-                ],
-            },
-        ),
-    ]

django_cfg/apps/tasks/migrations/0002_delete_tasklog.py

@@ -1,16 +0,0 @@
-# Generated by Django 5.2.7 on 2025-10-31 05:54
-
-from django.db import migrations
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ("tasks", "0001_initial"),
-    ]
-
-    operations = [
-        migrations.DeleteModel(
-            name="TaskLog",
-        ),
-    ]

django_cfg/apps/tasks/models/__init__.py

@@ -1,4 +0,0 @@
-"""Task models."""
-from .task_log import TaskLog
-
-__all__ = ["TaskLog"]

django_cfg/apps/tasks/models/task_log.py

@@ -1,246 +0,0 @@
-"""
-Task execution log model.
-
-Stores history of task executions for monitoring and debugging.
-"""
-from django.conf import settings
-from django.db import models
-from django.utils import timezone
-
-
-class TaskLog(models.Model):
-    """
-    Log of task executions.
-
-    Stores execution history from ReArq task queue.
-    Status values match ReArq's JobStatus enum.
-    """
-
-    class StatusChoices(models.TextChoices):
-        """Task status matching ReArq JobStatus enum."""
-        DEFERRED = "deferred", "Deferred"
-        QUEUED = "queued", "Queued"
-        IN_PROGRESS = "in_progress", "In Progress"
-        SUCCESS = "success", "Success"
-        FAILED = "failed", "Failed"
-        EXPIRED = "expired", "Expired"
-        CANCELED = "canceled", "Canceled"
-
-    # Task identification
-    job_id = models.CharField(
-        max_length=100,
-        unique=True,
-        db_index=True,
-        help_text="Unique job identifier from ReArq"
-    )
-    task_name = models.CharField(
-        max_length=200,
-        db_index=True,
-        help_text="Name of the task function"
-    )
-    queue_name = models.CharField(
-        max_length=100,
-        db_index=True,
-        help_text="Queue where task was executed"
-    )
-
-    # Arguments
-    args = models.JSONField(
-        default=list,
-        help_text="Positional arguments passed to task"
-    )
-    kwargs = models.JSONField(
-        default=dict,
-        help_text="Keyword arguments passed to task"
-    )
-
-    # Status tracking
-    status = models.CharField(
-        max_length=20,
-        choices=StatusChoices.choices,
-        default=StatusChoices.QUEUED,
-        db_index=True,
-        help_text="Current task status"
-    )
-
-    # Performance metrics
-    duration_ms = models.IntegerField(
-        null=True,
-        blank=True,
-        help_text="Task execution duration in milliseconds"
-    )
-
-    # Retry configuration (from ReArq Job)
-    job_retry = models.IntegerField(
-        default=0,
-        help_text="Maximum number of retries allowed (from task definition)"
-    )
-    job_retries = models.IntegerField(
-        default=0,
-        help_text="Number of retries performed so far"
-    )
-    job_retry_after = models.IntegerField(
-        default=60,
-        help_text="Seconds to wait before retry"
-    )
-
-    # Result tracking
-    success = models.BooleanField(
-        null=True,
-        blank=True,
-        help_text="Whether task completed successfully (null = not finished)"
-    )
-    result = models.TextField(
-        null=True,
-        blank=True,
-        help_text="Task result (JSON string)"
-    )
-    error_message = models.TextField(
-        null=True,
-        blank=True,
-        help_text="Error message if task failed"
-    )
-
-    # Worker information
-    worker_id = models.CharField(
-        max_length=100,
-        null=True,
-        blank=True,
-        help_text="ID of worker that processed the task"
-    )
-
-    # Timestamps (matching ReArq Job fields)
-    enqueue_time = models.DateTimeField(
-        db_index=True,
-        help_text="When job was enqueued to ReArq (from Job.enqueue_time)"
-    )
-    expire_time = models.DateTimeField(
-        null=True,
-        blank=True,
-        help_text="When job will expire (from Job.expire_time)"
-    )
-    start_time = models.DateTimeField(
-        null=True,
-        blank=True,
-        help_text="When task execution started (from JobResult.start_time)"
-    )
-    finish_time = models.DateTimeField(
-        null=True,
-        blank=True,
-        help_text="When task execution finished (from JobResult.finish_time)"
-    )
-
-    # Django-specific timestamps
-    created_at = models.DateTimeField(
-        auto_now_add=True,
-        help_text="When TaskLog record was created in Django DB"
-    )
-    updated_at = models.DateTimeField(
-        auto_now=True,
-        help_text="When TaskLog record was last updated"
-    )
-
-    # User tracking (optional)
-    user = models.ForeignKey(
-        settings.AUTH_USER_MODEL,
-        on_delete=models.SET_NULL,
-        null=True,
-        blank=True,
-        help_text="User who triggered the task (if applicable)"
-    )
-
-    class Meta:
-        # app_label is derived from apps.py: django_cfg.apps.tasks -> last segment = "tasks"
-        # To get "django_cfg_tasks" for consistent admin URLs, we explicitly set it:
-        app_label = "django_cfg_tasks"
-        db_table = "django_cfg_task_log"
-        ordering = ["-enqueue_time"]
-        indexes = [
-            models.Index(fields=["task_name", "-enqueue_time"]),
-            models.Index(fields=["status", "-enqueue_time"]),
-            models.Index(fields=["queue_name", "status"]),
-            models.Index(fields=["success", "-enqueue_time"]),
-            models.Index(fields=["-created_at"]),  # For Django admin
-        ]
-        verbose_name = "Task Log"
-        verbose_name_plural = "Task Logs"
-
-    def __str__(self) -> str:
-        return f"{self.task_name} ({self.status})"
-
-    @property
-    def is_completed(self) -> bool:
-        """Check if task is in a terminal state."""
-        return self.status in [
-            self.StatusChoices.SUCCESS,
-            self.StatusChoices.FAILED,
-            self.StatusChoices.EXPIRED,
-            self.StatusChoices.CANCELED,
-        ]
-
-    @property
-    def is_successful(self) -> bool:
-        """Check if task completed successfully."""
-        return self.status == self.StatusChoices.SUCCESS and self.success is True
-
-    @property
-    def is_failed(self) -> bool:
-        """Check if task failed."""
-        return self.status in [
-            self.StatusChoices.FAILED,
-            self.StatusChoices.EXPIRED,
-        ] or self.success is False
-
-    def mark_started(self, worker_id: str = None, start_time=None):
-        """Mark task as started (from ReArq JobResult)."""
-        self.status = self.StatusChoices.IN_PROGRESS
-        self.start_time = start_time or timezone.now()
-        if worker_id:
-            self.worker_id = worker_id
-        self.save(update_fields=["status", "start_time", "worker_id", "updated_at"])
-
-    def mark_completed(self, result: str = None, finish_time=None):
-        """Mark task as completed successfully (from ReArq JobResult)."""
-        self.status = self.StatusChoices.SUCCESS
-        self.success = True
-        self.finish_time = finish_time or timezone.now()
-        if result is not None:
-            self.result = result
-
-        # Calculate duration
-        if self.start_time and self.finish_time:
-            delta = self.finish_time - self.start_time
-            self.duration_ms = int(delta.total_seconds() * 1000)
-
-        self.save(update_fields=["status", "success", "finish_time", "result", "duration_ms", "updated_at"])
-
-    def mark_failed(self, error_message: str, finish_time=None):
-        """Mark task as failed with error message (from ReArq JobResult)."""
-        self.status = self.StatusChoices.FAILED
-        self.success = False
-        self.error_message = error_message
-        self.finish_time = finish_time or timezone.now()
-
-        # Calculate duration
-        if self.start_time and self.finish_time:
-            delta = self.finish_time - self.start_time
-            self.duration_ms = int(delta.total_seconds() * 1000)
-
-        self.save(update_fields=["status", "success", "error_message", "finish_time", "duration_ms", "updated_at"])
-
-    def mark_expired(self):
-        """Mark task as expired (from ReArq Job.status)."""
-        self.status = self.StatusChoices.EXPIRED
-        self.success = False
-        self.save(update_fields=["status", "success", "updated_at"])
-
-    def mark_canceled(self):
-        """Mark task as canceled (from ReArq Job.status)."""
-        self.status = self.StatusChoices.CANCELED
-        self.success = False
-        self.save(update_fields=["status", "success", "updated_at"])
-
-    def increment_retry(self):
-        """Increment retry counter (from ReArq Job.job_retries)."""
-        self.job_retries += 1
-        self.save(update_fields=["job_retries", "updated_at"])

django_cfg/apps/tasks/serializers/__init__.py

@@ -1,28 +0,0 @@
-"""
-ReArq Tasks API Serializers.
-
-DRF serializers for TaskLog model and ReArq operations.
-"""
-from .task_log import (
-    TaskLogSerializer,
-    TaskLogListSerializer,
-    TaskLogDetailSerializer,
-    TaskLogStatsSerializer,
-    TasksByQueueSerializer,
-    TasksByStatusSerializer,
-    TaskLogOverviewSerializer,
-    TaskLogTimelineItemSerializer,
-    TaskLogTimelineSerializer,
-)
-
-__all__ = [
-    "TaskLogSerializer",
-    "TaskLogListSerializer",
-    "TaskLogDetailSerializer",
-    "TaskLogStatsSerializer",
-    "TasksByQueueSerializer",
-    "TasksByStatusSerializer",
-    "TaskLogOverviewSerializer",
-    "TaskLogTimelineItemSerializer",
-    "TaskLogTimelineSerializer",
-]