This project is no longer being maintained. Please consider drf-yasg as an alternative/successor. I haven't personally used it, but it looks feature-complete and is actively maintained.
Full documentation: http://marcgibbons.github.io/django-rest-swagger/
pip install django-rest-swagger
rest_framework_swagger to your
INSTALLED_APPS = ( ... 'rest_framework_swagger', )
This package ships with two renderer classes:
OpenAPIRenderergenerates the OpenAPI (fka Swagger) JSON schema specification. This renderer will be presented if:
Content-Type: application/openapi+jsonis specified in the headers.
?format=openapiis passed as query param
SwaggerUIRenderergenerates the Swagger UI and requires the
from django.conf.urls import url from rest_framework_swagger.views import get_swagger_view schema_view = get_swagger_view(title='Pastebin API') urlpatterns = [ url(r'^$', schema_view) ]
$ toxto execute the test suite against all supported environments.
./runtests.pyto run the test suite within the current environment.
Please report bugs by opening an issue
Contributions are welcome and are encouraged!
Many thanks to Tom Christie & all the contributors who have developed Django REST Framework