;3hCdZddlmZddlZddlZddlZddlZddlZddlmZm Z ddl m Z m Z ddl mZddlmZddlmZmZddlmZdd lmZdd lmZmZdd lmZdd lmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+erddlm,Z,Gdde,Z-ddl.m/Z/GddeZ0GddeeZ1dZ2Gdde1eZ3Gdde3Z4Gdd ejjZ6Gd!d"ejjZ7d%d#Z8 d& d'd$Z9y)(zContains all of the components that can be used with Gradio Interface / Blocks. Along with the docs for each component, you can find the names of example demos that use each component. These demos are located in the `demo` directory.) annotationsN)ABCabstractmethod)CallableSequence)Enum)Path) TYPE_CHECKINGAny)utils)Block BlockContext) ComponentMeta) BaseModel DeveloperPathFileData FileDataDictGradioDataModelMediaStreamChunk) EventListener)I18nData)Form)move_files_to_cache) TypedDictc"eZdZUded<ded<y) DataframeDataz list[str]headerszlist[list[str | int | bool]]dataN)__name__ __module__ __qualname____annotations__V/var/www/html/audio-gradio/venv/lib/python3.12/site-packages/gradio/components/base.pyrr's**r$rTimerceZdZdZdZy) _KeywordsNO_VALUEFINISHED_ITERATINGN)rr r!r*r+r#r$r%r)r).s H-r$r)ceZdZUgZded<eddZedZedZeddZ eddZ edddZ edd Z e edd Zedd Zedd Zy ) ComponentBasezlist[EventListener | str]EVENTSc|S)a Any preprocessing needed to be performed on function input. Parameters: payload: The input data received by the component from the frontend. Returns: The preprocessed input data sent to the user's function in the backend. r#selfpayloads r% preprocesszComponentBase.preprocess6s r$c|S)a Any postprocessing needed to be performed on function output. Parameters: value: The output data received by the component from the user's function in the backend. Returns: The postprocessed output data sent to the frontend. r#r1values r% postprocesszComponentBase.postprocessAs  r$cy)a? Process the input data in a way that can be displayed by the examples dataset component in the front-end. For example, only return the name of a file as opposed to a full path. Or get the head of a dataframe. The return value must be able to be json-serializable to put in the config. Nr#r5s r%process_examplezComponentBase.process_exampleLs r$cy) The typing information for this component as a dictionary whose values are a list of 2 strings: [Python type, language-agnostic description]. Keys of the dictionary are: raw_input, raw_output, serialized_input, serialized_output Nr#r1s r%api_infozComponentBase.api_infoVs r$cy)zW Deprecated and replaced by `example_payload()` and `example_value()`. Nr#r<s r%example_inputszComponentBase.example_inputs^ r$cy)s Write the component's value to a format that can be stored in a csv or jsonl format for flagging. Nr#r1r2flag_dirs r%flagzComponentBase.flager@r$c|SzW Convert the data from the csv or jsonl file into the component state. r#r0s r%read_from_flagzComponentBase.read_from_flagls r$cy)zBWhether this component should be skipped from the api return valueNr#r<s r%skip_apizComponentBase.skip_apissr$c||jvSN)r.)clsevents r% has_eventzComponentBase.has_eventxs ""r$c|j}tj|j}t j |j d|jj}|S)N_) r sysmodules__file__hashlibsha256rencode hexdigest)rM module_name module_path module_hashs r%get_component_class_idz$ComponentBase.get_component_class_id|sZnn kk+.77 nn||nAk] + 2 2 4 )+ r$Nr2r returnr )r^zdict[str, list[str]]r^r )r2zAny | GradioDataModelrD str | Pathr^str)r2r r^zGradioDataModel | Any)r^bool)rNzstr | EventListenerr^rd)r^rc)rr r!r.r"rr3r7r9r=r?rErHpropertyrJ classmethodrOr\r#r$r%r-r-3s(*F %*         QQ##r$r-) metaclasscd|_|S)NT) _is_server_fn)fns r%serverrksB Ir$c.eZdZdZ dddddddddddddddddd ddZedZdZfd Ze d Z e dd Z d dd Z d ZdZddZddZddZddZddZddZdddZddZxZS) ComponentzY A base class for defining methods that all input/output components should have. NTr6)labelinfo show_label containerscale min_width interactivevisibleelem_id elem_classesrenderkeypreserved_by_keyload_fneveryinputsc Ht|jDcgc]:}tt||r#tt||ddr t||<c}|_| sg} d|_t |dsd|_tj|| | | | | |t|tr|j||_ ||_|s|rtj dd}|d}||_||_|'|t'|k7rtj d|d||_||_||_d|_d|_|j3|\}}|j5|}t|t6r|j9}t;||dd |_t?j@|j<r(|jBjE|j<d t|r|jG||||jjI|_%ycc}w) NriF data_model)rvrwrurxryrzz1show_label has no effect when container is False.Tz*'scale' value should be an integer. Using z will cause issues.)r7 keep_in_cachepath)&dir __class__callablegetattr server_fns _selectablehasattrrr __init__ isinstanceStreamingInputcheck_streamablernrowarningswarnrprqroundrrrsrt load_eventload_event_to_attachget_load_fn_and_initial_valuer7r model_dumprr6 client_utils is_file_objraddattach_load_eventr\component_class_id)r1r6rnrorprqrrrsrtrurvrwrxryrzr{r|r} initial_values r%rzComponent.__init__s.T^^, e,-e,ouE D%  L!t\*<@DO  %-  dN +  ! ! #   QRJ  J$"  %,!6 MM//#JBBKK#JF<  8T" $KsA;cyNFr#r<s r%rJzComponent.skip_apisr$cJd}t|r|s|}|}||fS|}d}||fSrL)r)r6r}rr{s r%rz'Component.get_load_fn_and_initial_valuesA E? % G %%"MG %%r$ct|tr|g}|r|Dcgc]}t|ds|dfc}ng}t|ttfrddlm}||}|r|j|df|||f|_ycc}w)zOAdd an event that runs `callable`, optionally at interval specified by `every`.changerr&tickN) rrmrintfloatgradio.componentsr'appendr)r1rr|r}ichangeable_eventsr's r%rzComponent.attach_load_events fi (XFGMF Cqga.Ba] CSU  ec5\ * /%LE   $ $eV_ 5   % ! Ds A;A;c$|j|S)a Process the input data in a way that can be displayed by the examples dataset component in the front-end. By default, this calls the `.postprocess()` method of the component. However, if the `.postprocess()` method is computationally intensive, or returns a large payload, a custom implementation may be appropriate. For example, the `process_example()` method of the `gr.Audio()` component only returns the name of the file, not the processed audio file. The `.process_example()` method of the `gr.Dataframe()` returns the head of a dataframe instead of the full dataframe. The return value of this method must be json-serializable to put in the config. )r7r5s r%r9zComponent.process_example(s&&r$c$|j|S)z/Deprecated and replaced by `process_example()`.)r9r5s r% as_examplezComponent.as_example6s##E**r$c"|jS)zEDeprecated and replaced by `example_payload()` and `example_value()`.)example_payloadr<s r%r?zComponent.example_inputs:s##%%r$ct)z An example input data for this component, e.g. what is passed to this component's preprocess() method. This is used to generate the docs for the View API page for Gradio apps using this component. NotImplementedErrorr<s r%rzComponent.example_payload> "##r$ct)z An example output data for this component, e.g. what is passed to this component's postprocess() method. This is used to generate an example value if this component is used as a template for a custom component. rr<s r% example_valuezComponent.example_valueErr$c|j3|jj}|jdd}||d<|Std|j )r;N descriptionadditional_descriptionz1The api_info method has not been implemented for )rmodel_json_schemarrget_block_name)r1schemadescs r%r=zComponent.api_infoLsa ?? &__668F::mT2D/3F+ ,M!?@S@S@U?V W  r$c"|jSrLr=r<s r%api_info_as_inputzComponent.api_info_as_inputZ}}r$c"|jSrLrr<s r%api_info_as_outputzComponent.api_info_as_output]rr$cR|jrU|jj|}t|jd|j |j }t |tr|j }t |tstj|}|S)rBT)exist_ok) r from_jsonr mkdir copy_to_dirrrrrcjsondumpsrCs r%rEzComponent.flag`s ??oo//8G N $ /))(3>>@G gy )((*G'3'jj)Gr$cz|jr.|jjtj|S|SrG)rrrloadsr0s r%rHzComponent.read_from_flagns. ????,,TZZ-@A Ar$rL)"r6r rnstr | I18nData | Nonerorrp bool | Nonerqrdrr int | Nonersrrtrrurdrv str | Nonerwlist[str] | str | Nonerxrdryz(int | str | tuple[int | str, ...] | Nonerzrr{zCallable | Noner|Timer | float | Noner}7Component | Sequence[Component] | set[Component] | None)rrr|rr}rr_)r^zdict[str, Any]r`)r2r rDrbr^rc)r2r )rr r!__doc__rr TEMPLATE_DIR FRONTEND_DIRrrerJ staticmethodrrr9rr?rrr=rrrErH __classcell__rs@r%rmrms bJ(,&*"& $#'"/38<3:#'&*JN'bJbJ% bJ $ bJ  bJbJbJbJ!bJbJbJ-bJbJ6bJ 1!bJ"!#bJ$$%bJ&H'bJH!0L$L & &KO   $ H  0 '+&$$   r$rmc&eZdZdZddZddZdZy) FormComponenta A base class for components that are typically used in forms (e.g. Textbox, Dropdown). These components will be grouped together in the UI to provide a more condensed layout. Components that are not rendered in the UI (e.g. State) should also inherit from this class, as it will prevent them from breaking the grouping, see: https://github.com/gradio-app/gradio/issues/10330 c.t|dddurytS)NrqF)rrr<s r%get_expected_parentz!FormComponent.get_expected_parents 4d +u 4 r$c|SrLr#r0s r%r3zFormComponent.preprocesssr$c|SrLr#r5s r%r7zFormComponent.postprocesss r$N)r^ztype[Form] | Noner])rr r!rrr3r7r#r$r%rrws r$rceZdZdfd Zej ddZej d ddZxZS)StreamingOutputc(t||i||yrLrrr1argskwargsrs r%rzStreamingOutput.__init__s $)&) r$c KywrLr#)r1r6 output_id first_chunks r% stream_outputzStreamingOutput.stream_outputs  c Kyw)aCombine all of the stream chunks into a single file. This is needed for downloading the stream and for caching examples. If `only_file` is True, only the FileData corresponding to the file should be returned (needed for downloading the stream). The desired_output_format optionally converts the combined file. Should only be used for cached examples. Nr#)r1streamdesired_output_format only_files r%combine_streamzStreamingOutput.combine_streams  rr^None)rrcrrdr^z3tuple[MediaStreamChunk | None, FileDataDict | dict]r)rz list[bytes]rrr^zGradioDataModel | FileData) rr r!rabcrrrrrs@r%rrsx  # 26 <   -1     *  $    r$rcDeZdZdfd Zej dZxZS)rc$t||i|yrLrrs r%rzStreamingInput.__init__s $)&)r$cy)z8Used to check if streaming is supported given the input.Nr#r<s r%rzStreamingInput.check_streamables r$r)rr r!rrrrrrs@r%rrs"*   r$rctj||}t|trt d|j t|t std|j |S)NrxInvalid component: 'Expected a Component instance, but got )r component_or_layout_classrr ValueErrorrrm TypeError)cls_namerxobjs r% componentrs` 3% ) )( 36 BC#|$.s}}o>?? c9 %A#--QRR Jr$ct|trt||}nt|trP|j d}t j |}|di|d|i}t|tr/td|t|tr|}ntd||r|js|jn|r|jr|jt|tstd|j|S)a Returns a component instance from a string, dict, or Component object. Parameters: comp: the component to instantiate. If a string, must be the name of a component, e.g. "dropdown". If a dict, must have a "name" key, e.g. {"name": "dropdown", "choices": ["a", "b"]}. If a Component object, will be returned as is. render: whether to render the component. If True, renders the component (if not already rendered). If False, does not do anything. unrender: whether to unrender the component. If True, unrenders the the component (if already rendered) -- this is useful when constructing an Interface or ChatInterface inside of a Blocks. If False, does not do anything. rnamerxrzFComponent must be provided as a `str` or `dict` or `Component` but is rr#)rrcrdictrr rrrrm is_renderedrxunrenderrr)comprxr component_objr component_clss r%get_component_instancer s$!$v6 D$ xx77= %<rsD#  #.%*-/( 7 + +(.. PC=Pf i uiXI(   6 s{{ JO! !*.!BF!!r$