Generate real Swagger/OpenAPI 2.0 specifications from a Django Rest
Framework API.
Features:
- full support for nested serializers and schemas
- response schemas and descriptions
- model definitions compatible with codegen tools
- customization hooks at all points in the spec generation process
- JSON and YAML format for spec
- bundles latest version of swagger-ui and redoc for viewing the generated
documentation
- schema view is cacheable out of the box
- generated Swagger schema can be automatically validated by
swagger-spec-validator or flex
- supports Django REST Framework API versioning with URLPathVersioning
and NamespaceVersioning (other DRF or custom versioning schemes are
not currently supported)
WWW: https://github.com/axnsan12/drf-yasg
===> The following configuration options are available for py38-dj32-drf-yasg-1.20.0:
VALIDATION=on: Enable built-in OpenAPI validation mechanisms
===> Use 'make config' to modify these settings
*/py-dj32-*: Deprecate/Set to expire
* The port net-mgmt/netbox was switched from Django 3.2 to Django 4.0
in d96a960530f3c20a9edd7837583ff7bec092566f.
Since then all the */py-dj32-* ports have no more consumers and all
the other Django ports have been switched to Django 3.2 in the last
few weeks. [1] Hence the py-dj32-* ports are redundant now.
Mark the py-dj32-* as deprecated and set an expiration to the end of
2022Q2 to get a clean 2022Q3 branch.
PR: 261313 [1]
*: Create Django 3.2 ports for net-mgmt/netbox
* Django 2.2 is currently the "default" version in the ports tree due
its long term support until April 2022. Thus ports that are assigned
to that version will exist until then.
The following ports are required to make the upgrade of
net-mgmt/netbox to the 2.11 release possible because it requires
Django 3.2. All of the ports listed below were created on the basis
of their respective original ports:
- devel/py-dj32-django-rq
- www/py-dj32-django-auth-ldap
- www/py-dj32-django-cacheops (updated to a newer release)
- www/py-dj32-django-cors-headers
(Only the first 15 lines of the commit message are shown above )