dhddlmZmZmZmZmZmZmZmZm Z ddl m Z m Z m Z ddlmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZmZGd d eZGd dZedZdedefdZy)) AnyBinaryIOCallableDictIterableOptionalTypeTypeVarcast) CoreSchemaGetJsonSchemaHandlerJsonSchemaValue)URL)Address)FormData)Headers) QueryParams)State) UploadFile) AnnotatedDocc>eZdZUdZeeedfed<eee edfed<eee edfed<ee edfed <eee ed fed <d ee ed fddffd Z d&dee edfde ffd Zdee edfddffd Zd'fd ZededdeedeffdZededdedefdZedededdfdZedee efddfd Zed!ed"edefd#Zed$eed"eegefdefd%ZxZ S)(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).filezThe 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. returnNc>Kt||d{S7w)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__s I/var/www/zara/venv/lib/python3.12/site-packages/fastapi/datastructures.pyr"zUploadFile.writeIs$W]4(((( zL The number of bytes to read from the file. c>Kt||d{S7w)z| Read some bytes from the file. To be awaitable, compatible with async, this is run in threadpool. N)r!read)r#rr$s r%r(zUploadFile.read]s W\$''''r&offsetzO The position in bytes to seek to in the file. c>Kt||d{S7w)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)r!seek)r#r)r$s r%r+zUploadFile.seekos$W\&))))r&c<Kt|d{S7w)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)r!close)r#r$s r%r-zUploadFile.closes W]_$$$s cls.c#(K|jywN)validate)r.s r%__get_validators__zUploadFile.__get_validators__sllsvcTt|tstdt||SNzExpected UploadFile, received: ) isinstanceStarletteUploadFile ValueErrortype)r.r3s r%r1zUploadFile.validates)!01>tAwiHI I_UploadFile__input_value_cpt|tstdt|t t |Sr5)r6r7r8r9r r)r.r;r<s r% _validatezUploadFile._validates3-)<=>tM?R>STU UJ ..r: field_schemac,|jdddyNstringbinary)r9format)update)r.r?s r%__modify_schema__zUploadFile.__modify_schema__sXBCr: core_schemahandlerc dddSrA)r.rGrHs r%__get_pydantic_json_schema__z'UploadFile.__get_pydantic_json_schema__s!H55r:sourcec2ddlm}||jS)N)"with_info_plain_validator_function) _compat.v2rOr>)r.rLrHrOs r%__get_pydantic_core_schema__z'UploadFile.__get_pydantic_core_schema__s C1#--@@r:))rN)!__name__ __module__ __qualname____doc__rrr__annotations__rstrintrbytesr"r(r+r- classmethodr rrrr2r1r>rrFr r rrKrQ __classcell__)r$s@r%rrsXB  :; =  s+D'EEFF HSM3'G#HH II w$A BB CC sOPP)     ) ): (     ( ($*     * *(%\ 2xc@R7Sd<(SS /c/c/l// DT#s(^DDD6$6/C6 66 A#YA)13%2C)DA AAr:rc8eZdZdZdefdZdefdZdedefdZ y) 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. valuec||_yr0r_)r#r_s r%__init__zDefaultPlaceholder.__init__s  r:rc,t|jSr0)boolr_)r#s r%__bool__zDefaultPlaceholder.__bool__sDJJr:ocXt|txr|j|jk(Sr0)r6r^r_)r#rfs r%__eq__zDefaultPlaceholder.__eq__s"!/0JQWW 5JJr:N) rSrTrUrVrrbrdreobjectrhrJr:r%r^r^s5c $ KK4Kr:r^ DefaultTyper_rct|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. )r^ras r%Defaultrls e $$r:N)typingrrrrrrr r r fastapi._compatr r rstarlette.datastructuresrrrrrrrr7typing_extensionsrrr^rjrlrJr:r%rqsu    0797?3F,PA$PAfKK$m$ %;%;%r: