\n\n## Features\n\n- [x] [Blazingly fast](https://django-modern-rest.readthedocs.io/en/latest/pages/deep-dive/performance.html)\n- [x] Supports async Django without any `sync_to_async` / `async_to_sync` calls inside, tested to work with free-threading builds\n- [x] Supports `pydantic2`, `msgspec`, `attrs`, `dataclasses`, `TypedDict` as model schemas, but not bound to any of these libraries\n- [x] Fully typed and checked with `mypy`, `pyright`, `ty`, and `pyrefly` in strict modes\n- [x] Supports content negotiation, has default implementations for `json`, `msgpack`, SSE, Json Lines, and more\n- [x] Strict schema validation of both requests and responses, including errors\n- [x] Supports OpenAPI 3.1 / 3.2 semantic schema generation out of the box\n- [x] Supports all your existing `django` primitives and packages, no custom runtimes\n- [x] Great testing tools with [schemathesis](https://github.com/schemathesis/schemathesis), [polyfactory](https://github.com/litestar-org/polyfactory), [tracecov](https://django-modern-rest.readthedocs.io/en/latest/pages/testing/tracecov.html), bundled `pytest` plugin, and default Django's testing primitives\n- [x] 100% test coverage with 4000+ of carefully designed unit, integration, typing, and property-based tests on different databases and caches\n- [x] High [security standards](https://github.com/wemake-services/django-modern-rest/blob/master/.github/SECURITY.md)\n- [x] Built [by the community](https://github.com/wemake-services/django-modern-rest/graphs/contributors) for the community, not a single-person project\n- [x] Great [docs](https://django-modern-rest.readthedocs.io/en/latest/)\n- [x] No AI slop, but [built for the LLM era](https://django-modern-rest.readthedocs.io/en/latest/pages/getting-started.html#llms-support)\n- [x] No emojis đď¸ď¸\n\n---------\n\n
\n\n\n## Testimonials\n\n> The one thing I really love about **django-modern-rest** is its pluggable\n> serializers and validators. Frameworks that are tightly coupled\n> with **pydantic** can be really painful to work with.\n\nâ **[Kirill Podoprigora](https://github.com/Eclips4)**, CPython core developer\n\n> 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.\n\nâ **[Josiah Kaviani](https://github.com/proofit404)**, Django core developer\n\n> 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.\n\nâ **[Dmitry Dygalo](https://github.com/Stranger6667)**, author of Schemathesis\n\n## Installation\n\nWorks for:\n- CPython 3.11+ or PyPy 3.11+\n- Django 5.0, 5.1, 5.2, 6.0, 6.1\n\n```bash\npip install django-modern-rest\n```\n\nThere are several included extras:\n- `'django-modern-rest[msgspec]'` provides [`msgspec`](https://github.com/msgspec/msgspec) support\n and the fastest json parsing, recommended to be **always** included\n- `'django-modern-rest[pydantic]'` provides [`pydantic`](https://github.com/pydantic/pydantic) support\n- `'django-modern-rest[attrs]'` provides [`attrs`](https://github.com/python-attrs/attrs) support\n- `'django-modern-rest[jwt]'` provides [`pyjwt`](https://github.com/jpadilla/pyjwt) auth support\n- `'django-modern-rest[openapi]'` provides `OpenAPI` [schema validation](https://github.com/python-openapi/openapi-spec-validator),\n `yaml` OpenAPI view,\n and generates better OpenAPI examples with [`polyfactory`](https://github.com/litestar-org/polyfactory)\n\n\n## Example\n\nThe shortest example [(click here to copy the whole file)](https://github.com/wemake-services/django-modern-rest/blob/master/docs/examples/getting_started/pydantic_controller.py):\n\n```python\n>>> import uuid\n>>> import pydantic\n>>> from dmr import Body, Controller, Headers\n>>> # Or use `dmr.plugins.msgspec` or write your own!\n>>> from dmr.plugins.pydantic import PydanticFastSerializer\n\n>>> class UserCreateModel(pydantic.BaseModel):\n... email: str\n\n>>> class UserModel(UserCreateModel):\n... uid: uuid.UUID\n... consumer: str\n\n>>> class HeaderModel(pydantic.BaseModel):\n... consumer: str = pydantic.Field(alias='X-API-Consumer')\n\n>>> class UserController(Controller[PydanticFastSerializer]):\n... async def post( # <- can be sync as well!\n... self,\n... parsed_body: Body[UserCreateModel],\n... parsed_headers: Headers[HeaderModel],\n... ) -> UserModel:\n... \"\"\"All added props have the correct runtime and static types.\"\"\"\n... return UserModel(\n... uid=uuid.uuid4(),\n... email=parsed_body.email,\n... consumer=parsed_headers.consumer,\n... )\n\n```\n\nAnd then route this controller in your `urls.py`:\n\n```python\n>>> from django.urls import path\n>>> from dmr.routing import Router\n\n>>> router = Router(\n... 'api/',\n... [\n... path('user/', UserController.as_view(), name='users'),\n... ],\n... )\n>>> urlpatterns = [\n... router.to_urlpatterns(namespace='api'),\n... ]\n\n```\n\nDone! Now you have your shiny API with 100% type\nsafe validation and interactive docs.\n\nNext steps:\n- [The full documentation](https://django-modern-rest.readthedocs.io/en/latest/) has everything you need to get started!\n- [wemake-django-template](https://github.com/wemake-services/wemake-django-template) can be used to jump-start your new project with `django-modern-rest`!\n- [awesome-django-modern-rest](https://github.com/kondratevdev/awesome-django-modern-rest) - a curated list of resources related to `django-modern-rest`!\n\n\n## Contributors\n\n[](https://github.com/wemake-services/django-modern-rest/graphs/contributors)\n\n\n## License\n\n[MIT](https://github.com/wemake-services/django-modern-rest/blob/master/LICENSE)\n\n\n## Credits\n\nThis project was generated with [`wemake-python-package`](https://github.com/wemake-services/wemake-python-package). Current template version is: [e1fcf312d7f715323dcff0d376a40b7e3b47f9b7](https://github.com/wemake-services/wemake-python-package/tree/e1fcf312d7f715323dcff0d376a40b7e3b47f9b7). See what is [updated](https://github.com/wemake-services/wemake-python-package/compare/e1fcf312d7f715323dcff0d376a40b7e3b47f9b7...master) since then.\n",
"bytes": 11998,
"sha": "d9f413f6b508b849521853a3056081306475340169183af479cd516a1fbdba2d",
"repo_slug": "wemake-services/django-modern-rest",
"fonte": "repo",
"truncated": false,
"api": "https://api.agentalog.com/api/listings/skl_wemake_services_django_modern_rest_dmr_4a167c94/readme"
}
![\"Modern](\"https://raw.githubusercontent.com/wemake-services/django-modern-rest/master/docs/_static/images/logo-dark.svg\"){kind=logo}
\n ![\"Sync](\"docs/_static/images/benchmarks/sync-dark.svg\")
![\"Async](\"docs/_static/images/benchmarks/async-dark.svg\")