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
133 Dec 27, 2022
7.8k Jan 05, 2023
2 Nov 25, 2021
47 Dec 28, 2022
1 Jan 22, 2022
435 Dec 29, 2022
4.3k Dec 31, 2022
3 May 03, 2022
1.3k Dec 29, 2022
4 May 23, 2022
10 May 20, 2022
470 Dec 28, 2022
266 Jan 02, 2023
16 Aug 09, 2022
21.3k Dec 28, 2022
11 Dec 19, 2022
1 Jun 18, 2022
831 Dec 27, 2022
12 Nov 16, 2022
6.7k Jan 05, 2023