djangorestframework-dataclasses

What it is and what it does

This package provides a DataclassSerializer that automatically generates Django REST Framework serializer fields from dataclass type annotations. Instead of manually declaring each field twice—once in the dataclass and again in a DRF Serializer—you define the dataclass with type hints and let the serializer introspect it. The package handles common Python types (str, bool, int, float, date, datetime, time, timedelta, Decimal, UUID, Enum, Literal, Union, Iterable, Mapping) and generates corresponding REST Framework fields, respecting optional fields, nullable types, and read-only markers.

It follows the ModelSerializer pattern familiar to Django developers: you specify the dataclass in a Meta subclass, optionally override or add fields, and get create() and update() implementations for free. The serializer works with the standard DRF workflow—calling .data for serialized output, .validated_data for deserialized instances, and save() to persist or update objects. This is most useful in projects that use dataclasses for domain models or DTOs rather than Django ORM models.

Use it for

• Serialize and deserialize dataclass-based domain models in REST APIs without duplicating field definitions.
• Build REST endpoints that accept and return typed dataclass instances instead of raw dictionaries.
• Reduce boilerplate when working with dataclasses as request/response DTOs in Django views or viewsets.
• Automatically validate incoming data against dataclass type annotations and constraints.
• Migrate from ModelSerializer-based APIs to dataclass-based architectures with minimal refactoring.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

djangorestframework-dataclasses on PyPI

Before you install

Low friction install with three straightforward runtime dependencies (django, djangorestframework, typing_extensions). Maintenance status is aging—last release was 457 days ago—but the repository remains active and marked Production/Stable.

Requires Django 3.2+ and Django REST Framework 3.11+; Python 3.7+ (description lists 3.8+ as tested minimum).

License in practice

BSD-3-clause license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install djangorestframework-dataclasses

from dataclasses import dataclass
from djangorestframework_dataclasses.serializers import DataclassSerializer

@dataclass
class Person:
    name: str
    email: str

class PersonSerializer(DataclassSerializer):
    class Meta:
        dataclass = Person

Package facts

Evidence: djangorestframework_dataclasses-1.4.0-py3-none-any.whl

Tags

More Python Modules packages

See also dataclasses · drf-pydantic · django-typomatic · jax-dataclasses · desert · drf-extra-fields · serpyco-rs · drf-flex-fields · rest-framework-generic-relations · dataclasses-json