Sane and flexible OpenAPI 3.0 schema generation for Django REST framework.
This project has 3 goals:
Extract as much schema information from DRF as possible.
Provide flexibility to make the schema usable in the real world (not only toy examples).
Generate a schema that works well with the most popular client generators.
The code is a heavily modified fork of the
DRF OpenAPI generator,
which is/was lacking all of the below listed features.
Features
Serializers modelled as components. (arbitrary nesting and recursion supported)
@extend_schema decorator for customization of APIView, Viewsets, function-based views, and @action
additional parameters
request/response serializer override (with status codes)
polymorphic responses either manually with PolymorphicProxySerializer helper or via rest_polymorphics PolymorphicSerializer)
and more customization options
Authentication support (DRF natives included, easily extendable)
Custom serializer class support (easily extendable)
Ser
|