generate OpenAPI document and validate request&response with Python annotations.
Project description
Spectree
Yet another library to generate OpenAPI document and validate request & response with Python annotations.
Features
- Less boilerplate code, annotations are really easy-to-use :sparkles:
- Generate API document with Redoc UI or Swagger UI :yum:
- Validate query, JSON data, response data with pydantic :wink:
- Current support:
- Flask
- Falcon
- Starlette
Quick Start
install with pip: pip install spectree
Demo
Step by Step
- Define your data structure with
pydantic.BaseModel
- create
spectree.SpecTree
instance with the web framework name you are usingapi = SpecTree('flask')
validate
the routequery
json
headers
cookies
resp
tags
- access these data with
context(query, json, headers, cookies)
- flask:
request.context
- falcon:
req.context
- starlette:
request.context
- flask:
- register to the web application
api.register(app)
- check the document at URL location
/apidoc/redoc
or/apidoc/swagger
Examples
Check the examples folder.
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
spectree-0.1.0.tar.gz
(11.7 kB
view hashes)
Built Distribution
spectree-0.1.0-py3-none-any.whl
(14.3 kB
view hashes)