o ߭j@sddlmZmZmZmZmZmZmZmZm Z ddl m Z m Z m Z mZmZddlmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZmZGd d d eZGd ddZedZdedefddZdS)) AnyBinaryIOCallableDictIterableOptionalTypeTypeVarcast) PYDANTIC_V2 CoreSchemaGetJsonSchemaHandlerJsonSchemaValue"with_info_plain_validator_function)URL)Address)FormData)Headers) QueryParams)State) UploadFile) AnnotatedDoccseZdZUdZeeedfed<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&Zesed'ee efddfd(d)Zed*ed+edefd,d-Zed.eed+eegefdefd/d0Z Z!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__S/var/www/html/CropPilot/venv/lib/python3.10/site-packages/fastapi/datastructures.pyr"KzUploadFile.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)r!read)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)r!seek)r#r+r$r&r'r,qr(zUploadFile.seekcstIdHS)zm Close the file. To be awaitable, compatible with async, this is run in threadpool. N)r!closer#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/r3r&r&r'r1s zUploadFile.validate_UploadFile__input_value_cCs&t|tstdt|tt|Sr4)r5r6r7r8r r)r/r9r:r&r&r' _validates  zUploadFile._validate field_schemacCs|ddddSNstringbinary)r8format)update)r/r<r&r&r'__modify_schema__szUploadFile.__modify_schema__ core_schemahandlercCs dddSr=r&)r/rCrDr&r&r'__get_pydantic_json_schema__ z'UploadFile.__get_pydantic_json_schema__sourcecC t|jSr0)rr;)r/rGrDr&r&r'__get_pydantic_core_schema__rFz'UploadFile.__get_pydantic_core_schema__)r))rN)"__name__ __module__ __qualname____doc__rrr__annotations__rstrintrbytesr"r*r,r- classmethodrrrrr2r1r;r rrBr r rrErI __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 ||_dSr0rU)r#rUr&r&r'__init__ zDefaultPlaceholder.__init__rcCrHr0)boolrUr.r&r&r'__bool__rXzDefaultPlaceholder.__bool__ocCst|to |j|jkSr0)r5rTrU)r#r[r&r&r'__eq__szDefaultPlaceholder.__eq__N) rJrKrLrMrrWrYrZobjectr\r&r&r&r'rTs rT DefaultTyperUrcCst|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. )rTrVr&r&r'Defaultsr_N)typingrrrrrrrr r fastapi._compatr r r rrstarlette.datastructuresrrrrrrrr6typing_extensionsrrrTr^r_r&r&r&r's,