o biV@sddlmZmZddlmZmZmZmZmZddl m Z ddl m Z ddl mZddl mZddl mZddl mZdd l mZdd l mZdd l mZGd d d eZGdddZedZdedefddZdS))CallableMapping) AnnotatedAnyBinaryIOTypeVarcast)Doc)GetJsonSchemaHandler)URL)Address)FormData)Headers) QueryParams)State) UploadFilec szeZdZUdZeeedfed<eedBedfed<ee dBedfed<ee ed fed <eedBed fed <d ee edfddffdd Z d'dee edfde ffdd Z dee edfddffdd Zd(fdd ZedededdfddZed eeefd!edeeeffd"d#Zed$eed!eegeeeffdeeeffd%d&ZZS))raA A file uploaded in a request. Define it as a *path operation function* (or dependency) parameter. If you are using a regular `def` function, you can use the `upload_file.file` attribute to access the raw standard Python file (blocking, not async), useful and needed for non-async code. Read more about it in the [FastAPI docs for Request Files](https://fastapi.tiangolo.com/tutorial/request-files/). ## Example ```python 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} ``` z,The standard Python file object (non-async).fileNzThe original file name.filenamezThe size of the file in bytes.sizezThe headers of the request.headersz2The content type of the request, from the headers. content_typedatazA The bytes to write to the file. returnct|IdHS)z 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. N)superwrite)selfr __class__X/sda-disk/www/egybert/egybert_env/lib/python3.10/site-packages/fastapi/datastructures.pyrBzUploadFile.writezL The number of bytes to read from the file. cr)z| Read some bytes from the file. To be awaitable, compatible with async, this is run in threadpool. N)rread)rrrrr r#VszUploadFile.readoffsetzO The position in bytes to seek to in the file. cr)z 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. N)rseek)rr$rrr r%hr!zUploadFile.seekcstIdHS)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)rcloserrrr r&|szUploadFile.close_UploadFile__input_value_cCs&t|tstdt|tt|S)NzExpected UploadFile, received: ) isinstanceStarletteUploadFile ValueErrortyperr)clsr(r)rrr _validates  zUploadFile._validate core_schemahandlercCs dddS)Nstringzapplication/octet-stream)r-contentMediaTyper)r.r0r1rrr __get_pydantic_json_schema__s z'UploadFile.__get_pydantic_json_schema__sourcecCsddlm}||jS)N)"with_info_plain_validator_function) _compat.v2r7r/)r.r5r1r7rrr __get_pydantic_core_schema__s  z'UploadFile.__get_pydantic_core_schema__)r")rN)__name__ __module__ __qualname____doc__rrr __annotations__strintrbytesrr#r%r& classmethodrr/rr dictr4r-rr9 __classcell__rrrr rs !       rc@s>eZdZdZdefddZdefddZdedefd d Z d S) DefaultPlaceholderz You shouldn't use this class directly. It's used internally to recognize when a default value has been overwritten, even if the overridden default value was truthy. valuecCs ||_dSNrF)rrFrrr __init__ zDefaultPlaceholder.__init__rcCs t|jSrG)boolrFr'rrr __bool__rJzDefaultPlaceholder.__bool__ocCst|to |j|jkSrG)r*rErF)rrMrrr __eq__szDefaultPlaceholder.__eq__N) r:r;r<r=rrIrKrLobjectrNrrrr rEs rE DefaultTyperFrcCst|S)z You shouldn't use this function directly. It's used internally to recognize when a default value has been overwritten, even if the overridden default value was truthy. )rErHrrr DefaultsrQN)collections.abcrrtypingrrrrr annotated_docr pydanticr starlette.datastructuresr r r rrrrr+rErPrQrrrr s