Skip to main content

Django REST Framework extras for better Swagger/OpenAPI self-documentation

Project description

drf-swagger-extras

Build Status Coverage Report Requirements Status

This package provides OpenAPI documentation Python decorators for Django REST Framework APIViews.

This module provides a patched SchemaGenerator that enhances current CoreAPI-based data that is grabbed by REST Framework with documentation provided by decorators found in this package.

We allow documenting different response types and formats, and each HTTP status code along with a schema and examples of the expected outcome.

We also provide optional API comments based on the function’s docstrings.

Usage

~ to be filled ~

Contributing

This project uses the GitHub Flow approach for contributing, meaning that we would really appreciate it if you would send patches as Pull Requests in GitHub. If for any reason you prefer to send patches by email, they are also welcome and will end up integrated here.

License

This code is released under a MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

drf-swagger-extras-0.1.0.dev1.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

drf_swagger_extras-0.1.0.dev1-py2.py3-none-any.whl (8.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file drf-swagger-extras-0.1.0.dev1.tar.gz.

File metadata

File hashes

Hashes for drf-swagger-extras-0.1.0.dev1.tar.gz
Algorithm Hash digest
SHA256 e5cfbc733a04bbedbf20fd98bb46e51549eeb035a92a965ddd6b2d956c986ded
MD5 ce971a7526302e88f35621864cae4313
BLAKE2b-256 99d398ebf34b52ebc97bc59cb2d4ce105e534f71c6af5f3c63f2ecc2242a4191

See more details on using hashes here.

File details

Details for the file drf_swagger_extras-0.1.0.dev1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for drf_swagger_extras-0.1.0.dev1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 353843caac3f061d1493245edf0e7fc5d40c8f8dea2dec4de0821da5dd8b3d34
MD5 16c34182f5987425a1431c8f1b48a555
BLAKE2b-256 9901a80586f1e52330c6ce63f01579f7794b3ff7771a0071b856def19ec7a5c4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page