9CgddlmZmZmZmZmZmZmZmZm Z ddl m Z m Z m Z mZmZddlmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZmZGd d eZGd dZedZdedefdZdS)) AnyBinaryIOCallableDictIterableOptionalTypeTypeVarcast) PYDANTIC_V2 CoreSchemaGetJsonSchemaHandlerJsonSchemaValue"with_info_plain_validator_function)URL)Address)FormData)Headers) QueryParams)State) UploadFile) AnnotatedDocceZdZUdZeeedfed<eee edfed<eee edfed<ee edfed <eee ed fed <d ee ed fddffd Z d'dee edfde ffd Zdee edfddffd Zd(fd ZededdeedeffdZededdedefdZedededdfdZesed ee efddfd!Zed"ed#edefd$Zed%eed#eegefdefd&Z xZ!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. returnNcVKt|d{VS)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 H/var/www/api/venv/lib/python3.11/site-packages/fastapi/datastructures.pyr$zUploadFile.writeKs1$WW]]4(((((((((zL The number of bytes to read from the file. cVKt|d{VS)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_s1 WW\\$'''''''''r(offsetzO The position in bytes to seek to in the file. cVKt|d{VS)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.seekqs1$WW\\&)))))))))r(cTKtd{VS)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)r#close)r%r&s r'r0zUploadFile.closes- WW]]__$$$$$$$r(cls.c#K|jVdSN)validate)r1s r'__get_validators__zUploadFile.__get_validators__slr(vcnt|tstdt||SNzExpected UploadFile, received: ) isinstanceStarletteUploadFile ValueErrortype)r1r6s r'r4zUploadFile.validates8!011 JHtAwwHHII Ir(_UploadFile__input_value_ct|tstdt|t t |Sr8)r9r:r;r<r r)r1r=r>s r' _validatezUploadFile._validatesE-)<== VTtM?R?RTTUU UJ ...r( field_schemac6|ddddSNstringbinary)r<format)update)r1rAs r'__modify_schema__zUploadFile.__modify_schema__s$   X F F G G G G Gr( core_schemahandlerc dddSrC)r1rIrJs r'__get_pydantic_json_schema__z'UploadFile.__get_pydantic_json_schema__s!H555r(sourcec*t|jSr3)rr@)r1rNrJs r'__get_pydantic_core_schema__z'UploadFile.__get_pydantic_core_schema__s2#-@@@r()r))r!N)"__name__ __module__ __qualname____doc__rrr__annotations__rstrintrbytesr$r+r.r0 classmethodr rrrr5r4r@r rrHr rrrMrP __classcell__)r&s@r'rrsB   :;; =  ss+D'E'EEFFFF HSM33'G#H#HH IIII w$A B BB CCCC ssOPPP)  C    ) )))))): ((  C    ( (((((($*  C    * ******(%%%%%%\ 2xc@R7S[d<(SS[ /c/c/l///[/ H  Hc3h HD H H H  H6$6/C6 666[6 A#YA)13%2C)DA AAA[AAAAAr(rc:eZdZdZdefdZdefdZdedefdZ dS) 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||_dSr3r])r%r]s r'__init__zDefaultPlaceholder.__init__s  r(r!c*t|jSr3)boolr])r%s r'__bool__zDefaultPlaceholder.__bool__sDJr(ocLt|to|j|jkSr3)r9r\r])r%rds r'__eq__zDefaultPlaceholder.__eq__s!!/00JQW 5JJr(N) rQrRrSrTrr`rbrcobjectrfrLr(r'r\r\s~c $    KK4KKKKKKr(r\ DefaultTyper]r!c t|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'Defaultrjs e $ $$r(N)typingrrrrrrr r r fastapi._compatr r rrrstarlette.datastructuresrrrrrrrr:typing_extensionsrrr\rhrjrLr(r'ros                      0/////777777999999777777??????333333FFFFFF,,,,,,,,OAOAOAOAOA$OAOAOAdKKKKKKKK$gm$$ %;%;%%%%%%r(