Modern REST framework for Django with types and async support!

Features

• Blazingly fast
• Supports django>=5.0
• Supports pydantic2, msgspec, attrs, dataclasses, TypedDict as model schemas, but not bound to any of these libraries
• Supports async Django without any sync_to_async calls inside, tested to work with free-threading builds
• Fully typed and checked with mypy, pyright, and pyrefly in strict modes
• Supports content negotiation, has default implementations for json, msgpack, SSE, Json Lines, and more
• Strict schema validation of both requests and responses, including errors
• Supports OpenAPI 3.1 / 3.2 semantic schema generation out of the box
• Supports all your existing django primitives and packages, no custom runtimes
• Great testing tools with schemathesis, polyfactory, tracecov, bundled pytest plugin, and default Django's testing primitives
• 100% test coverage with 2000+ of carefully designed unit, integration, and property-based tests
• High security standards
• Built by the community for the community, not a single-person project
• Great docs
• No AI slop, but built for the LLM era
• No emojis 🌚️️

---

Sync mode

Testimonials

The one thing I really love about django-modern-rest is its pluggable serializers and validators. Frameworks that are tightly coupled with pydantic can be really painful to work with.

— Kirill Podoprigora, CPython core developer

Using django-modern-rest has been a game-changer for my productivity. The strict type safety and schema validation for both requests and responses mean I spend less time debugging and more time building.

— Josiah Kaviani, Django core developer

I rarely see frameworks that treat their OpenAPI schema as a first-class citizen. django-modern-rest not only generates a schema that accurately reflects your code, but also gives you the tools to verify it.

— Dmitry Dygalo, author of Schemathesis

Installation

Works for:

• CPython 3.11+ or PyPy 3.11+
• Django 5.0+

pip install django-modern-rest

There are several included extras:

• 'django-modern-rest[msgspec]' provides msgspec support and the fastest json parsing, recommended to be always included
• 'django-modern-rest[pydantic]' provides pydantic support
• 'django-modern-rest[attrs]' provides attrs support
• 'django-modern-rest[jwt]' provides pyjwt auth support
• 'django-modern-rest[openapi]' provides OpenAPIschema validation, yaml OpenAPI view, and generates better OpenAPI examples with polyfactory

Example

The shortest example (click here to copy the whole file):

>>>importuuid>>>importpydantic>>>fromdmrimportBody, Controller, Headers>>># Or use `dmr.plugins.msgspec` or write your own!>>>fromdmr.plugins.pydanticimportPydanticFastSerializer>>>classUserCreateModel(pydantic.BaseModel):
... email: str>>>classUserModel(UserCreateModel):
... uid: uuid.UUID
... consumer: str>>>classHeaderModel(pydantic.BaseModel):
... consumer: str=pydantic.Field(alias='X-API-Consumer')
>>>classUserController(Controller[PydanticFastSerializer]):
... asyncdefpost( # <- can be sync as well!
... self,
... parsed_body: Body[UserCreateModel],
... parsed_headers: Headers[HeaderModel],
... ) ->UserModel:
... """All added props have the correct runtime and static types."""
... returnUserModel(
... uid=uuid.uuid4(),
... email=parsed_body.email,
... consumer=parsed_headers.consumer,
... )

And then route this controller in your urls.py:

>>>fromdjango.urlsimportinclude, path>>>fromdmr.routingimportRouter>>>router=Router(
... 'api/',
... [
... path('user/', UserController.as_view(), name='users'),
... ],
... )
>>>urlpatterns= [
... path(router.prefix, include((router.urls, 'my_app'), namespace='api')),
... ]

Done! Now you have your shiny API with 100% type safe validation and interactive docs.

Next steps:

• The full documentation has everything you need to get started!
• wemake-django-template can be used to jump-start your new project with django-modern-rest!
• awesome-django-modern-rest - a curated list of resources related to django-modern-rest!

License

MIT

Credits

This project was generated with wemake-python-package. Current template version is: e1fcf312d7f715323dcff0d376a40b7e3b47f9b7. See what is updated since then.