Python利用fastapi实现上传文件

 更新时间:2022年06月23日 11:02:54   作者:小飞牛  
FastAPI是一个现代的,快速(高性能)python web框架。本文将利用fastapi实现上传文件功能,文中的示例代码讲解详细,需要的可以参考一下

使用File实现文件上传

使用Form表单上传文件,fastapi使用File获取上传的文件。

指定了参数类型是bytes:file: bytes = File(),此时会将文件内容全部读取到内存,比较适合小文件。

使用File需要提前安装 python-multipart

from fastapi import FastAPI, File
 ​
app = FastAPI()
 ​
@app.post("/files/")
async def create_file(file: bytes = File()):
   return {"file_size": len(file)}

只要在路径操作函数中声明了变量的类型是bytes且使用了File,则fastapi会将上传文件的内容全部去读到参数中。

使用UploadFile实现文件上传

对于大文件,不适合将文件内容全部读取到内存中,此时使用UploadFile

from fastapi import FastAPI, UploadFile
 ​
app = FastAPI()
 ​
@app.post("/uploadfile/")
async def create_upload_file(file: UploadFile):
     return {"filename": file.filename}

bytes相比,使用UploadFile有如下好处:

  • 不需要在使用File()作为路径操作函数中参数的默认值
  • 不会把文件内容全部加载到内存中,而是批量读取一定量的数据,边读边存硬盘。
  • 可以获取文件的元数据。
  • 该类型的变量可以像文件变量一样操作。

UploadFile的属性

  • filename:类型是str,用来获取文件的名字,比如:myimage.png
  • content_type: 类型是str, 用来获取文件的类型,比如:image/png
  • file: 类文件对象,是一个标准的python文件对象

除了这四个基础属性外,UploadFile还有三个async方法:

  • write, 将str或者bytes写到文件中
  • read: 读文件
  • seek: 移动光标
  • close: 关闭文件
 # 获取文件内容
 contents = await myfile.read()

设置上传文件是可选的

设置默认值是None即可

 from typing import Union
 ​
 from fastapi import FastAPI, File, UploadFile
 ​
 app = FastAPI()
 ​
 ​
 @app.post("/files/")
 async def create_file(file: Union[bytes, None] = File(default=None)):
     if not file:
         return {"message": "No file sent"}
     else:
         return {"file_size": len(file)}
 ​
 ​
 @app.post("/uploadfile/")
 async def create_upload_file(file: Union[UploadFile, None] = None):
     if not file:
         return {"message": "No upload file sent"}
     else:
         return {"filename": file.filename}

上传多个文件

参数的参数的类型是列表:列表元素是bytes或者UploadFile

 from typing import List
 ​
 from fastapi import FastAPI, File, UploadFile
 ​
 app = FastAPI()
 ​
 ​
 @app.post("/files/")
 async def create_files(files: List[bytes] = File()):
     return {"file_sizes": [len(file) for file in files]}
 ​
 ​
 @app.post("/uploadfiles/")
 async def create_upload_files(files: List[UploadFile]):
     return {"filenames": [file.filename for file in files]}

知识点补充

1.FastAPI简介

FastAPI是什么

FastAPI是一个现代的,快速(高性能)python web框架。基于标准的python类型提示,使用python3.6+构建API的Web框架。

FastAPI的主要特点如下:

  • 快速:非常高的性能,与NodeJS和Go相当(这个要感谢Starlette和Pydantic),是最快的Python框架之一。
  • 快速编码:将开发速度提高约200%到300%。
  • 更少的bug:减少大约40%的开发人员人为引起的错误。
  • 直观:强大的编辑器支持,调试时间更短。
  • 简单:易于使用和学习。减少阅读文档的时间。
  • 代码简洁:尽量减少代码重复。每个参数可以声明多个功能,减少程序的bug。
  • 健壮:生产代码会自动生成交互式文档。
  • 基于标准:基于并完全兼容API的开放标准:OpenAPI和JSON模式。

FastAPI 站在巨人的肩膀上:

  • Starlette 用于构建 Web 部件。
  • Pydantic 用于数据部分。

环境准备

安装fastapi

pip install fastapi

对于生产环境,还需要一个ASGI服务器,如Uvicorn或Hypercorn

pip install "uvicorn[standard]"

入门示例程序

新建一个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 [28720]
INFO: Started server process [28722]
INFO: Waiting for application startup.
INFO: Application startup complete.

到此这篇关于Python利用fastapi实现上传文件的文章就介绍到这了,更多相关Python fastapi上传文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 用python 批量更改图像尺寸到统一大小的方法

    用python 批量更改图像尺寸到统一大小的方法

    下面小编就为大家分享一篇用python 批量更改图像尺寸到统一大小的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • Python接口测试数据库封装实现原理

    Python接口测试数据库封装实现原理

    这篇文章主要介绍了Python接口测试数据库封装实现原理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-05-05
  • Python实现读取并保存文件的类

    Python实现读取并保存文件的类

    这篇文章主要介绍了Python实现读取并保存文件的类,涉及Python针对文件的读写操作相关实现技巧,需要的朋友可以参考下
    2017-05-05
  • python设置环境变量的作用整理

    python设置环境变量的作用整理

    在本篇文章里小编给大家整理的是关于python设置环境变量的作用整理内容,需要的朋友们可以学习参考下。
    2020-02-02
  • Python实现输出程序执行进度百分比的方法

    Python实现输出程序执行进度百分比的方法

    这篇文章主要介绍了Python实现输出程序执行进度百分比的方法,涉及Python数值运算与系统输出相关操作技巧,需要的朋友可以参考下
    2017-09-09
  • 详解PANDAS 数据合并与重塑(join/merge篇)

    详解PANDAS 数据合并与重塑(join/merge篇)

    这篇文章主要介绍了详解PANDAS 数据合并与重塑(join/merge篇),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-07-07
  • 详解Python中的join()函数的用法

    详解Python中的join()函数的用法

    这篇文章主要介绍了详解Python中的join()函数的用法,join()函数主要用来拼接字符串,是Python学习当中的基础知识,需要的朋友可以参考下
    2015-04-04
  • 如何提高python 中for循环的效率

    如何提高python 中for循环的效率

    这篇文章主要介绍了如何提高python 中for循环的效率,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-04-04
  • 结合OpenCV与TensorFlow进行人脸识别的实现

    结合OpenCV与TensorFlow进行人脸识别的实现

    这篇文章主要介绍了结合OpenCV与TensorFlow进行人脸识别的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • 使用pandas中的DataFrame数据绘制柱状图的方法

    使用pandas中的DataFrame数据绘制柱状图的方法

    下面小编就为大家分享一篇使用pandas中的DataFrame数据绘制柱状图的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-04-04

最新评论