Converter from Swagger JSON to Markdown.
Project description
Swagger is an open specification for documenting REST APIs in JSON or YAML. Imperfect as it is, it’s de facto a standard for many API developers.
This extension lets you render your swagger.json file as a Markdown document. You can customize the output by providing your own Jinja2 template.
Installation
$ pip install swagger2markdown
Usage
usage: swagger2markdown-script.py [-h] [-i SWAGGER_LOCATION] [-o OUTPUT]
[-t TEMPLATE]
optional arguments:
-h, --help show this help message and exit
-i SWAGGER_LOCATION, --input SWAGGER_LOCATION
path to or URL of the Swagger JSON file (default:
swagger.json)
-o OUTPUT, --output OUTPUT
path to the output Markdown file (default: swagger.md)
-t TEMPLATE, --template TEMPLATE
Jinja2 template used for conversion
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for swagger2markdown-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 24f03c11f890f6ea964395b798efb4a948832970cc5cd0b6c0c9802966e52e65 |
|
MD5 | 7e21f403a012ed8b88b27c4547764071 |
|
BLAKE2b-256 | dc245feb788fe9f94272cd9378fdc14be9920ca7ac52d445beca9ae313dcf51c |