o e-. @sdZddlmZddlZddlZddlmZddlmZm Z m Z ddl m Z ddlmZmZddlmZddlm Z dd lmZmZdd lmZdd lmZmZmZmZmZed eGd ddeeeeeeZdS)zgr.File() component) annotationsN)Path)AnyCallableLiteral)utils)documentset_documentation_group)FileSerializable) IOComponent _Keywords)warn_deprecation) Changeable ClearableEventListenerMethod Selectable Uploadable componentc@seZdZdZ dBddddddddddddddddCd#d$Zd%d&Zeejddddddddf dDd(d)Z dEd.d/Z dFd3d4Z dGd8d9Z dHd;d<Z d=d>ZdId@dAZdS)JFilea4 Creates a file component that allows uploading generic file (when used as an input) and or displaying generic files (output). Preprocessing: passes the uploaded file as a {tempfile._TemporaryFileWrapper} or {List[tempfile._TemporaryFileWrapper]} depending on `file_count` (or a {bytes}/{List{bytes}} depending on `type`) Postprocessing: expects function to return a {str} path to a file, or {List[str]} consisting of paths to files. Examples-format: a {str} path to a local file that populates the component. Demos: zip_to_json, zip_files NsinglefileT) file_count file_typestypelabelevery show_label containerscale min_widthheight interactivevisibleelem_id elem_classesvalue!str | list[str] | Callable | Noner*Literal['single', 'multiple', 'directory']rlist[str] | NonerLiteral['file', 'binary']r str | Noner float | Noner bool | Nonerboolr int | Noner intr!int | float | Noner"r#r$r%list[str] | str | NonecKs||_||_|durt|tstd|jjgd}||vr*td|d||dkr2td|dkr?|dur?t d ||_ | |_ | t j |f||||| | | | |||d |dS) aq Parameters: value: Default file to display, given as str file path. If callable, the function will be called whenever the app loads to set the initial value of the component. file_count: if single, allows user to upload one file. If "multiple", user uploads multiple files. If "directory", user uploads all files in selected directory. Return type will be list for each file in case of "multiple" or "directory". file_types: List of file extensions or types of files to be uploaded (e.g. ['image', '.json', '.mp4']). "file" allows any file to be uploaded, "image" allows only image files to be uploaded, "audio" allows only audio files to be uploaded, "video" allows only video files to be uploaded, "text" allows only text files to be uploaded. type: Type of value to be returned by component. "file" returns a temporary file object with the same base name as the uploaded file, whose full path can be retrieved by file_obj.name, "binary" returns an bytes object. label: component name in interface. every: If `value` is a callable, run the function 'every' number of seconds while the client connection is open. Has no effect otherwise. Queue must be enabled. The event can be accessed (e.g. to cancel it) via this component's .load_event attribute. show_label: if True, will display label. container: If True, will place the component in a container - providing some extra padding around the border. scale: relative width compared to adjacent Components in a Row. For example, if Component A has scale=2, and Component B has scale=1, A will be twice as wide as B. Should be an integer. min_width: minimum pixel width, will wrap if not sufficient screen space to satisfy this value. If a certain scale value results in this Component being narrower than min_width, the min_width parameter will be respected first. height: The maximum height of the file component, in pixels. If more files are uploaded than can fit in the height, a scrollbar will appear. interactive: if True, will allow users to upload a file; if False, can only be used to display files. If not provided, this is inferred based on whether the component is used as an input or output. visible: If False, component will be hidden. elem_id: An optional string that is assigned as the id of this component in the HTML DOM. Can be used for targeting CSS styles. elem_classes: An optional list of strings that are assigned as the classes of this component in the HTML DOM. Can be used for targeting CSS styles. Nz.Parameter file_types must be a list. Received )rbinarybytesz$Invalid value for parameter `type`: z. Please choose from one of: r4zYThe `bytes` type is deprecated and may not work as expected. Please use `binary` instead. directoryzGThe `file_types` parameter is ignored when `file_count` is 'directory'.) rrrrrr r"r#r$r%r&)rr isinstancelist ValueError __class____name__r warningswarnrr!r __init__)selfr&rrrrrrrrr r!r"r#r$r%kwargsZ valid_typesr@FD:\Projects\ConvertPro\env\Lib\site-packages\gradio/components/file.pyr=-sP&  z File.__init__cCs$|j|j|j|j|jdt|S)N)rrr& selectabler!)rrr&rBr!r get_configr>r@r@rArCszFile.get_config(Any | Literal[_Keywords.NO_VALUE] | Nonec Cs|||||||||dd S)Nupdate) rrrrr r!r"r#r&Z__type__r@) r&rrrrr r!r"r#r@r@rArFs z File.updatexlist[dict[str, Any]] | Nonereturn\bytes | tempfile._TemporaryFileWrapper | list[bytes | tempfile._TemporaryFileWrapper] | Nonecsf|durdSd fdd jdkr!t|tr|dS|St|tr/fdd |DS|S) z Parameters: x: List of JSON objects with filename as 'name' property and base64 data as 'data' property Returns: File objects in requested format NrI&bytes | tempfile._TemporaryFileWrappercs|d|d|dd}}}jdkrH|r|}nt|\}}j||d}tt|}j |t j dj d}||_||_|SjdksRjd krt|rmt|d  }|WdS1shwYt|d Std tjd )Nnamedatais_fileFr) file_name)deletedirr3r4rbrzUnknown type: z&. Please choose from: 'file', 'bytes'.)getrmake_temp_copy_if_needed client_utilsZdecode_base64_to_binaryZfile_bytes_to_filestrrabspathZ temp_filesaddtempfileNamedTemporaryFileZDEFAULT_TEMP_DIRrL orig_nameopenreadr8)frOrMrNpath_r file_datarDr@rAprocess_single_files<      z,File.preprocess..process_single_filerrcsg|]}|qSr@r@).0r^)rbr@rA sz#File.preprocess..)rIrK)rr6r7)r>rGr@)rbr>rA preprocesss $   zFile.preprocessystr | list[str] | None,dict[str, Any] | list[dict[str, Any]] | NonecsR|durdSt|trfdd|DSt|j|t|jddd}|S)z Parameters: y: file path Returns: JSON object with key 'name' for filename, 'data' for base64 url, and 'size' for filesize in bytes Ncs2g|]}t|j|t|jdddqS)NTr[rLsizerMrN)rrLrTstatst_sizercrrDr@rArds z$File.postprocess..Tri)r6r7rrLrTrkrl)r>rfdr@rDrA postprocesss     zFile.postprocess input_datastr | list | NonerVcCs4|durdSt|trddd|DSt|jS)Nz, cSsg|]}t|jqSr@)rrLrmr@r@rArd sz#File.as_example..)r6r7joinrrL)r>rpr@r@rA as_examples   zFile.as_exampledict[str, dict | bool]cC|jdkr |S|SNr)rZ_single_file_api_infoZ_multiple_file_api_inforDr@r@rAapi_info  z File.api_infocCrvrw)rZ_single_file_serialized_infoZ_multiple_file_serialized_inforDr@r@rAserialized_inforyzFile.serialized_infodict[str, Any]cCrvrw)rZ_single_file_example_inputsZ_multiple_file_example_inputsrDr@r@rAexample_inputsryzFile.example_inputs)N)r&r'rr(rr)rr*rr+rr,rr-rr.rr/r r0r!r1r"r-r#r.r$r+r%r2)r&rErr+rr-rr-rr/r r/r!r1r"r-r#r-)rGrHrIrJ)rfrgrIrh)rprqrIrV)rIru)rIr{)r: __module__ __qualname____doc__r=rC staticmethodr ZNO_VALUErFrerortrxrzr|r@r@r@rArsJ  U   @ r) r __future__rrYr;pathlibrtypingrrrZ gradio_clientrrUZgradio_client.documentationrr Zgradio_client.serializingr ZgradioZgradio.components.baser r Zgradio.deprecationr Z gradio.eventsrrrrrrr@r@r@rAs.