o e(@sldZddlmZddlZddlmZiZiZdaddZ ddZ d d d d Z dddZ ddZ ddZdS)zNContains methods that generate documentation for Gradio functions and classes.) annotationsN)CallablecCs|a|tvr gt|<dSdSN)documentation_groupclasses_to_document)mrKD:\Projects\ConvertPro\env\Lib\site-packages\gradio_client/documentation.pyset_documentation_group s r c Cst|j}dd|dD}d}t|D]\}}|d|ds,|d|dr.nq|dus>Jd|d|j|d |}|d |d }t|d |D]}||drrJd |d|jd ||d ||qSd ||d |} | S)NcSsg|]}|qSr)strip).0linerrr sz-extract_instance_attr_doc.. zself.:z =zCould not find z in z"""z-Found another attribute before docstring for : z start: ) inspect getsource__init__split enumerate startswith__name__indexrangejoin) clsattrcodelinesir start_lineend_linejZ doc_stringrrr extract_instance_attr_docs0   r&F)inheritcsfdd}|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. cs"rdt|<tt|f|Sr)classes_inherit_documentationrrappend)rfnsr'rr inner_doc6szdocument..inner_docr)r'r+r,rr*r document+s r-fnrreturn(tuple[str, list[dict], dict, str | None]cCs,t|pd}|d}t|}giggf\}}}}d} |D]} | } | dkr,d} q| drOd} d| vrNd | vrN| dd d d } | |jkrNd } q| d krVd} q| dkrf|| rb| ndq| dsu| dksut | | ds| dksJd|jd| | dd} | dkr| d} | dksJd|jd| | d| } | | dd}||| <q| dkr|| q| dkr|| qd |}g}|j D]r\}}|drq|dvr||vrq||j||d}||vr||=|jtjjkr,|j}t|tkrd|d}|jjdkr'|jjd}||d<n|d durId!|d vr>d"|d!<d#|d vrId"|d#<||qt|d ksfJd|jd$d |t|d krpi}nt|d kr|j|d d%}ni}t|d krd |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:r/
 Documentation format for  has format error in line: Nrr_)kwargsargs)name annotationdoc"builtinsz()defaultrDr@TrAz# documents nonexistent parameters: )rCrD)rgetdocr signaturerstriprrr)r printrr parametersitemsrCgetrG Parameteremptytypestr __class__ __module__lenkeysreturn_annotation)r.rdoc_strZ doc_linesrIr2rLreturnsZexamplesmoder cZ colon_indexr3 parameter_docdescription_docparameter_docs param_nameparamrG return_docs examples_docrrr document_fn@s                  rcc Cst|}|durdidfSi}g}d}|dD]u}|}|dr5d|vr5|dd}g||<q|dddr_|ds_|d|d}||dd d}|||<q|dkro|| rk|nd q|ds| rJd |j d ||||d dqd|vrd |d}|d=nd}| D]\} } t | trd | || <qd |dd } | ||fS)Nr1r2rrrr=rr9r>r8r:r;r<r4)rrHrrJendswithlowerrrr)r rrrM isinstancelistreplace) rrXtagsZdescription_linesrZr tagvaluer4keyvalr2rrr document_clssD      rncCsi}tD]\}}g||<|D]\}}t|r|n|j}t||\}}}}t|\} } } ||j| | ||| gd} |D]V} | d}|rS| dd} t || j }nt || }t |spt |}i}i}d}d|jd| }n t||\}}}}d}|rt || }| d|| |i||||dq<||| |tvr| dt|<qqtD]O\}}t|D]F\}\}}tD]=}t|rt||r||krt|D](}t|}z t ||d |d <Wn ttfyYnw|||d|qqqq|S) N)classrBr2rirLrYr4r+*rr1zgr..r+)r.rBr2rirLrYr4override_signaturerBr2)rrMr isfunctionrrcrnrrgetattr__call__callablerRr&r)r(risclass issubclassdict ValueErrorAssertionError)Z documentationrZZ class_listrr+Zfn_to_documentr?r\Z return_docZcls_descriptionZcls_tagsZ cls_exampleZcls_documentationfn_nameZinstance_attribute_fnr.r]r^rarbrrr"Z super_classZ inherited_fnrrr generate_documentations       6  r})r.rr/r0)__doc__ __future__rrtypingrrr(rr r&r-rcrnr}rrrr s   [ $