-DiddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z mZmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZGd d eZGddZedZdedefdZy))Iterable) AnnotatedAnyBinaryIOCallableOptionalTypeVarcast)Doc) CoreSchemaGetJsonSchemaHandlerJsonSchemaValue)URL)Address)FormData)Headers) QueryParams)State) UploadFilec>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 Y/var/www/html/backtest/python_venv/lib/python3.12/site-packages/fastapi/datastructures.pyr zUploadFile.writeHs$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)rread)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)rseek)r!r'r"s r#r)zUploadFile.seekns$W\&))))r$c<Kt|d{S7w)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)rclose)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,r1s r#r/zUploadFile.validates)!01>tAwiHI I_UploadFile__input_value_cpt|tstdt|t t |Sr3)r4r5r6r7r r)r,r9r:s r# _validatezUploadFile._validates3-)<=>tM?R>STU UJ ..r8 field_schemac,|jdddyNstringbinary)r7format)update)r,r=s r#__modify_schema__zUploadFile.__modify_schema__sXBCr8 core_schemahandlerc dddSr?)r,rErFs r#__get_pydantic_json_schema__z'UploadFile.__get_pydantic_json_schema__s!H55r8sourcec2ddlm}||jS)N)"with_info_plain_validator_function) _compat.v2rMr<)r,rJrFrMs r#__get_pydantic_core_schema__z'UploadFile.__get_pydantic_core_schema__s C1#--@@r8))rN)!__name__ __module__ __qualname____doc__rrr __annotations__rstrintrbytesr r&r)r+ classmethodr7rrrr0r/r<dictrDr r rrIrO __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 AAr8rc8eZdZdZdefdZdefdZdedefdZ 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||_yr.r^)r!r^s r#__init__zDefaultPlaceholder.__init__s  r8rc,t|jSr.)boolr^)r!s r#__bool__zDefaultPlaceholder.__bool__sDJJr8ocXt|txr|j|jk(Sr.)r4r]r^)r!res r#__eq__zDefaultPlaceholder.__eq__s"!/0JQWW 5JJr8N) rQrRrSrTrrarcrdobjectrgrHr8r#r]r]s5c $ KK4Kr8r] 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]r`s r#Defaultrks e $$r8N)collections.abcrtypingrrrrrr r annotated_docr fastapi._compatr r rstarlette.datastructuresrrrrrrrr5r]rirkrHr8r#rqsz$ 0797?3FPA$PAfKK$m$ %;%;%r8