a  d(@srdZddlmZddlZddlmZiZiZdaddZ ddZ d d d d Z d ddddZ ddZ ddZdS)zNContains methods that generate documentation for Gradio functions and classes.) annotationsN)CallablecCs|a|tvrgt|<dSN)documentation_groupclasses_to_document)mrd/var/www/html/stable-diffusion-webui/venv/lib/python3.9/site-packages/gradio_client/documentation.pyset_documentation_group sr c Cst|j}dd|dD}d}t|D]0\}}|d|dsX|d|dr,q^q,|dus|Jd|d|j|d |}|d |d }t|d |D]>}||drJd |d|jd ||d ||qd ||d |} | S)NcSsg|] }|qSr)strip).0linerrr z-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 Z start_lineZend_linejZ doc_stringrrr extract_instance_attr_docs.   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"r dt|<tt|f|Sr)classes_inherit_documentationrrappend)rfnsr&rr inner_doc6szdocument..inner_docr)r&r*r+rr)r document+s r,rz(tuple[str, list[dict], dict, str | None])fnreturncCsDt|p d}|d}t|}giggf\}}}}d} |D]j} | } | dkrZd} q>| drd} d| vrd | vr| dd d d } | |jkrd } q>| d krd} q>| dkr|| r| ndq>| ds| dkst | | ds| dksJd|jd| | dd} | dkr| d} | dks\Jd|jd| | d| } | | dd}||| <q>| dkr|| q>| dkr>|| q>d |}g}|j D]\}}|drܐq|dvr||vrq||j||d}||vr||=|jtjjkrn|j}t|tkrHd|d}|jjdkrd|jjd}||d<n:|d durd!|d vrd"|d!<d#|d vrd"|d#<||qt|d ksJd|jd$d |t|d kri}n$t|d kr|j|d d%}ni}t|d kr4d |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()defaultrBr>Tr?z# documents nonexistent parameters: )rArB)rgetdocr signaturerstriprrr(r printrr parametersitemsrAgetrE Parameteremptytypestr __class__ __module__lenkeysreturn_annotation)r-rdoc_strZ doc_linesrGr0rJreturnsZexamplesmoder cZ colon_indexr1 parameter_docdescription_docparameter_docs param_nameparamrE return_docs examples_docrrr document_fn@s                     rac Cst|}|durdidfSi}g}d}|dD]}|}|drjd|vrj|dd}g||<q2|dddr|ds|d|d}||dd d}|||<q2|dkr|| r|nd q2|ds | r Jd |j d ||||d dq2d|vrBd |d}|d=nd}| D]$\} } t | trNd | || <qNd |dd } | ||fS)Nr/r0rrrr;rr7r<r6r8r9r:r2)rrFrrHendswithlowerrrr(r rrrK isinstancelistreplace) rrVtagsZdescription_linesrXr tagvaluer2keyvalr0rrr document_clssB      rlcCsi}tD]B\}}g||<|D]*\}}t|r:|n|j}t||\}}}}t|\} } } ||j| | ||| gd} |D]} | d}|r| dd} t || j }n t || }t |st |}i}i}d}d|jd| }nt||\}}}}d}|r t || }| d|| |i||||dq|||| |tvr"| dt|<q"q tD]\}}t|D]\}\}}tD]}t|rzt||rz||krzt|D]T}t|}zt ||d |d <WnttfyYn0|||d|qqzqjqZ|S) N)classr@r0rgrJrWr2r**rr/zgr..r*)r-r@r0rgrJrWr2override_signaturer@r0)rrKr isfunctionrrarlrrgetattr__call__callablerPr%r(r'risclass issubclassdict ValueErrorAssertionError)Z documentationrXZ class_listrr*Zfn_to_documentr=rZZ return_docZcls_descriptionZcls_tagsZ cls_exampleZcls_documentationfn_nameZinstance_attribute_fnr-r[r\r_r`rpr#Z super_classZ inherited_fnrrr generate_documentations        &r{)__doc__ __future__rrtypingrrr'rr r%r,rarlr{rrrr s  [$