FastAPI--快速入门(1)

发布时间:2020-06-18 09:41:30编辑:admin阅读(3965)

    一、简介

    FastAPI 是一个高性能 Web 框架,用于构建 API。

    主要特性:

    • 快速:非常高的性能,与 NodeJS 和 Go 相当

    • 快速编码:将功能开发速度提高约 200% 至 300%

    • 更少的错误:减少约 40% 的人为错误

    • 直观:强大的编辑器支持,自动补全无处不在,调试时间更少

    • 简易:旨在易于使用和学习,减少阅读文档的时间。

    • 简短:减少代码重复。

    • 稳健:获取可用于生产环境的代码,具有自动交互式文档

    • 基于标准:基于并完全兼容 API 的开放标准 OpenAPI 和 JSON Schema

     

    官方链接:https://fastapi.tiangolo.com/

     

    二、第一个Hello World

    注意事项,因为FastAPI仅支持Python3.6+的API,所以需要再Python3.6+的环境进行学习实践!

    安装依赖

    FastAPI - 是一个现代的,快速(高性能)python web框架

    pip3 install fastapi

    uvicorn - 主要用于加载和提供应用程序的服务器.

    pip3 install uvicorn

     

    Hello World

    main.py

    import uvicorn
    from fastapi import FastAPI
    
    app = FastAPI()
    
    @app.get("/")
    async def root():
        return {"message": "Hello World"}
    
    if __name__ == '__main__':
        uvicorn.run(app='main:app', host="127.0.0.1", port=8000, reload=True, debug=True)

    参数解释:

    app = FastAPI() 用于实例化 FastAPI类,通常app这个变量会设置成全局的,至少在当前模块作用域有效。

    @app.get("/") 是一个装饰器,在这里的作用是将普通的Python函数变成一个get请求接口 ("/")表示url是根目录主页。

     至于函数里的代码就很好理解了,定义了一个函数,然后return 了一个字典,表示接口被访问时默认会返回一个JSON格式的数据回去(当然也可以return别的数据格式,例如字符串、列表等)。

    uvicorn.run(app='main:app', host="127.0.0.1", port=8000, reload=True, debug=True)

    表示使用uvicorn启动当前目录下main.py这个文件里的app实例

    reload=True的意思是文件内容变更后自动重启服务,便于开发调试。

     

    启动程序,使用pycharm启动,或者在命令行模式下启动

    python3 main.py

     

    访问首页

    http://127.0.0.1:8000/

     

    效果如下:

    1.png

     

     

    API文档交互

    http://127.0.0.1:8000/docs

    你将会看到自动生成的API交互文档(由 Swagger UI提供):

    1.png

     

     

    可选的API文档

    http://127.0.0.1:8000/redoc

     

    你将会看到自动生成的可选的API文档(由(provided by ReDoc提供):

    1.png

     

     

     

    本文参考链接:

    http://www.zyiz.net/tech/detail-119883.html

    https://www.jianshu.com/p/94710ed35b92

     


关键字

上一篇: LVS+Keepalive双机热备

下一篇: FastAPI--路由(2)