UploadFile クラス

リクエストからファイルを受け取るには、パス操作関数のパラメータをUploadFile型として定義できます。

fastapiから直接インポートできます。

from fastapi import UploadFile

fastapi.UploadFile

UploadFile(file, *, size=None, filename=None, headers=None)

ベース: UploadFile

リクエストでアップロードされたファイル。

パス操作関数 (または依存関係) のパラメーターとして定義します。

通常の def 関数を使用している場合、upload_file.file 属性を使用して生の標準 Python ファイル (ブロッキング、非同期ではない) にアクセスできます。これは非同期ではないコードに役立ち、必要とされます。

FastAPI ドキュメントの Request Files で詳細をご覧ください。

例

from typing import Annotated

from fastapi import FastAPI, File, UploadFile

app = FastAPI()


@app.post("/files/")
async def create_file(file: Annotated[bytes, File()]):
    return {"file_size": len(file)}


@app.post("/uploadfile/")
async def create_upload_file(file: UploadFile):
    return {"filename": file.filename}

starlette/datastructures.py のソースコード

def __init__(
    self,
    file: typing.BinaryIO,
    *,
    size: int | None = None,
    filename: str | None = None,
    headers: Headers | None = None,
) -> None:
    self.filename = filename
    self.file = file
    self.size = size
    self.headers = headers or Headers()

file instance-attribute

file

標準 Python ファイルオブジェクト (非同期ではない)。

filename instance-attribute

filename

元のファイル名。

size instance-attribute

size

ファイルのサイズ (バイト単位)。

headers instance-attribute

headers

リクエストのヘッダー。

content_type instance-attribute

content_type

ヘッダーからのリクエストのコンテンツタイプ。

read async

read(size=-1)

ファイルからバイトを読み取ります。

await可能で非同期と互換性があるように、これはスレッドプールで実行されます。

パラメータ	説明
サイズ	ファイルから読み取るバイト数。 TYPE: int DEFAULT: -1

fastapi/datastructures.py のソースコード

async def read(
    self,
    size: Annotated[
        int,
        Doc(
            """
            The number of bytes to read from the file.
            """
        ),
    ] = -1,
) -> bytes:
    """
    Read some bytes from the file.

    To be awaitable, compatible with async, this is run in threadpool.
    """
    return await super().read(size)

write async

write(data)

ファイルにバイトを書き込みます。

通常、リクエストで読み込んだファイルからこれを使用することはありません。

await可能で非同期と互換性があるように、これはスレッドプールで実行されます。

パラメータ	説明
データ	ファイルに書き込むバイト。 TYPE: bytes

fastapi/datastructures.py のソースコード

async def write(
    self,
    data: Annotated[
        bytes,
        Doc(
            """
            The bytes to write to the file.
            """
        ),
    ],
) -> None:
    """
    Write some bytes to the file.

    You normally wouldn't use this from a file you read in a request.

    To be awaitable, compatible with async, this is run in threadpool.
    """
    return await super().write(data)

seek async

seek(offset)

ファイル内の位置に移動します。

次回の読み取りまたは書き込みは、その位置から行われます。

await可能で非同期と互換性があるように、これはスレッドプールで実行されます。

パラメータ	説明
オフセット	ファイル内でシークするバイト単位の位置。 TYPE: int

fastapi/datastructures.py のソースコード

async def seek(
    self,
    offset: Annotated[
        int,
        Doc(
            """
            The position in bytes to seek to in the file.
            """
        ),
    ],
) -> None:
    """
    Move to a position in the file.

    Any next read or write will be done from that position.

    To be awaitable, compatible with async, this is run in threadpool.
    """
    return await super().seek(offset)

close async

close()

ファイルを閉じます。

await可能で非同期と互換性があるように、これはスレッドプールで実行されます。

fastapi/datastructures.py のソースコード

async def close(self) -> None:
    """
    Close the file.

    To be awaitable, compatible with async, this is run in threadpool.
    """
    return await super().close()