FastAPI 介绍

意见
Typer, FastAPI的Cli
Requirements
安装
举例
举例升级
性能
可选依赖

英文原版文档: https://fastapi.tiangolo.com
源代码: https://github.com/tiangolo/fastapi
FastAPI是基于python3.6+和标准python类型的一个现代化的，快速的(高性能),构建api的web框架。
这是他的特点关键词:

Fast: 非常高的性能，媲美nodejs和go。可用的最快的Python框架之一.
Fast to Code 增加了200%~300%开发功能的速度
Fewer Buys 减少了40%的人为开发错误
Intuitive 伟大的编辑支持。减少了debug时间。
Easy 简单的使用和学习设计，减少了阅读文档的时间。
Short 减少代码重复，每个参数声明的多个特性，更少的错误。
Robust 获得生产就绪代码。自动交互文档。
Standards-based 基于开放的标准API: OpenAPI和JSON Schema

意见

Typer, FastAPI的Cli
如果你创建了一个CLI应用在终端使用代替一个web api，检查Typer.Typer是FastAPI的子集。它是CLIs的FastAPI。⌨️🚀

Requirements
Python 3.6+
FastAPI 站在巨人的肩膀上:
Starlette 提供web部分。
Pydantic 提供数据部分。

安装
```
pip install fastapi
```
你也将需要一个ASGI服务器，在生产环境中使用例如Uvicorn.
```
pip install uvicorn
```
举例

创建它

创建一个main.py文件:

from fastapi import FastAPI  
app = FastAPI()
@app.get("/")
def read_root():
  return {"Hello": "World"}  
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
  return {"item_id": item_id, "q": q}

启动它

终端运行: uvicorn main:app --reload
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [1969]
INFO:     Started server process [1971]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

检查它

打开浏览器，地址栏输入:http://127.0.0.1:8000/items/5?q=somequery.
你会看到一个json响应对象:

{"item_id": 5, "q": "somequery"}

你已经创建了一个API:

通过路径/和/items/{item_id}接收HTTP请求。
两个路径使用GET操作。
路径/items/{item_id}有一个路径参数item_id并且是个int。
路径/items/{item_id}有一个可操作性的str查询参数q.

交互式的API文档
现在浏览器进入 http://127.0.0.1:8000/docs。

替代API文档
现在，浏览器进入http://127.0.0.1:8000/redoc.
你将看到替代的自动文档.

举例升级
现在修改main.py文件来从一个PUT请求中接收数据。
使用python标准类型来声明主体，感谢Pydantic.
```
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class Item(BaseModel):
  name: str
  price: float
  is_offer: bool = None
@app.get("/")
def read_root():
  return {"Hello": "World"}
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
  return {"item_id": item_id, "q": q}
@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):
  return {"item_name": item.name, "item_id": item_id}
```
服务器会自动的重启(因为你添加了--reload参数给上面的uvicorn)。

交互式API文档更新
现在进入 http://127.0.0.1:8000/docs。
交互式文档会被自动更新，包含了新的部分。