# django-aiodrf

> Awaitable Django REST framework views, serializers and policy hooks.

Paths are relative to llms.txt at the repository root. Read the limitations
and settings reference before selecting optional optimizations. Async views
do not make synchronous Django ORM operations native asynchronous I/O.

## Project

- [django-aiodrf](README.md)
- [Contributing](CONTRIBUTING.md)
- [AI-assisted contributions](AI_POLICY.md)
- [Release procedure](RELEASE.md)
- [Maintaining compatibility with Django and DRF](MAINTAINING.md)
- [Security policy](SECURITY.md)
- [Changelog](CHANGELOG.md)

## Documentation

- [django-aiodrf documentation](docs/README.md)
- [API reference](docs/api-reference.md)
- [Architectural comparison with ADRF](docs/architecture/adrf-comparison.md)
- [Architecture and integration boundaries](docs/architecture/alternatives.md)
- [ASGI composition for independent endpoints](docs/architecture/asgi-composition.md)
- [Hook bridges and override resolution](docs/architecture/bridge-pattern.md)
- [Package and API naming](docs/architecture/naming.md)
- [State ownership and internal helpers](docs/architecture/state-ownership.md)
- [Thread-boundary accounting](docs/architecture/thread-boundaries.md)
- [django-aiodrf framework design](docs/framework_design.md)
- [Native async ORM (`aiodrf.contrib.async_backend`)](docs/guides/async-backend.md)
- [Async caching](docs/guides/async-cache.md)
- [Async NoSQL: MongoDB, Elasticsearch and OpenSearch](docs/guides/async-nosql.md)
- [Working with async views and transactions](docs/guides/async-transactions.md)
- [Application best practices](docs/guides/best-practices.md)
- [Cache connection resilience](docs/guides/cache-resilience.md)
- [Compatibility with DRF](docs/guides/compatibility.md)
- [Concurrent item representation (experimental contrib)](docs/guides/concurrent-serialization.md)
- [CPU-bound work in async applications](docs/guides/cpu-work.md)
- [Deployment behaviour](docs/guides/deployment-validation.md)
- [Deployment](docs/guides/deployment.md)
- [Integrating aiodrf into a DRF project](docs/guides/drf-integration.md)
- [Third-party packages](docs/guides/ecosystem.md)
- [Extension hooks and async boundaries](docs/guides/extension-hooks.md)
- [Django fetch modes](docs/guides/fetch-modes.md)
- [HTTP QUERY](docs/guides/http-query.md)
- [Request execution and compatibility boundaries](docs/guides/implementation.md)
- [Managed ASGI resources](docs/guides/lifespan.md)
- [Async management commands](docs/guides/management-commands.md)
- [Migrating from adrf](docs/guides/migration-from-adrf.md)
- [Migrating from DRF](docs/guides/migration-from-drf.md)
- [msgspec and pydantic](docs/guides/msgspec-pydantic.md)
- [Measuring performance](docs/guides/performance.md)
- [Prefetching for list representation (`aiodrf.contrib.builtin.list_prefetch`)](docs/guides/prefetch.md)
- [Versioning and compatibility](docs/guides/releasing.md)
- [Selective serializer optimization](docs/guides/serializer-optimization.md)
- [Static files under ASGI](docs/guides/static-files.md)
- [Streaming through Nginx](docs/guides/stream-proxies.md)
- [Documenting SSE and NDJSON items](docs/guides/streaming-schema.md)
- [Tasks on Django 5 and Django 6](docs/guides/tasks.md)
- [Testing aiodrf applications](docs/guides/testing.md)
- [The tuned profile](docs/guides/tuned-profile.md)
- [Tuning](docs/guides/tuning.md)
- [Optional synchronous middleware grouping](docs/guides/unsafe-middleware.md)
- [Choosing an ASGI web server](docs/guides/web-servers.md)
- [System checks](docs/reference/checks.md)
- [Contrib dependencies and upstream documentation](docs/reference/contrib-dependencies.md)
- [Ecosystem test versions](docs/reference/ecosystem-versions.md)
- [Limitations](docs/reference/limitations.md)
- [Runtime adaptations](docs/reference/runtime-adaptations.md)
- [Serializer data types](docs/reference/serializer-type-coverage.md)
- [Settings reference](docs/reference/settings.md)
- [Upstream internals aiodrf reads](docs/reference/upstream-internals.md)
- [Roadmap](docs/roadmap.md)

## Examples

- [Running examples with Docker](examples/CONTAINERS.md)
- [Django and ecosystem example coverage](examples/ECOSYSTEM.md)
- [Feature evaluation and example coverage](examples/FEATURES.md)
- [aiodrf examples](examples/README.md)
- [Async hooks and DRF coexistence](examples/basics/README.md)
- [Bookshop: an example project on aiodrf](examples/bookshop/README.md)
- [CRUD, filters and pagination](examples/crud/README.md)
- [Django built-in services](examples/django-builtin/README.md)
- [Serializer and representation integrations](examples/ecosystem-data/README.md)
- [Middleware, diagnostics and application services](examples/ecosystem-platform/README.md)
- [Authentication, object permissions and audit records](examples/ecosystem-security/README.md)
- [Brokers, storage, search and error reporting](examples/ecosystem-services/README.md)
- [Typed resources and async commands](examples/lifespan/README.md)
- [Batched and bounded-concurrent enrichment](examples/list-enrichment/README.md)
- [Explicit middleware scheduling experiment](examples/middleware-experiment/README.md)
- [Isolated ADRF import compatibility and codemod](examples/migration/README.md)
- [MongoDB model serialization](examples/mongodb/README.md)
- [Opt-in native PostgreSQL ORM](examples/native-postgres/README.md)
- [Authentication, permissions, caching and QUERY](examples/policies/README.md)
- [DRF fields, compilers and tuned profiles](examples/serializer-backends/README.md)
- [NDJSON, JSON arrays and server-sent events](examples/streaming/README.md)
- [Django 5 task enqueue](examples/tasks-django5/README.md)
- [Django 6 task enqueue](examples/tasks-django6/README.md)
- [Application-owned OpenTelemetry](examples/telemetry/README.md)
- [PostgreSQL tenant schemas](examples/tenancy/README.md)
- [Typed inputs, partial updates and OpenAPI](examples/typed-schemas/README.md)
- [Multipart uploads and storage ownership](examples/uploads/README.md)
- [SimpleJWT, Knox and auth-kit](examples/vendor-authentication/README.md)
