Swagger API Documentation builder for tornado server
Project description
tornado-swagger
PyPI | Anaconda |
---|---|
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.5 and above |
Swagger Language Specification | https://swagger.io/specification/v2/ |
Installation
pip install -U tornado-swagger
conda install -c mrk.andreev tornado-swagger
What's 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'
"""
What's new?
Version 1.2.4
- Fix "index out of range issue for StaticFileHandler" (https://github.com/mrk-andreev/tornado-swagger/issues/23)
Version 1.2.3
- Fix
\t
bug in Windows (https://github.com/mrk-andreev/tornado-swagger/issues/21)
Version 1.2.1
- Support wrapped methods
- Remove jinja2 from deps
Version 1.2.0
- Replace local js/css to cdn
- Remove static files serving
Version 1.1.0
- Swagger model definition
- Parameters filling in route path
- Schema definition
export_swagger(routes)
as public function- Update frontend
Version 1.0.0
- First version released
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tornado-swagger-1.2.4.tar.gz
(7.0 kB
view hashes)
Built Distribution
Close
Hashes for tornado_swagger-1.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06e056a57981b788018b1877d9f5d33542327b0548a874f3c1dbf31eac8052e8 |
|
MD5 | 6d9393b5dafe7e266c42103e67e25f4f |
|
BLAKE2b-256 | 4bc44c8d27b1ff50ca058a9b32f7a01f0c18310f59709cf1a08e49f540e72613 |