在了解使用异步服务器Uvicorn
启动fastapi
之前,我们先看一下下面的一些知识点。
ASGI
在 Python3.5 之后增加 async/await
特性之后,异步编程变得异常火爆,越来越多开发者投入异步的怀抱。直到最近,Python 仍缺乏用于asyncio
框架的最低限度的低级服务器/应用程序接口。而 ASGI 协议规范的出现填补了这一空白,这意味着我们现在能够开始构建可在所有异步框架中使用的通用工具集。ASGI 帮助 Python 在 Web 框架上和Node.JS
及Golang
相竟争,目标是获得高性能的 IO 密集型任务,ASGI 作为异步网关协议接口,一个介于网络协议服务和 Python 应用之间的标准接口,能够处理多种通用的协议类型,包括HTTP
,HTTP2
和 WebSocket
。
ASGI(异步服务器网关接口)是WSGI的精神继承者,旨在在具有异步功能的Python Web服务器,框架和应用程序之间提供标准接口。
Uvicorn
Uvicorn
是一个快速的 ASGI 服务器,Uvicorn
是基于uvloop
和 httptools
构建的,是 Python 异步生态中重要的一员。
Uvicorn
当前支持 HTTP / 1.1
和 WebSockets
,将来计划支持HTTP / 2
。
什么是 uvloop 和 httptools ?
uvloop
用于替换标准库asyncio
中的事件循环,使用Cython
实现,它非常快,可以使asyncio
的速度提高 2-4 倍。
httptools
是 nodejs
HTTP 解析器 的 Python 实现。
Uvicorn使用方法
1 | pip install uvicorn |
创建一个文件 example.py
1 | async def app(scope, receive, send): |
启动Uvicorn
1 | uvicorn example:app |
也可以直接允许脚本
1 | import uvicorn |
使用uvicorn启动fastapi
我们直接看下代码
1 | import uvicorn |
我们看下run
方法的源码
我们看到You must pass the application as an import string to enable 'reload'
即如果我们想配置自动重新加载 需要将app
对象设置成字符串。
除此之外,我们还要看看should_reload
是什么:
1 |
|
不仅要设置app
为字符串,还要设置debug
或者reload
为True才能自动重新加载
因此最终的启动为:
1 | uvicorn.run(app='main:app', host="127.0.0.1", port=8000, reload=True, debug=True) |