PyPI |
---|
Linux | Windows |
---|---|
tornado-swagger: Swagger API Documentation builder for tornado server. Inspired by aiohttp-swagger package (based on this package sources).
Documentation | https://github.com/mrk-andreev/tornado-swagger/wiki |
---|---|
Code | https://github.com/mrk-andreev/tornado-swagger |
Issues | https://github.com/mrk-andreev/tornado-swagger/issues |
Python version | Python 3.6, 3.7, 3.8, nightly |
Swagger Language Specification | https://swagger.io/specification/v2/ |
pip install -U tornado-swagger
tornado-swagger is a plugin for tornado server that allow to document APIs using Swagger show the Swagger-ui console ( default url /api/doc).
class PostsDetailsHandler(tornado.web.RequestHandler):
def get(self, posts_id):
"""
---
tags:
- Posts
summary: Get posts details
description: posts full version
produces:
- application/json
parameters:
- name: posts_id
in: path
description: ID of post to return
required: true
type: string
responses:
200:
description: list of posts
schema:
$ref: '#/definitions/PostModel'
"""
- Fix handler args name parsing (
examples/args_recognize.py
). Thanks to [@reubinoff]
- Add
security
to setup. Thanks to @daominwang - Add black code formatter
- Update swagger-ui library to 3.37.2
- Add integrity attribute to script / link tags
- Remove Python 3.5 support
- Add display_models param to setup (
defaultModelsExpandDepth
). Thanks to @Sloknatos - Fix swagger-ui bundle CVE-2019-17495
- Specify supported python versions: 3.5, 3.6, 3.7, 3.8, nightly
- Fix issue with
StaticFileHandler
(mrk-andreev#28)
- Update dependencies
PyYAML==5.3.1
fix vulnerabilitiespytest==6.0.1
,pytest-flake8==1.0.6
fix test crash
- Fix "index out of range issue for StaticFileHandler" (mrk-andreev#23)
- Fix
\t
bug in Windows (mrk-andreev#21)
- Support wrapped methods
- Remove jinja2 from deps
- Replace local js/css to cdn
- Remove static files serving
- Swagger model definition
- Parameters filling in route path
- Schema definition
export_swagger(routes)
as public function- Update frontend
- First version released