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 a remote Swagger api-docs
.. swaggerv2doc:: URL/swagger.json
or to a local file
.. swaggerv2doc:: file:///PATH/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.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35dfbc042cb01f97e683d2739075469a5ca72e610a8aa10521daa986f4fa17e9 |
|
MD5 | b416ab7c2c784d9dd58bf30c39bdcc50 |
|
BLAKE2-256 | dcd31ee29015733858eb5260b9f015a048a75da570a2b5176815f0af13f2a264 |