jSrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK J r J r JrJr SSKJr SSKJr SSKJr SSKJr SS KJrJrJrJrJr SS KJr SS K!J"r" SS K#J$r$J%r%J&r&J'r'Jr SS K(J)r)J*r* SSK+J,r,J-r-J.r. SSK/J0r0J1r1 SSK2J3r3J4r4 SSK5J6r6 SSK7J8r8 SSK9J:r: SSK;Jr> \(aSSK?J@r@ SrAS1SSSS.S2SjjjrB\""5"SS55rCS3SjrD"SS5rE\""S S!5"S"S#\ 55rFS4S$jrGS%rHS5S&jrIS6S7S'jjrJS8S9S(jjrK\""5S:S)j5rL\""5S;S*j5rMS<S=S+jjrN\""S,S-9S>S?S.jj5rO\""S,S-9S@S?S/jj5rP\""S,S-9SAS?S0jj5rQg)BzK Defines helper methods useful for loading and caching Interface examples. ) annotationsN)CallableIterableMutableMappingSequence)partial)Path)Lock)SimpleNamespace) TYPE_CHECKINGAnyLiteralOptional get_origin)utils)document) componentsoauthprocessing_utilsroutesr)Cacheresolve_generator)Context LocalContextget_blocks_context) GradioModelGradioRootModel) Dependency EventData)Error) CSVLogger)I18nData)Header)UnhashableKeyDict Componentlog.csvT)example_labelsvisiblepreloadc[S0SU_SU_SU_SU_SU_SU_SU_SU_S U_S U _S U _S U _S U _SU _SU_SU_SU_SU_SU_SS_SU_6nUR5 U$)zTop-level synchronous function that creates Examples. Provided for backwards compatibility, i.e. so that gr.Examples(...) can be used to create the Examples component.examplesinputsoutputsfncache_examples cache_modeexamples_per_page _api_modelabelelem_id run_on_click preprocess postprocessapi_visibilityapi_nameapi_descriptionbatchr(r)_initiated_directlyFr*)Examplescreate)r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r(r)r* examples_objs ڜC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\gradio/helpers.pycreate_examplesrC*s0   &   ," & (!"#$&%&'(")*+L. c\rSrSrSrSSSSSS.SSjjjrSrSS jrSS jrSS jr S r SSS jjr SSSjjr Sr g)r?]av This class is a wrapper over the Dataset component and can be used to create Examples for Blocks / Interfaces. Populates the Dataset component with examples and assigns event listener so that clicking on an example populates the input/output components. Optionally handles example caching for fast inference. Demos: calculator_blocks Guides: more-on-examples-and-flagging NTr)r(r)r*r=c ^U(a[R"S5 SUlUc7[R"SS5R 5S;a Ub UbSUlOUS;aXPlO[ S U35eUR(aUbUc [ S 5e[R"S 5=n(aIUcFUR 5S :XaS nO/UR 5S :XaS nOS n[R"S5 UR(a US :XaS Ul[U[5(dU/nU(a[U[5(dU/n[5R5nUc [ S5e[U[5(a)[U5S:Xd[US[5(aGOn[U[5(a$[U5S:XaUVs/sHnU/PM nnGO5[U[5(Ga[U5R5(d[SU35eUn[U5[ - R5(dI[U5S:Xa([R""U5Vs/sHnU/PM nnO[S[ -5e[%[U5[ - 5n[[&R("U55n[+S[U55Vs/sHnUUS[U5PM nnSSS5 O [ S5eS/[U5-nUH#n[-U5HunnUcM SUU'M M% [1UUSS9VV s/sHunn U (dMUPM n!nn UVV"V s/sH-n[1UUSS9V"V s/sHun"n U (dMU"PM sn n"PM/ n#n"nn Ub#[U5[U5:wa [ S5eXlU#UlX lUUlU!UlU=(d /UlX@lXl Xl!Xl"Xl#Xl$UUl%UUl&UUl'UUl(UUl)SSK*J+n$ [XRZ"U5 U$R\"U![^R`"U#5SU UU UUS9Ul1SSS5 [eSSSS9Ul3[XRh"5[URbRj5- Ul6[RnRqS5S:Xa?URlR5(a [rRt"URl5 [URl5S- Ul;[URl5S- Ul<Xl=SUl>[5Ul@UR2V%s/sH n%[5PM sn%UlBURbR(aT[-UR45H;un&nURU5URURbRU&'M= URS :Xak[S[XR"URl5S 3SS!9 [URv5R5(a [S"5 [S#5 ggs snfs snfs snf!,(df  GN=f![.a GMf=fs sn nfs sn n"fs sn n"nf!,(df  GNl=fs sn%f)$a Parameters: examples: example inputs that can be clicked to populate specific components. Should be nested list, in which the outer list consists of samples and each inner list consists of an input corresponding to each input component. A string path to a directory of examples can also be provided but it should be within the directory with the python file running the gradio app. If there are multiple input components and a directory is provided, a log.csv file must be present in the directory to link corresponding inputs. inputs: the component or list of components corresponding to the examples outputs: optionally, provide the component or list of components corresponding to the output of the examples. Required if `cache_examples` is not False. fn: optionally, provide the function to run to generate the outputs corresponding to the examples. Required if `cache_examples` is not False. Also required if `run_on_click` is True. cache_examples: If True, caches examples in the server for fast runtime in examples. If "lazy", then examples are cached (for all users of the app) after their first use (by any user of the app). If None, will use the GRADIO_CACHE_EXAMPLES environment variable, which should be either "true" or "false". In HuggingFace Spaces, this parameter is True (as long as `fn` and `outputs` are also provided). The default option otherwise is False. Note that examples are cached separately from Gradio's queue() so certain features, such as gr.Progress(), gr.Info(), gr.Warning(), etc. will not be displayed in Gradio's UI for cached examples. cache_mode: if "lazy", examples are cached after their first use. If "eager", all examples are cached at app launch. If None, will use the GRADIO_CACHE_MODE environment variable if defined, or default to "eager". examples_per_page: how many examples to show per page. label: the label to use for the examples component (by default, "Examples") elem_id: an optional string that is assigned as the id of this component in the HTML DOM. run_on_click: if cache_examples is False, clicking on an example does not run the function when an example is clicked. Set this to True to run the function when an example is clicked. Has no effect if cache_examples is True. preprocess: if True, preprocesses the example input before running the prediction function and caching the output. Only applies if `cache_examples` is not False. postprocess: if True, postprocesses the example output after running the prediction function and before caching. Only applies if `cache_examples` is not False. api_visibility: Controls the visibility of the event associated with clicking on the examples. Can be "public" (shown in API docs and callable), "private" (hidden from API docs and not callable by the Gradio client libraries), or "undocumented" (hidden from API docs but callable). api_name: Defines how the event associated with clicking on the examples appears in the API docs. Can be a string or None. If set to a string, the endpoint will be exposed in the API docs with the given name. If None, an auto-generated name will be used. api_description: Description of the event associated with clicking on the examples in the API docs. Can be a string, None, or False. If set to a string, the endpoint will be exposed in the API docs with the given description. If None, the function's docstring will be used as the API endpoint description. If False, then no description will be displayed in the API docs. batch: If True, then the function should process a batch of inputs, meaning that it should accept a list of input values for each parameter. Used only if cache_examples is not False. example_labels: A list of labels for each example. If provided, the length of this list should be the same as the number of examples, and these labels will be used in the UI instead of rendering the example values. visible: If False, the examples component will be hidden in the UI. preload: If an integer is provided (and examples are being cached eagerly and none of the input components have a developer-provided `value`), the example at that index in the examples list will be preloaded when the Gradio app is first loaded. If False, no example will be preloaded. zWPlease use gr.Examples(...) instead of gr.helpers.Examples(...) to create the Examples.FNGRADIO_CACHE_EXAMPLES)truelazyT)TFzCThe `cache_examples` parameter should be either True or False, not z8If caching examples, `fn` and `outputs` must be providedGRADIO_CACHE_MODEeagerrKzeThe `GRADIO_CACHE_MODE` environment variable must be either 'eager' or 'lazy'. Defaulting to 'eager'.z'The parameter `examples` cannot be Nonerz#Could not find examples directory: z8Could not find log file (required for multiple inputs): zThe parameter `examples` must either be a string directory or a list(if there is only 1 input component) or (more generally), a nested list, where each sublist represents a set of inputs.strictzlIf `example_labels` are provided, the length of `example_labels` must be the same as the number of examples.)rtuple)rsamplestyper4samples_per_pager5r) sample_labelsr')simplify_file_dataverbosedataset_file_nameGRADIO_RESET_EXAMPLES_CACHETruez indices.csvzWill cache examples in 'z' directory at first use.)endzYIf method or examples have changed since last caching, delete this folder to reset cache. )Gwarningswarnr0osgetenvlower ValueError isinstancerr absolutelistlenstrexistsFileNotFoundErrorLOG_FILElistdiropencsvreaderrange enumerate IndexErrorzipr,non_none_examplesr-input_has_examplesinputs_with_examplesr.r/r3r7r8r9r:r;r<r(working_directoryr*gradiorr set_directoryDatasetcopydeepcopydatasetr! cache_loggerget_cache_folder_id cached_folderenvirongetshutilrmtree cached_filecached_indices_filer6 cache_eventr$non_none_processed_examplesr _cache_locksrR_get_processed_exampleprintabspath)'selfr,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r(r)r*r=cache_mode_envrvelogsirtexampleidxexample_for_inputinpkeepruexrsr_indexs' rB__init__Examples.__init__iso^  MMi $  ! 126<<>BRRN'&*# } ,"0 UVdUef    BJ'/WX X ii(;< ((**'9(D!) NX-5577v;!#-/ZZ-AB-A-AHBH+R"# $x.834#CJJt$45H(-1]];]TV]; <<  "+D,B,B"Cw//8001E1Ee1LM#D   & ( *5==9K9K+L*MMfg D$$%,,..o $K )Y/ C 54&&   B4 34UupTRU5n[R"U5$N)rrresolve_singleton) example_tupler example_valueprocessed_examplers rBload_example_input+Examples.create..load_example_inputos.'4$A(,(C(CM(R% 223DEErDcZ>Uup#TRX!5n[R"U5$r)load_from_cacherr)rrequest example_idrcached_outputsrs rBload_example_output,Examples.create..load_example_outputts+$1MJ%)%9%9*%NN 22>BBrDhiddenF undocumented)r-r. show_progressr8queuer9)r-r.r8r:r;r9rKc3@# UHnSUR;v M g7f)valueN)constructor_args).0rs rB "Examples.create..s" #UupTRU5n[TR5S:Xa'[SSUS0TRR SD6$[ [TR55Vs/sH)n[SSX40TRR UD6PM+ sn$s snf)NrNrrr>)rrfruupdater|component_propsro)rrrrrrs rB load_example%Examples.create..load_examples'4$A(,(C(CM(R%4445:% "3A"6 "ll::1= "'s4+D+D'E!F  "GA "3"6"ll::1="G s70B*)r-r.rr8rr:r;r9z.Cannot run_on_click if no function is provided)r-r.r9zhIf an Examples object is created outside a Blocks Context, make sure to call `examples.dataset.render()`zand `examples.create()`rIz) to render the examples in the interface.)rzroutes.Request)rr root_blockextra_startup_eventsr_start_cachingr0r|clickr-thenr.r:r;r9rload_input_eventr*anyruloadrStatersr6r/rbr]r^)r blocks_configrrrs` rBr@Examples.createcs *, !,, (5M $ $4  44;;D KK"* %#1 LL %!]]$($8$8#'#6#6 4#8&LL-++v5 #'#<#<  OO((*&,,!%t/E/Edll/S T  !% &.$)#'5) OO((+&,,!%t/E/Edll/S T  !% $)&.'5) %(6.H )- (:(:  LL> 55"* %!]]$($8$8#'#6#6); )%$$ww(L))..#{{ $ '5 / % MMzY]YlYl|Urt{uu^_ rDc# SSKnUR5nURVs/sHoR5PM nUR UR UR UR5 SSS5 WR5 URURRSWS5IShvN $s snf!,(df  NU=fN7f)a~ This is a way that we can postprocess the data manually, since we set postprocess=False in the lazy_cache event handler. The reason we did that is because we don't want to postprocess data if we are loading from the cache, since that has already been postprocessed. We postprocess this data manually if we are calling the function using the _handle_callable_as_generator() method. rN) rwBlocksr.renderrr/r-unrenderpostprocess_datadefault_configfns)routputgrdemos rB_postprocess_outputExamples._postprocess_outputs  YY[D+/<< 8<]]_< 8 IIdggt{{DLL 9 **4+>+>+B+B1+EvtTTT 9[Us9CCB<3C2AC7C8C<C C Cc@[UR5R5(a`[UR5nUVs/sHn[ UR 55PM nnSSS5 UW;aUR U5nU$gs snf!,(df  N-=fr)r rrhrlintstripr)r example_indexflinecached_indices cached_indexs rB_get_cached_index_if_cached$Examples._get_cached_index_if_cacheds (( ) 0 0 2 2d../1@A!B#djjl"3!B0.-33MB ## "C0/sB#B &B B BcP# UR(abURHRn[UVs/sH o"cMUPM sn5[UR5:wdM<[R "S5 O URSLaUR 5IShvN ggs snfN 7f)NaQExamples will be cached but not all input components have example values. This may result in an exception being thrown by your function. If you do get an error while caching examples, make sure all of your inputs have example values for all of your examples or you provide default values for those particular parameters in your function.T)r0r,rfr-r]r^cache)rrrs rBrExamples._start_cachings   ==W?WrW?@C DTTMMj)   $ &**,   '@ s&*B&B B B&>/A ,,CT^^1CjjKKA& A<<'$%>??# "+D,B,B"CJA!-!/ &*&A&A'&JO'01H1H'I #t+225$?(Jzz@O*Pu7*P88:,0??+F+F%)__%C%C%G%G%Q#2$+.2.A.AV.K ,G,& ;(/F''I LL,"(" zz8>!?u(!?#'#4#4#9#9&#AA#ELd66<1G:Q"Or RS=<;#D>$..2266x@5+Q & ;:" "@<< ..2266x@sF#P&A/O+O NO'AN%5N#6N%:.O(N6)ON86ON= O.0PO#N%% N3 /O8O= O  O1PPcURU URU5nUc/[R"URX5nUc [ S5eSSS5 [ URSS9n[[R"U55nSSS5 WS-[W5:a [ S5eXSS-n/nURc [S5e[URUSS9HupU n [R "U 5n [#U [5(a![#U[$R&5(aU n [(R*"U 5(d [-S 5eUR/U 5 M U$!,(df  GN/=f!,(df  GN=f![[,[04a$ UR/UR3U 55 Mf=f) zLoads a particular cached example for the interface. Parameters: example_id: The id of the example to process (zero-indexed). request: The request that triggered lazy caching, if any. Nz&Cached example not found in cache filezutf-8)encodingrNrFrOzvalue wasn't an update)rr client_utilssynchronize_asyncrrqrlrrermrnrfr.rbrrast literal_evalrcrFileris_prop_update TypeErrorr SyntaxErrorread_from_flag) rrrrrr,rrrr value_to_use value_as_dicts rBrExamples.load_from_cacheRs  z *;;JGL#+==JJ    '$%MNN+$""W 5CJJu-.H6 ! s8} ,EF F!+, << 67 7 #DLL'% H I L F # 0 0 7 mT22zz88$1L++M::#$<== m,!I  G+ *6 50 ;7 F i66|DE Fs+AE<0 F3BF < F  F 5GG)r3rr;r:r9r<rr0r}rrrr|r(r,r/rtr-rurrsrr.r8r*r7rr6rv)NNNN Fr?NFTTrrNF)*r,!list[Any] | list[list[Any]] | strr-Component | Sequence[Component]r.&Component | Sequence[Component] | Noner/Callable | Noner0 bool | Noner1Literal['eager', 'lazy'] | Noner2rr3boolr4str | I18nData | Noner5 str | Noner6rr7rr8rr9,Literal['public', 'private', 'undocumented']r:rr;str | None | Literal[False]r<rr(list[str] | Noner)bool | Literal['hidden']r*int | Literal[False]r=rreturnNone)rre)r int | NoneNN)rrrroutes.Request | Nonerrr)rrrr!rz list[Any])__name__ __module__ __qualname____firstlineno____doc__rrr@rrrrr__static_attributes__r>rDrBr?r?]s;?"&*6:!#'1"" GU-7;%Y(,0,0()$(/Y3Y0Y8 Y  Y $ Y4YYY%YYYYYEY !Y"5#Y$%Y())Y**+Y,&-Y."/Yv>wr U ""&)-MM'M  Md*.--'-  --rDr?c# SSKJn [U5GHupE[XS5(dMUR(dM+/nSnS[ R "53n[U5Hup[U5S:aXn URU 5n [U [[45(aU R5n URXU S:H5IShvN n U S:Xa3U SRS5=n (a[U 5RSSnU S(dMUR!U SS5 M UR#U5IShvN =n(aUR!US5 UR%U5 UR'XgS9IShvN nUR5X$'GM U$NNb!UR%U5 f=fN77f)Nr)StreamingOutputzcache/rN orig_namer)desired_output_format)gradio.components.baser)rprc streaminguuiduuid4rfr8rrr stream_outputrr suffixrflush_stream_outputend_stream_outputcombine_stream)rrrr) output_indexoutput_component binary_chunksr+ stream_idrchunkprocessed_chunk stream_chunkr* final_chunkcombined_outputs rBrrs7*3J*?& & 8 8=M=W=W=WM$( !!/I > )*: ;HA:* % 3&6&B&B5&IO!/K3QRR*9*D*D*F)9)G)G'AF*$LAv Q0C0CK0P#P9#P04Y0F0Fqr0J-#A%,,\!_V-DE!<)9(L(LY(W"WW;W!((V)<= 229=$4$C$C%D%O$3#=#=#?F 9+@< M!$#X!229=s_&G G G A7F1F-AF1/F1 F/ F1,#G GG -F1/F11GG c@\rSrSrSSSjjrSrg)TrackedIterableiNcXXlX lX0lX@lXPlX`lXplgr)iterablerlengthdescunit_tqdmprogress)rrArrBrCrDrErFs rBrTrackedIterable.__init__s'!       rD)rErCrrArBrFrDr )rAIterable | Nonerint | float | NonerBrIrCrrDrrF float | Nonerr)r"r#r$r%rr'r>rDrBr?r?sX!%!!!"!# !  !  !! !!rDr?__call__tqdmc\rSrSrSrSSSjjrSrSrSrSSSjjr SSS jjr SSS jjr S r \ S 5rS rg)Progressia The Progress class provides a custom progress tracker that is used in a function signature. To attach a Progress tracker to a function, simply add a parameter right after the input parameters that has a default value set to a `gradio.Progress()` instance. The Progress tracker can then be updated in the function by calling the Progress object or using the `tqdm` method on an Iterable. Example: import gradio as gr import time def my_function(x, progress=gr.Progress()): progress(0, desc="Starting...") time.sleep(1) for i in progress.tqdm(range(100)): time.sleep(0.1) return x gr.Interface(my_function, gr.Textbox(), gr.Textbox()).launch() Guides: progress-bars c@U(a [5 Xl/Ulg)z Parameters: track_tqdm: If True, the Progress object will track any tqdm.tqdm iterations with the tqdm library in the function. N) patch_tqdm track_tqdm iterables)rrQs rBrProgress.__init__s  L$02rDcXUR(dgURSR$)Nr)rRrBrs rB__len__Progress.__len__s!~~~~b!(((rDcU$rr>rVs rB__iter__Progress.__iter__s rDcVUR5nU(aURSn[URS5(di[ UR5S:aPURR 5n[URS5(d[ UR5S:aMPU"UR5 UR c [S5eU=R S- sl[UR5$U$![a URR 5 ef=f)z6 Updates progress tracker with next item in iterable. rU__next__rIndex not set.rN) _progress_callbackrRhasattrrArfrrrqnext StopIteration)rcallbackcurrent_iterables rBr]Progress.__next__s**, #~~b1 ,55zBB'!+#'>>#5#5#7 ,55zBB'!+ T^^ $%%- !122  " "a ' " ,5566 K ! ""$ s +D&D(Nc UR5nU(aA[U[5(aUupsSnOSnU"UR[ SXsX$XQ5/-5 gU$)a Updates progress tracker with progress and message text. Parameters: progress: If float, should be between 0 and 1 representing completion. If Tuple, first number represents steps completed, and second value represents total steps or None if unknown. If None, hides progress bar. desc: description to display. total: estimated total number of steps. unit: unit of iterations. N)r_rcrQrRr?)rrFrCtotalrDrErcrs rBrKProgress.__call__s` **, (E**'  "4t5STU  OrDc UR5nU(aUc=[SSX2XE5nURRU5 U"UR5 U$[ US5(a [ U5OUnURR[[ U5SXXE55 U$Uc [ /5$[ U5$)z Attaches progress tracker to iterable, like tqdm. Parameters: iterable: iterable to attach progress tracker to. desc: description to display. total: estimated total number of steps. unit: unit of iterations. NrrW)r_r?rRrr`rfiter) rrArCrgrDrErc new_iterablerBs rBrL Progress.tqdms **, .tQTQ %%l3( &-h &B&BS]F NN ! !X6M K  8OH~rDcUR5nU(ah[UR5S:aOURSnURc [ S5eU=RU- slU"UR5 gg)zi Increases latest iterable with specified number of steps. Parameters: n: number of steps completed. rrUNr^)r_rfrRrrq)rnrcrds rBrProgress.update:sl **, DNN+a/#~~b1 %%- !122  " "a ' " T^^ $ rDc:UR5nU(a[[UR55HOn[ URUR 5[ U5:XdM4URR U5 O U"UR5 gg)z$ Removes iterable with given _tqdm. N)r_rorfrRidrEr)rrErcrs rBcloseProgress.closeJss**, 3t~~./dnnQ'--."U);NN&&q)0 T^^ $ rDc[RRS5n[RRS5nU(aU(dg[ UR R U5$r)rblocksrevent_idr_queue set_progress)rurvs rBr_Progress._progress_callbackXsM$$((.((,,T28v}}118<rDrBrNrNs&! 3 3) 6 $( 7"   B $( !"   @ ==rDrNc[S5nS SjnSnSSjnSnSn[URS5(d%URRURl[URS5(d%URR URl[URS 5(d%URRURl [URS 5(d%URRURl [URS 5(d%URRURl XRlX0RlX@RlXPRl X Rl [US 5(a8[URS5(aURURlggg![a gf=f)NrLcB[RRS5UlURbUURR 5nUb8URR XX4US9 [ [RS5US'UR"XU/UQ7SU0UD6 g)N)rEwfilerD) rrFr _progressr_rLrlr_devnull__init__orig__)rrArCrgrDargskwargsrcs rB init_tqdmpatch_tqdm..init_tqdmgs&..2248 >> %~~88:H###HEt#L!%bjj#!6v HENDNtNvNrDcURb)URR5nUb UR$UR5$r)rr___iter__orig__rrcs rB iter_tqdmpatch_tqdm..iter_tqdmrs= >> %~~88:H#~~%""$$rDcURb8URR5nUbURRU5 URU5$r)rr_r__update__orig__)rrnrcs rB update_tqdmpatch_tqdm..update_tqdmysG >> %~~88:H#%%a($$Q''rDcURb8URR5nUbURRU5 UR5$r)rr_rr__close__orig__rs rB close_tqdmpatch_tqdm..close_tqdmsE >> %~~88:H#$$T*##%%rDcURb8URR5nUbURRU5 URXU5$r)rr_rr__exit__orig__)rexc_type exc_value tracebackrcs rB exit_tqdmpatch_tqdm..exit_tqdmsI >> %~~88:H#$$T*""8 BBrDrrrrrauto)NNNrzr{) __import__ModuleNotFoundErrorr`rLrrrrrrr__exit__rrZrr)rErrrrrs rBrPrPasy6" :A O%(&C 5::/ 0 0$)JJ$7$7 ! 5::1 2 2&+jj&7&7 # 5::0 1 1%*ZZ%5%5 " 5::/ 0 0$)JJ$7$7 ! 5::/ 0 0$)JJ$7$7 !$JJ#JJ!JJ#JJ#JJuf'%**f"="=** #>{ s G;; HHc [US9nU(dX 4$U[R"U[RR U4[RR SS94$)N)rQr)r before_fn before_argsafter_fn after_args)rNrfunction_wrapperrrFset)r/rQrFs rBcreate_trackerrsZ:.H | U++ ''++K&&**  rDcUc0$[USS5=(d Un[USS5n[U[5(aURS05$[USS5=(d 0$)a-Return the request's session, or an empty mapping if there is no session to read (the normal case for apps without OAuth / SessionMiddleware). For a real Starlette/fastapi request the session lives in `scope["session"]`; touching `.session` directly would raise Starlette's "SessionMiddleware must be installed" assertion when it's absent, so we gate on `scope` membership instead. A `gr.Request` exposes the fastapi request as `.request`; objects without a Starlette `scope` (a queued `gr.Request` rebuilt from kwargs) may still carry a plain `.session`. Nrscopesession)getattrrcdictr)r underlyingrs rB_session_from_requestrsa )T2=gJ J .E%yyB'' :y$ / 525rDc" [R"U5nSSKJn [ R "U5n/n URR5H<n U RU RU R4;a OU RU 5 M> Sn Sn /n [U 5GHupURU R5n[!U R"[$5(a$Un UbUR'XR"5 MbMd[!U R"[(5(a"UbUR'XR"5 MMU[*R,[.[*R,4;aUbUR'X5 MMU[0R2S-[0R4S-[0R2[0R44;Ga<UGb5[7U5n[0R8"U5nU[.[0R2[0R24;aXUbUSOSnUb[0R2"U5nOU[0R2:Xa [;S5eUR'UU5 GMU[.[0R4[0R44;acUb[0R4"USUSUSS 9OSnUcUbUnUcU[0R4:Xa [;S5eUR'UU5 GMgGMjGMmU[<[.[<4;aUbUbU RR?S S 5RA5nSn[CUS 5(aE[EURF5RI5HunnURA5U:XdMUn O [KU5U:aUX'GM"UR'UU5 GM7GM:GM=U(a[RL"U5(ar[OU[P5(a]Un UbUUbO[RRT"URV5 UR'X"URXURV55 GMGMGMU(av[[U5cj[RL"U5(aO[OX5(a?U RU5 Ub(U(aX;a[]S0XNDS S0D6X'GMEGMHGMKGMNU R"U R^LdGMjUcGMp[KU5U::dGMUR'XR"5 GM Ub[KU5[KU 5:a[KU5nXn U R"U R^:Xa([`Rb"S5 URS5 OURU R"5 [KU5[KU 5:aMU=(d /XU 4$![a U=(d /SS/4s$f=f)a Checks if function has special arguments Request or EventData (via annotation) or Progress (via default value). Also checks if any parameters are type-hinted with gr.Component types, in which case all component props should be passed. If inputs is provided, these values will be loaded into the inputs array. Parameters: fn: function to check. inputs: array to load special arguments into. request: request to load into inputs. event_data: event-related data to load into inputs. component_props: dictionary mapping input indices to their full component props. token: an OAuthToken to inject into OAuthToken-annotated params when one cannot be derived from the request session (e.g. server-side workflow calls that resolve the token outside of a browser session). Returns: updated inputs, progress index, event data index, list of input indices that need component props. Nrr%userinfoz@This action requires a logged in user. Please sign in and retry. access_tokenr expires_at)tokenrrr-headers_is_component_updateTz'Unexpected argument. Filling with None.r>)2inspect signaturerbr,r&rget_type_hints parametersvalueskindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORDrrprnamercdefaultrNrrrRequestrr OAuthProfile OAuthTokenr"_get_valid_oauth_info_from_sessionr r#replacerar`rritemsrfisclass issubclassrrcheck_all_files_in_cache_datatargetrr emptyr]r^)r/r-r event_datarrrr& type_hintspositional_argsparamprogress_indexevent_data_indexcomponent_prop_indicesr type_hintr oauth_info oauth_profile oauth_token header_name header_valuekvs rB special_argsrs40,%%b) 1%%b)JO%%,,. ::e33U5P5PQ Q u%/No.NN5::. emmX . .N! a/"  u - -! a/" 6>>8FNN+CD D! a)"     %   t #         !08 #EEgN %*<*v;? ,FIMM!\2':!  **9i00 !j&< 99*:J:JK a:+<+N>N!OP'=! 9%- **900 " ) )! ,!o!:N+%(?C ;Oo! MM ,1CF WXHX MM!]] +E/F&kC00F A#&E}} + GH d# emm,&kC00 )r5rr)rs rBrr\s=8"F:#y!-~#y MrDc SXS.$)zt A special function that can be returned from a Gradio function to set the validation error of an output component. validate)ris_validmessager>)rrs rBrrs # MMrDc SS0$)a A special function that can be returned from a Gradio function to skip updating the output component. This may be useful when you want to update the output component conditionally, and in some cases, you want to skip updating the output component. If you have multiple output components, you can return `gr.skip()` as part of a tuple to skip updating a specific output component, or you can return a single `gr.skip()` to skip updating all output components. rrr>r>rDrBskiprs  !!rDc "SSKJn URRS5nURRS5nUbUc/US;a [ U5 gUS:Xa[ R"U5 gURRUUUUUUS9 g)Nr)r)infosuccesswarning)rvlogtitleleveldurationr)) gradio.contextrrurrvrr]r^rw log_message)rrrrr)rrurvs rBrrs,  $ $T *F$$((.H ~) ' ' 'N i  MM' " MM  rDmodals)documentation_groupc[XSXS9 g)a This function allows you to pass custom warning messages to the user. You can do so simply by writing `gr.Warning('message here')` in your function, and when that line is executed the custom message will appear in a modal on the demo. The modal is yellow by default and has the heading: "Warning." Queue must be enabled for this behavior; otherwise, the warning will be printed to the console using the `warnings` library. Demos: blocks_chained_events Parameters: message: The warning message to be displayed to the user. Can be HTML, which will be rendered in the modal. duration: The duration in seconds that the warning message should be displayed for. If None or 0, the message will be displayed indefinitely until the user closes it. visible: Whether the error message should be displayed in the UI. title: The title to be displayed to the user at the top of the modal. Example: import gradio as gr def hello_world(): gr.Warning('This is a warning message.') return "hello world" with gr.Blocks() as demo: md = gr.Markdown() demo.load(hello_world, inputs=None, outputs=[md]) demo.launch() rrrrr)Nrrrr)rs rBWarningrs2IrDc[XSXS9 g)aN This function allows you to pass custom info messages to the user. You can do so simply by writing `gr.Info('message here')` in your function, and when that line is executed the custom message will appear in a modal on the demo. The modal is gray by default and has the heading: "Info." Queue must be enabled for this behavior; otherwise, the message will be printed to the console. Demos: blocks_chained_events Parameters: message: The info message to be displayed to the user. Can be HTML, which will be rendered in the modal. duration: The duration in seconds that the info message should be displayed for. If None or 0, the message will be displayed indefinitely until the user closes it. visible: Whether the error message should be displayed in the UI. title: The title to be displayed to the user at the top of the modal. Example: import gradio as gr def hello_world(): gr.Info('This is some info.') return "hello world" with gr.Blocks() as demo: md = gr.Markdown() demo.load(hello_world, inputs=None, outputs=[md]) demo.launch() rrNrrs rBInfors2FXWrDc[XSXS9 g)a; This function allows you to pass custom success messages to the user. You can do so simply by writing `gr.Success('message here')` in your function, and when that line is executed the custom message will appear in a modal on the demo. The modal is green by default and has the heading: "Success." Queue must be enabled for this behavior; otherwise, the message will be printed to the console. Parameters: message: The success message to be displayed to the user. Can be HTML, which will be rendered in the modal. duration: The duration in seconds that the success message should be displayed for. If None or 0, the message will be displayed indefinitely until the user closes it. visible: Whether the error message should be displayed in the UI. title: The title to be displayed to the user at the top of the modal. Example: def hello_world(): gr.Success('Operation completed successfully!') return "hello world" with gr.Blocks() as demo: md = gr.Markdown() demo.load(hello_world, inputs=None, outputs=[md]) demo.launch() rrNrrs rBSuccessrs.IrD)NNNNr FNNFTTrrNF)(r,rr-rr.rr/rr0rr1rr2rr3rr4rr5rr6rr7rr8rr9rr:rr;rr<rr(rr)rr*r)rzSequence[Component]rrerrer)rr rzMutableMapping[str, Any])NNNNN)r/rr-zlist[Any] | Nonerr!rzEventData | Nonerz dict[int, dict[str, Any]] | Nonerzoauth.OAuthToken | Nonerz.tuple[list, int | None, int | None, list[int]])NNN) r5rrzlist[str] | str | Noner)zbool | Literal['hidden'] | Nonerr rzdict[str, Any])rrrrg)rr)rr T) rrgrrgrz%Literal['info', 'warning', 'success']rrJr)r)zWarning issued.r Tr)rrgrrJr)rrrg)z Info issued.r Tr)zSuccess.r Tr)Rr& __future__rrrzrmrr_rr.r]collections.abcrrrr functoolsrpathlibr threadingr typesr typingr r rrr gradio_clientrrgradio_client.documentationrrwrrrrgradio.cachingrrrrrrgradio.data_classesrrrrrgradio.exceptionsr gradio.flaggingr! gradio.i18nr"gradio.route_utilsr# gradio.utilsr$gradio.componentsr&rjrCr?rr?rNrPrrrrrrrrrrr>rDrBr s#  HH!DD/0EE3DD</#% %*+  7;"&26#'CQ)37#0&(,(,$%+0/0 +040  0  0 0 000 !00000A00 1!0" #0&%'0(&)0*"+0f aa aH###7;#EI#L!!( *fa=xa=a=HA%H 6, $%)#'8<%) SRSR SR#SR! SR 6 SR # SR4SRn+//3# #(#-# #  #L N N " "4:    1   : h'$    (: h'! X XXX  X(X6 h'    (rD