;3h6dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ee Z iZdZdZgd Ze d dd Zd dddZddZdZdZy)zNContains methods that generate documentation for Gradio functions and classes.) annotationsN) defaultdict)Callable) lru_cachecy)zRA no-op for backwards compatibility of custom components published prior to 4.16.0N)ms [/var/www/html/audio-gradio/venv/lib/python3.12/site-packages/gradio_client/documentation.pyset_documentation_groupr sctj|j}|jdDcgc]}|j }}d}t |D]5\}}|j d|zdzs|j d|zdzs5n|td|d|j|jd|}|jd|dz}t|dz|D]A}||j dstd |d|jd ||zd z||zd j||dz|} | Scc}w) N zself.:z =zCould not find z in z"""z-Found another attribute before docstring for : z start: ) inspect getsource__init__splitstrip enumerate startswith NameError__name__indexrange ValueErrorjoin) clsattrcodelinelinesi start_lineend_linej doc_strings r extract_instance_attr_docr*se   S\\ *D&*jj&6 7dTZZ\ 7E 7 AU#4 ??7T>C/ 0DOO dNT !5     y/$tCLL>BCCUA&J{{5*q.1H 1q5* % 8  w '?vT#,,WYZ(( % Q:;J ) 8sE))zgradio._simple_templates component)z gradio.blockblock)z gradio.chat chatinterface)zgradio.componentr+)z gradio.eventshelpers)zgradio.data_classesr.)zgradio.exceptionsr.)zgradio.externalr.)z gradio.flagflagging)zgradio.helpersr.)zgradio.interface interface)z gradio.layoutlayout)z gradio.routeroutes)z gradio.themethemes)gradio_client.z py-client)z gradio.utilsr.)zgradio.renderable renderable )maxsizecdtD]\}}|j|s|cStd|)Nz(No known documentation group for module )_module_prefixesrr)modnameprefixgroups r _get_module_documentation_groupr=Cs=)    f %L ?{K LLr F)inheritdocumentation_groupc|fd}|S)a Defines the @document decorator which adds classes or functions to the Gradio documentation at www.gradio.app/docs. Usage examples: - Put @document() above a class to document the class and its constructor. - Put @document("fn1", "fn2") above a class to also document methods fn1 and fn2. - Put @document("*fn3") with an asterisk above a class to document the instance attribute methods f3. ct}t|dr||jz }r dt|<}O t j |j }|jds|jdr t|}n t|j||f|S#t$r%}tjd|d|Yd}~Ed}~wwxYw)NEVENTSzgradio.r4z&Could not get documentation group for r)listhasattrrBclasses_inherit_documentationr getmodulerrr= Exceptionwarningswarnclasses_to_documentappend)r functionsr?r:exc_documentation_groupfnsr>s r inner_doczdocument..inner_docWsI 3 !  #I 15 )# .2  ' U!++C099%%i0G4F4F$5+J'*R' /077i8HI  U Fse2cUSTT UsAB"" C+C  Cr)r>r?rOrPrNs` ` @r documentrQKs/. r c tj|xsd}|jd}tj|}giggf\}}}}d} |D]} | j } | dk(rd} | j drEd} d| vs4d | vs9| jdd jd d } | |j k7sod } r| d k(rd} z| dk(r$|j| jr| nd| j ds| jdk(s t| | j ds.| jdk(std|j d| | dd} | dk(rE| jd} | dkrtd|j d| | d| } | | dzd}||| <`| dk(r|j| x| dk(s|j| dj|}g}|jjD]\}}|j dr|dk(r|dvr||vr'||j|j!|d}||vr||=|j"tj$j&k7r\|j"}t)|t*rd|zdz}|j,j.dk7r|j,j d}||d <n|d!d"|d!vrd#|d"<d$|d!vrd#|d$<|j||rbt1d|j d%d&j|j3d'd&j|jj3t5|d k(ri}n#t5|d k(r|j6|d d(}ni}t5|d kDrdj|nd}||||fS))a Generates documentation for any function. Parameters: fn: Function to document Returns: description: General description of fn parameters: A list of dicts for each parameter, storing data for the parameter name, annotation and doc return: A dict storing data for the returned annotation and doc example: Code for an example use of the fn r descriptionz Parameters: parameterzExample:example()rrignorezReturns:return
 Documentation format for  has format error in line: Nrr_self)kwargsargs)name annotationdoc"builtinsz()defaultrhrdTrez# documents nonexistent parameters: z, z. Valid parameters: )rgrh)rgetdocr signaturerstriprrrKrprint SyntaxErrorrr parametersitemsrggetrk Parameterempty isinstancestr __class__ __module__rkeyslenreturn_annotation)fnr doc_str doc_linesrmrTrqreturnsexamplesmoder#c colon_indexrU parameter_docdescription_docparameter_docs param_nameparamrk return_docs examples_docs r document_fnrqs nnR &BG d#I!!"%I13RR.KWh D#&{{} = D __Z (Dd{sd{JJsOA&,,S1!4 $#D Z D}$""4::<4VDOOF+tzz|r/Ad OOF+tzz|r/A!/ }>*-  #:& ==G--33 3mmG'3'-#-  ++z9$..778;'.M) $ 5 ! -=//*. h'u--(, f%m,5-6' }5''+yy1B'C&DE!!%9+?+?+D+D+F!G H J   7|q W %.%@%@QRT  *-h-!*;499X&L NK EEr ctj|}|didfSi}g}d}|jdD]0}|j}|j drd|vr|ddj }g||<B|jddj drP|j ds?|d|jdj }||jdd zd}|||<|dk(r$|j|jr|nd |j ds+|jrtd |jd |||j|d d3d|vrdj|d}|d=nd}|jD]*\} } t| tsd j| || <,dj|j!dd } | ||fS)NrSrTrrrr`rr\rar[r]r^r_rV)rrlrrnendswithlowerrrrKrrprrrrrvrCreplace) r r~tagsdescription_linesrr#tagvaluerVkeyvalrTs r document_clsrsnnS!G2rz D D d#({{} == #T/9??$DDJ ZZ_Q  ( ( -doof6M(C)//1CC1,./EDI ] "  $ $TZZ\Tv FOOF+4::<!/ ~=XY]X^_ J  d12h '!("D))DO, OJJL)S c4  C(DI)((,-55dFCK g %%r cPi}tjD]F\}}g||<|D]5\}}tj|st j |r|n |j }t||\}}}}t|drxt|jrct|drWt|jrBt|j|} t|j|} | d| dd| d| dd} } t|\} } } ||j| | ||| gd}t|dr@t|jr+t|drt|jr  |d< |d<|D]}|jd}|r!|dd}t||j }n t||}t|s$t#|}i}i}d}d |jd |}n't||\}}}}|t|d gvr|dd}d}|r t%||}|d j'|||i||||d ||j'||t(vs*|d t(|<8ItjD]\}}t+|D]\}\}}t(jD]m\}}tj,|st/||s)||k7s/|D]:}t1|} t%||d|d<|||d j'|<o|S#t2$rY/wxYw)N preprocess postprocessrra)r return_doc)classrfrTrrqrrVrO*rSzgr..rBrO)r}rfrTrrqrrVoverride_signaturerfrT)rJrrr isfunction dataclasses is_dataclassrrrDcallablerrrrrgetattr__call__rwr*rKrErisclass issubclassdictr) documentationr class_listr rOfn_to_documentrbrrpreprocess_docpostprocess_doccls_descriptioncls_tags cls_examplecls_documentationfn_nameinstance_attribute_fnr}rrrrrr% super_class inherited_fns r generate_documentationrsM/557WNj d"U NHC%%c*k.F.Fs.K\\  /:.#.N +A}j!\*S^^,C/S__-!,S^^S!A"-coos"C*8):&4Q&7 *9);&5a&8 !06B#5F 2OX{ . +%& ! \*S^^,C/S__-2@!,/3B!-0& (/(:(:3(?%(%abkG!099B g.B|&)"gO%'N"$K#%L+.s||nAgY)G&$B, '&#$'#x"<<)7);)-&(&?W&MO!%(// ''6 "&4#.#/.@  7& N $  & &'8 9335Fu5M-c2kU NWNp0557Kj$Z0 KKAxQ$A$G$G$I K SOOC("3 4{*(+K '+L'9 !:S #\&%9;L7 &d+A.u5<<\JK  K KK"  *! !s#L L% $L% )rZrw)r}rrZz(tuple[str, list[dict], dict, str | None])__doc__ __future__rrrrH collectionsrcollections.abcr functoolsrrCrJrEr r*r9r=rQrrrrr r rs|T"#$!$' " 2* 2MM!d#L_FD!&Hkr