djresttoolkit 0.17.0__tar.gz → 0.17.2__tar.gz

djresttoolkit-0.17.2/.python-version

@@ -0,0 +1 @@
+3.13

djresttoolkit-0.17.2/.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "files.exclude": {
+        "**/.git": true,
+        "**/.svn": true,
+        "**/.hg": true,
+        "**/.DS_Store": true,
+        "**/Thumbs.db": true,
+        "**/__pycache__": true,
+        "**/.pytest_cache": true,
+        "**/.ruff_cache": true
+    }
+}

{djresttoolkit-0.17.0 → djresttoolkit-0.17.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djresttoolkit
-Version: 0.17.0
+Version: 0.17.2
 Summary: A collection of Django and DRF utilities to simplify API development.
 Project-URL: Homepage, https://github.com/shaileshpandit141/djresttoolkit
 Project-URL: Documentation, https://shaileshpandit141.github.io/djresttoolkit
@@ -33,7 +33,7 @@ License: # MIT License
         OTHER DEALINGS IN THE SOFTWARE.
 License-File: LICENSE
 Keywords: api-development,django,django-authentication,django-email,django-helpers,django-mixins,django-pagination,django-rest,django-rest-framework-utilities,django-rest-utilities,django-serializers,django-shortcuts,django-utilities,djangorestframework,drf,python-package,rest-api
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Django
 Classifier: Framework :: Django :: 4.0
 Classifier: Intended Audience :: Developers

djresttoolkit-0.17.2/demo/apps/todos/admin.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from django.contrib import admin
+from django.contrib.admin import ModelAdmin
+
+from .models import Tag, Todo, TodoTag
+
+if TYPE_CHECKING:
+    class TodoAdminBase(ModelAdmin[Todo]): ...
+    class TagAdminBase(ModelAdmin[Todo]): ...
+    class TodoTagAdminBase(ModelAdmin[Todo]): ...
+else:
+    class TodoAdminBase(ModelAdmin): ... 
+    class TagAdminBase(ModelAdmin): ...
+    class TodoTagAdminBase(ModelAdmin): ...
+
+
+@admin.register(Todo)
+class TodoAdmin(TodoAdminBase):
+    list_display = [
+        "id",
+        "user",
+        "title",
+        "due_date",
+        "priority",
+        "status",
+    ]
+    list_display_links = list_display
+    ordering = ("-id",)
+    list_filter = ["priority", "status"]
+    search_fields = ["title"]
+
+
+@admin.register(Tag)
+class TagAdmin(TagAdminBase):
+    list_display = ["id", "name"]
+    list_display_links = list_display
+    ordering = ("-id",)
+    search_fields = ["name"]
+
+
+@admin.register(TodoTag)
+class TodoTagAdmin(TodoTagAdminBase):
+    list_display = ["id", "todo", "tag"]
+    list_display_links = list_display
+    ordering = ("-id",)

djresttoolkit-0.17.2/demo/apps/todos/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class TodosConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.todos"
+    label = "todos"

djresttoolkit-0.17.2/demo/apps/todos/dbseed/tag_seed.py

@@ -0,0 +1,13 @@
+from djresttoolkit.dbseed.models import (  # type: ignore[import-not-found]
+    Field,
+    Gen,
+    SeedModel,
+)
+
+from ..models import Tag
+
+
+class TagSeedModel(SeedModel):
+    __model__ = Tag
+
+    name: str = Field(default_factory=Gen.word)

djresttoolkit-0.17.2/demo/apps/todos/dbseed/todo_seed.py

@@ -0,0 +1,44 @@
+from django.utils import timezone
+
+from djresttoolkit.dbseed.models import (  # type: ignore[import-not-found]
+    Field,
+    Gen,
+    SeedModel,
+)
+
+from ..models import Todo, TodoPriority, TodoStatus
+
+
+class TodoSeedModel(SeedModel):
+    __model__ = Todo
+
+    title: str = Field(
+        default_factory=lambda: Gen.sentence(nb_words=4),
+    )
+    description: str = Field(
+        default_factory=lambda: Gen.sentence(nb_words=20),
+    )
+    due_date: str | None = Field(
+        default_factory=lambda: Gen.date_time_this_year(
+            before_now=False, after_now=True
+        )
+        .replace(tzinfo=timezone.get_current_timezone())
+        .isoformat(),
+    )
+    priority: str = Field(
+        default_factory=lambda: Gen.random_element(
+            elements=[choice[0] for choice in TodoPriority.choices]
+        ),
+    )
+    status: str = Field(
+        default_factory=lambda: Gen.random_element(
+            elements=[choice[0] for choice in TodoStatus.choices]
+        ),
+    )
+    completed_at: str | None = Field(
+        default_factory=lambda: Gen.date_time_this_year(
+            before_now=False, after_now=True
+        )
+        .replace(tzinfo=timezone.get_current_timezone())
+        .isoformat(),
+    )

djresttoolkit-0.17.2/demo/apps/todos/dbseed/todo_tag_seed.py

@@ -0,0 +1,22 @@
+from djresttoolkit.dbseed.models import (  # type: ignore[import-not-found]
+    Field,
+    Gen,
+    SeedModel,
+)
+
+from ..models import Tag, Todo, TodoTag
+
+
+class TodoTagSeedModel(SeedModel):
+    __model__ = TodoTag
+
+    todo: int = Field(
+        default_factory=lambda: Gen.random_element(
+            list(Todo.objects.all().values_list("id", flat=True))
+        )
+    )
+    tag: int = Field(
+        default_factory=lambda: Gen.random_element(
+            list(Tag.objects.all().values_list("id", flat=True))
+        )
+    )

djresttoolkit-0.17.2/demo/apps/todos/migrations/0001_initial.py

@@ -0,0 +1,131 @@
+# Generated by Django 5.2.5 on 2025-08-18 05:32
+
+import django.db.models.deletion
+import uuid
+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="Tag",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                (
+                    "uuid",
+                    models.UUIDField(default=uuid.uuid4, editable=False, unique=True),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("name", models.CharField(max_length=50, unique=True)),
+            ],
+            options={
+                "abstract": False,
+            },
+        ),
+        migrations.CreateModel(
+            name="Todo",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                (
+                    "uuid",
+                    models.UUIDField(default=uuid.uuid4, editable=False, unique=True),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("title", models.CharField(max_length=255)),
+                ("description", models.TextField(blank=True, default="")),
+                ("due_date", models.DateTimeField(blank=True, null=True)),
+                (
+                    "priority",
+                    models.CharField(
+                        choices=[
+                            ("low", "Low"),
+                            ("medium", "Medium"),
+                            ("high", "High"),
+                            ("critical", "Critical"),
+                        ],
+                        default="medium",
+                        max_length=20,
+                    ),
+                ),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("pending", "Pending"),
+                            ("in_progress", "In Progress"),
+                            ("completed", "Completed"),
+                            ("archived", "Archived"),
+                        ],
+                        default="pending",
+                        max_length=20,
+                    ),
+                ),
+                ("completed_at", models.DateTimeField(blank=True, null=True)),
+                (
+                    "user",
+                    models.ForeignKey(
+                        help_text="Owner of this todo",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="todos",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "abstract": False,
+            },
+        ),
+        migrations.CreateModel(
+            name="TodoTag",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "tag",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="tag_todos",
+                        to="todos.tag",
+                    ),
+                ),
+                (
+                    "todo",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="todo_tags",
+                        to="todos.todo",
+                    ),
+                ),
+            ],
+            options={
+                "unique_together": {("todo", "tag")},
+            },
+        ),
+    ]

djresttoolkit-0.17.2/demo/apps/todos/models.py

@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+import uuid
+from uuid import UUID
+
+from django.conf import settings
+from django.contrib.auth.models import AbstractUser
+from django.db.models import (
+    CASCADE,
+    BigAutoField,
+    CharField,
+    DateTimeField,
+    ForeignKey,
+    Model,
+    TextChoices,
+    TextField,
+    UUIDField,
+)
+from django.utils import timezone
+
+
+class TodoPriority(TextChoices):
+    LOW = "low", "Low"
+    MEDIUM = "medium", "Medium"
+    HIGH = "high", "High"
+    CRITICAL = "critical", "Critical"
+
+
+class TodoStatus(TextChoices):
+    PENDING = "pending", "Pending"
+    IN_PROGRESS = "in_progress", "In Progress"
+    COMPLETED = "completed", "Completed"
+    ARCHIVED = "archived", "Archived"
+
+
+class BaseModel(Model):
+    """Abstract base with UUID PK and timestamps."""
+
+    id: BigAutoField[int, int] = BigAutoField(primary_key=True, editable=False)
+    uuid: UUIDField[UUID, str] = UUIDField(
+        unique=True,
+        default=uuid.uuid4,
+        editable=False,
+    )
+    created_at: DateTimeField[str, str] = DateTimeField(auto_now_add=True)
+    updated_at: DateTimeField[str, str] = DateTimeField(auto_now=True)
+
+    class Meta:
+        abstract = True
+
+
+class Todo(BaseModel):
+    """Main Todo model."""
+
+    user: ForeignKey[int, AbstractUser] = ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=CASCADE,
+        related_name="todos",
+        help_text="Owner of this todo",
+    )
+    title: CharField[str, str] = CharField(max_length=255)
+    description: TextField[str, str] = TextField(blank=True, default="")
+    due_date: DateTimeField[str | None, str | None] = DateTimeField(
+        null=True,
+        blank=True,
+    )
+
+    priority: CharField[str, str] = CharField(
+        max_length=20,
+        choices=TodoPriority.choices,
+        default=TodoPriority.MEDIUM,
+    )
+    status: CharField[str, str] = CharField(
+        max_length=20,
+        choices=TodoStatus.choices,
+        default=TodoStatus.PENDING,
+    )
+
+    completed_at: DateTimeField[str | None, str | None] = DateTimeField(
+        null=True,
+        blank=True,
+    )
+
+    def mark_completed(self) -> None:
+        """Mark todo as completed safely."""
+        self.status = TodoStatus.COMPLETED
+        self.completed_at = str(timezone.now())
+        self.save(update_fields=["status", "completed_at", "updated_at"])
+
+    def __str__(self) -> str:
+        return f"Todo({self.id}, {self.title})"
+
+
+class Tag(BaseModel):
+    """Simple tags for todos."""
+
+    name: CharField[str, str] = CharField(max_length=50, unique=True)
+
+    def __str__(self) -> str:
+        return f"Tag({self.id}, {self.name})"
+
+
+class TodoTag(Model):
+    """Many-to-many through model for tagging."""
+
+    todo: ForeignKey[int, Todo] = ForeignKey(
+        Todo,
+        on_delete=CASCADE,
+        related_name="todo_tags",
+    )
+    tag: ForeignKey[int, Tag] = ForeignKey(
+        Tag,
+        on_delete=CASCADE,
+        related_name="tag_todos",
+    )
+
+    class Meta:
+        unique_together = ("todo", "tag")

djresttoolkit-0.17.2/demo/apps/todos/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

djresttoolkit-0.17.2/demo/apps/todos/urls.py

@@ -0,0 +1,7 @@
+"""
+URL configuration for todos app.
+"""
+
+from django.urls import path
+
+urlpatterns = []

djresttoolkit-0.17.2/demo/apps_config/asgi.py

@@ -0,0 +1,10 @@
+import os
+
+# Import Django's ASGI handler
+from django.core.asgi import get_asgi_application
+
+# Configure Django settings module path
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "apps_config.settings")
+
+# Create ASGI application instance
+application = get_asgi_application()

djresttoolkit-0.17.2/demo/apps_config/serializers.py

@@ -0,0 +1,7 @@
+from django.contrib.auth.models import User
+from rest_framework.serializers import CharField, Serializer
+
+
+class RetrieveTokenSerializer(Serializer[User]):
+    username = CharField(required=True)
+    password = CharField(write_only=True, required=True)