Skip to content

jayvdb/openapi-toolset

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openapi-toolset

Openapi-toolset provides several useful tool to help you use OPENAPI.

Usuage

simple previewer

You can simpley preview a openapi doc file with this tool.

usage: simple-openapi-server [-h] [--bind ADDRESS] [--file FILE]
                             [--port [PORT]]

optional arguments:
  -h, --help            show this help message and exit
  --bind ADDRESS, -b ADDRESS
                        Specify alternate bind address [default: all
                        interfaces]
  --file FILE, -f FILE  OPENAPI doc file [default: openapi.yaml]
  --port [PORT], -p [PORT]
                        Specify alternate port [default: 8000]

django_plugin

  1. write api doc in CBV(class-based-view) docstring and genereate openapi doc for project;
  2. validate response content by api doc;
# genereate openapi doc
$ python demo/manage.py make_openapi_doc -f test.yaml
# preview genereated openapi doc
$ python demo/manage.py serve_openapi_doc -f test.yaml
erving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...

About

toolset to edit and preview openapi doc

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 84.4%
  • HTML 15.6%