Sphinx extension for documenting Swagger 2.0 APIs
Project description
Sphinx extension for documenting Swagger 2.0 APIs
pip install sphinxcontrib-swaggerdoc
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.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae616406c403e22464718db4b5e8e86871be79a1e04cc77d58be8b2afd757cce |
|
MD5 | 9656f12f28eaaaf8ae2c7bc1ab869ca7 |
|
BLAKE2-256 | 3339abf76303628e61a813cdfab64f07f4b7e6752223a23a451bbd218cabf2f6 |