Sphinx extension for documenting Swagger 2.0 APIs
Project description
Sphinx extension for documenting Swagger 2.0 APIs
Usage
Include extension in conf.py
extensions = ['sphinxcontrib.swaggerdoc']
Add directive pointing to Swagger api-docs
.. swaggerv2doc:: URL/swagger.json
For example
.. swaggerv2doc:: http://petstore.swagger.io/v2/swagger.json
If the Swagger description contains multiple tags, you can select a subset for the documentation generation. For example, the following directive only generates the documentation for the methods contained in tags pet and store.
.. swaggerv2doc:: http://petstore.swagger.io/v2/swagger.json pet store
Note
The old directive for Swagger 1.0 is still usable. For example,
.. swaggerdoc:: http://petstore.swagger.wordnik.com/api/api-docs/pet .. swaggerdoc:: http://petstore.swagger.wordnik.com/api/api-docs/user .. swaggerdoc:: http://petstore.swagger.wordnik.com/api/api-docs/store
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Built Distribution
Close
Hashes for sphinxcontrib_swaggerdoc-0.1.3-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b9f820a680bfe32afb511d275216246dc1e7868d6986631dce2c96e2e3493be6 |
|
MD5 | dbd4bb67e58e3c1d5d33590a58a1724c |
|
BLAKE2-256 | 4858f3bcc970695d93f2981ef1ba623189798aa7449f5328ed3cc6ae76633dc5 |