SwaggerDoc
About
A swagger tool for tornado, using python to write api doc!
Installation
pip install swagger-doc
Quick Start
code
import tornado.ioloop
import tornado.web
from pydantic import Field
from swagger_doc import setup_swagger, swagger_doc, SResponse200, SResponse401, STag, SObject, SPath, SQuery, SBody
class SwaggerTag(STag):
home = "home"
class RequestPath(SPath):
__example__ = {"id": 111}
id: int = Field(description="id")
class RequestQuery(SQuery):
__example__ = {"page": 10}
page: int = Field(description="page")
class RequestBody(SBody):
__example__ = {"name": "lisi"}
name: str = Field(description="name")
class SuccessResp(SObject):
__example__ = {"code": "0"}
code: str = Field(description="response code")
class UnauthorizedResp(SObject):
__example__ = {"code": 401}
class MainHandler(tornado.web.RequestHandler):
@swagger_doc(
tags=[SwaggerTag.home],
summary="show home page",
query_params=RequestQuery,
path_params=RequestPath,
request_body=RequestBody,
responses=[SResponse200(body=SuccessResp), SResponse401(body=UnauthorizedResp)],
)
def post(self, id_):
self.write("Hello, world")
class AppWithSwagger(tornado.web.Application):
def __init__(self, routes, *args, **kwargs):
setup_swagger(
routes,
swagger_url="/docs",
openapi_url="/openapi.json",
description="",
api_version="1.0.0",
title="API DOCS.",
)
super().__init__(routes, *args, **kwargs)
def make_app():
return AppWithSwagger([(r"/(\d+)", MainHandler)])
if __name__ == "__main__":
app = make_app()
app.listen(8885)
print(f"docs: http://localhost:8885/docs")
tornado.ioloop.IOLoop.current().start()
Authroization
default account&password: swagger:swagger
Docs
Examples
see examples
TODO
- other response(only support json response currently)
- search bar
- ...
249 Dec 22, 2022
1 Nov 1, 2021
155 Sep 20, 2022
6 Apr 28, 2022
2 Apr 27, 2022
31 Dec 29, 2022
5 Jul 28, 2022
498 Dec 30, 2022
1.3k Dec 30, 2022
5.7k Jan 04, 2023
6 Nov 16, 2022
29 Dec 06, 2022
274 Jan 04, 2023
1 Feb 07, 2022
17 Aug 01, 2022
2 Jun 01, 2022
38 Nov 24, 2022
1.5k Jan 07, 2023
9 Oct 12, 2022
38 Feb 26, 2022
3 Oct 02, 2021
276 Jan 04, 2023
1 Dec 28, 2021
2.6k Jan 03, 2023
1.4k Dec 31, 2022
2 Jan 31, 2022
2 Dec 02, 2021
14 Dec 30, 2022
66 Jan 03, 2023