A python package which converts apidoc comments in various languages to OpenApi Spec .json files.
Apidoc syntax is very easy and lightweight, whereas Openapi aka Swagger syntax is very verbose and not noob friendly. The goal of this project is to make documenting api endpoints so easy that developers won't mind spending the time to do it, instead of just ignoring documentation.
Apidoc conversion coverage
@api @apiName @apiGroup @apiParam @apiSuccess
Feel free to PR in any other annotations you need.
pip install apidoc-to-openapi
usage: apidoc_to_openapi [-h] -i path [-o path] [--yaml] optional arguments: -h, --help show this help message and exit -o path File output (default: stdout) --yaml Convert output to yaml format Required: -i path File or directory containing apidoc annotations
apidoc-to-openapi -i ./my/path/ -o ./my/path/swagger.yaml --yaml
Running the tests
Used pytest for testing. Test coverage isn't near where I want it to be.
Using black formatter and pylint
- Graham Thomas - Initial work
This project is licensed under the MIT License - see the LICENSE.md file for details
- I have no friends
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size apidoc_to_openapi-0.0.2-py3-none-any.whl (15.2 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size apidoc_to_openapi-0.0.2.tar.gz (8.6 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for apidoc_to_openapi-0.0.2-py3-none-any.whl