drf

Django REST Framework (DRF) Skill

Load alongside skills/django/SKILL.md and all skills/common/ files.

---

Stack Additions (on top of Django)

Layer	Library
REST Framework	djangorestframework 3.15+
JWT Auth	djangorestframework-simplejwt
Filtering	django-filter
Throttling	DRF built-in
Schema / Docs	drf-spectacular (OpenAPI 3)
Pagination	DRF built-in + custom

---

Settings

# config/settings/base.py
REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "rest_framework_simplejwt.authentication.JWTAuthentication",
    ],
    "DEFAULT_PERMISSION_CLASSES": [
        "rest_framework.permissions.IsAuthenticated",
    ],
    "DEFAULT_RENDERER_CLASSES": [
        "rest_framework.renderers.JSONRenderer",
    ],
    "DEFAULT_PAGINATION_CLASS": "apps.core.pagination.StandardResultsPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_FILTER_BACKENDS": [
        "django_filters.rest_framework.DjangoFilterBackend",
        "rest_framework.filters.SearchFilter",
        "rest_framework.filters.OrderingFilter",
    ],
    "DEFAULT_THROTTLE_CLASSES": [
        "rest_framework.throttling.AnonRateThrottle",
        "rest_framework.throttling.UserRateThrottle",
    ],
    "DEFAULT_THROTTLE_RATES": {
        "anon": "100/day",
        "user": "1000/day",
    },
    "EXCEPTION_HANDLER": "apps.core.exception_handler.custom_exception_handler",
}

---

Serializer Standards

# apps/users/serializers.py
from rest_framework import serializers
from apps.users.models import User

class UserCreateSerializer(serializers.ModelSerializer):
    """Serializer for creating a new user account."""

    password = serializers.CharField(write_only=True, min_length=8)

    class Meta:
        model = User
        fields = ["email", "name", "password"]
        extra_kwargs = {"password": {"write_only": True}}

    def validate_email(self, value: str) -> str:
        if User.objects.filter(email=value.lower()).exists():
            raise serializers.ValidationError("Email already in use.")
        return value.lower()

    def create(self, validated_data: dict) -> User:
        from apps.users.services import UserService
        return UserService.create_user(**validated_data)


class UserResponseSerializer(serializers.ModelSerializer):
    """Read-only serializer for user responses."""

    class Meta:
        model = User
        fields = ["id", "public_id", "email", "name", "is_active", "created_at"]
        read_only_fields = fields