o ɝi@sddlmZmZmZmZmZmZmZmZm Z ddl m Z ddl m Z mZmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZGd d d eZGdddZedZdedefddZdS)) AnyBinaryIOCallableDictIterableOptionalTypeTypeVarcast)Doc) CoreSchemaGetJsonSchemaHandlerJsonSchemaValue)URL)Address)FormData)Headers) QueryParams)State) UploadFile) AnnotatedcseZdZUdZeeedfed<eee edfed<eee edfed<ee edfed <eee ed fed <d ee ed fddffdd Z d1dee edfde ffdd Zdee edfddffdd Zd2fdd ZededdeedeffddZededd edefd!d"Zed#ed$eddfd%d&Zed'ee efddfd(d)Zed*ed+edefd,d-Zed.eed+eegefdefd/d0ZZ S)3raA 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. returnNct|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__R/var/www/html/ocr-read/venv/lib/python3.10/site-packages/fastapi/datastructures.pyr JzUploadFile.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)r!rr"r$r%r(^szUploadFile.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)r!r)r"r$r%r*pr&zUploadFile.seekcstIdHS)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)rcloser!r"r$r%r+szUploadFile.closecls.ccs|jVdSN)validate)r-r$r$r%__get_validators__s zUploadFile.__get_validators__vcCs t|tstdt||SNzExpected UploadFile, received: ) isinstanceStarletteUploadFile ValueErrortype)r-r1r$r$r%r/s zUploadFile.validate_UploadFile__input_value_cCs&t|tstdt|tt|Sr2)r3r4r5r6r r)r-r7r8r$r$r% _validates  zUploadFile._validate field_schemacCs|ddddSNstringbinary)r6format)update)r-r:r$r$r%__modify_schema__szUploadFile.__modify_schema__ core_schemahandlercCs dddSr;r$)r-rArBr$r$r%__get_pydantic_json_schema__s z'UploadFile.__get_pydantic_json_schema__sourcecCsddlm}||jS)N)"with_info_plain_validator_function) _compat.v2rFr9)r-rDrBrFr$r$r%__get_pydantic_core_schema__s  z'UploadFile.__get_pydantic_core_schema__)r')rN)!__name__ __module__ __qualname____doc__rrr __annotations__rstrintrbytesr r(r*r+ classmethodrrrrr0r/r9rr@r r rrCrH __classcell__r$r$r"r%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 ||_dSr.rT)r!rTr$r$r%__init__ zDefaultPlaceholder.__init__rcCs t|jSr.)boolrTr,r$r$r%__bool__rWzDefaultPlaceholder.__bool__ocCst|to |j|jkSr.)r3rSrT)r!rZr$r$r%__eq__szDefaultPlaceholder.__eq__N) rIrJrKrLrrVrXrYobjectr[r$r$r$r%rSs rS DefaultTyperTrcCst|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. )rSrUr$r$r%Defaultsr^N)typingrrrrrrrr r annotated_docr fastapi._compatr r rstarlette.datastructuresrrrrrrrr4typing_extensionsrrSr]r^r$r$r$r%s ,