Ë
    hYíj·9  ã                  óº   — d Z ddlmZ ddlZddlZddlZddlmZ ddlm	Z	 ddl
mZ  ee«      Zi Zd„ Zd„ Zg d	¢Z ed
¬«      dd„«       Zdddœd„Zdd„Zd„ Zd„ Zy)zNContains methods that generate documentation for Gradio functions and classes.é    )ÚannotationsN)Údefaultdict)ÚCallable)Ú	lru_cachec                 ó   — y)zRA no-op for backwards compatibility of custom components published prior to 4.16.0N© )Úms    ú_C:\Users\Stabi\Downloads\virtual-tryon(1)\venv\Lib\site-packages\gradio_client/documentation.pyÚset_documentation_groupr      s   € àó    c                óŒ  — t        j                  | j                  «      }|j                  d«      D �cg c]  }|j	                  «       ‘Œ }}d }t        |«      D ]5  \  }}|j                  d|z   dz   «      s|j                  d|z   dz   «      sŒ5 n |€t        d|› d| j                  › �«      ‚|j                  d|«      }|j                  d|dz   «      }t        |dz   |«      D ]A  }||   j                  d«      sŒt        d	|› d| j                  › d
�||   z   dz   ||   z   «      ‚ dj                  ||dz   | «      }	|	S c c}w )NÚ
zself.Ú:z =zCould not find z in z"""é   z-Found another attribute before docstring for ú: z
 start:Ú )ÚinspectÚ	getsourceÚ__init__ÚsplitÚstripÚ	enumerateÚ
startswithÚ	NameErrorÚ__name__ÚindexÚrangeÚ
ValueErrorÚjoin)
ÚclsÚattrÚcodeÚlineÚlinesÚiÚ
start_lineÚend_lineÚjÚ
doc_strings
             r
   Úextract_instance_attr_docr*      s^  € Ü×Ñ˜SŸ\™\Ó*€DØ&*§j¡j°Ô&6Ó7Ñ&6˜dˆT�Z‰Z�\Ð&6€EÐ7Ø€AÜ˜UÖ#‰ˆˆ4Ø�?‰?˜7 T™>¨CÑ/Ô0°D·O±OØ�d‰N˜TÑ!õ5
ñ ð	 $ð
 	€yÜ˜/¨$¨¨t°C·L±L°>ÐBÓCÐCØ—‘˜U AÓ&€JØ�{‰{˜5 *¨q¡.Ó1€HÜ�1�q‘5˜*Ö%ˆØ�‰8×Ñ˜wÕ'ÜØ?À¸vÀTÈ#Ï,É,ÈÐWYÐZØ˜‘(ñàñð ˜‘(ñóð ð &ð —‘˜% 
¨Q¡°Ð:Ó;€JØÐùò) 8s   ³E))zgradio._simple_templatesÚ	component)zgradio.serverÚblock)zgradio.blockr,   )zgradio.chatÚchatinterface)zgradio.componentr+   )zgradio.eventsÚhelpers)zgradio.data_classesr.   )zgradio.exceptionsr.   )zgradio.externalr.   )zgradio.flagÚflagging)zgradio.helpersr.   )zgradio.interfaceÚ	interface)zgradio.layoutÚlayout)zgradio.routeÚroutes)zgradio.themeÚthemes)úgradio_client.z	py-client)zgradio.utilsr.   )zgradio.renderableÚ
renderable)zgradio.validatorsÚ
validators)zgradio.cachingr.   é
   )Úmaxsizec                ód   — t         D ]  \  }}| j                  |«      sŒ|c S  t        d| ›�«      ‚)Nz(No known documentation group for module )Ú_module_prefixesr   r   )ÚmodnameÚprefixÚgroups      r
   Ú_get_module_documentation_groupr>   F   s8   € ç)‰ˆ�Ø×Ñ˜fÕ%ØŠLð *ô Ð?À¸{ÐKÓ
LÐLr   F)ÚinheritÚdocumentation_groupc                ó   ‡ ‡‡— |Šˆˆˆ fd„}|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.
    c                ó¦  •— t        ‰«      }t        | d«      r|| j                  z  }‰r	d t        | <   ‰}‰€O	 t	        j
                  | «      j                  }|j                  d«      s|j                  d«      rt        |«      }n	 t        |   j                  | |f«       | S # t        $ r%}t        j                  d| › d|› �«       Y d }~ŒEd }~ww xY w)NÚEVENTSzgradio.r4   z&Could not get documentation group for r   )ÚlistÚhasattrrC   Úclasses_inherit_documentationr   Ú	getmoduler   r   r>   Ú	ExceptionÚwarningsÚwarnÚclasses_to_documentÚappend)r    Ú	functionsr@   r;   ÚexcÚ_documentation_groupÚfnsr?   s        €€€r
   Ú	inner_doczdocument.<locals>.inner_docZ   sÜ   ø€ Ü˜“Iˆ	Ü�3˜Ô!Ø˜Ÿ™Ñ#ˆIÙØ15Ô)¨#Ñ.à2ÐØÐ'ð
UÜ!×+Ñ+¨CÓ0×9Ñ9�Ø×%Ñ% iÔ0°G×4FÑ4FØ$ô5ô +JÈ'Ó*RÑ'ð ô 	Ð/Ñ0×7Ñ7¸¸iÐ8HÔIØˆ
øô ò UÜ—‘Ð FÀsÀeÈ2ÈcÈUÐS×TÑTûðUús   ¸AB" Â"	CÂ+CÃCr   )r?   r@   rP   rQ   rO   s   ` ` @r
   ÚdocumentrR   N   s   ú€ ð /Ðöð. Ðr   c                ó²  — t        j                  | «      xs d}|j                  d«      }t        j                  | «      }g i g g f\  }}}}d}	d}
d}|D �]  }|j	                  «       }|dk(  rd}	d}Œ|j                  d«      rGd}	d}d	|v sŒ8d
|v sŒ=|j                  d	«      d   j                  d
«      d   }||j                  k7  sŒsd}	Œv|dk(  rd}	d}Œ€|	dk(  r$|j                  |j                  «       r|nd«       Œ©|j                  d«      s|j                  «       dk(  st        |«       |j                  d«      s.|j                  «       dk(  st        d| j                  › d|› �«      ‚|dd }|	dk(  rÉd|v rX|j                  d«      sG|j                  d«      }|dk  rt        d| j                  › d|› �«      ‚|d| }
||dz   d }|||
<   d}�Œ}|
s�Œ�|j                  «       s�Œ“|€%t        |«      t        |j                  «       «      z
  }|dkD  r|j                  d|z  «      r||d }||
xx   d|z   z  cc<   �Œê|	dk(  r|j                  |«       �Œ|	dk(  s�Œ	|j                  |«       �Œ dj                  |«      }g }|j                  j!                  «       D ]ý  \  }}|j                  d«      rŒ|dk(  rŒ|dv r||vrŒ'||j"                  |j%                  |«      dœ}||v r||= |j&                  t         j(                  j*                  k7  r\|j&                  }t-        |t.        «      rd|z   dz   }|j0                  j2                  dk7  r|j0                  j                  › d�}||d <   n|d!   �d"|d!   v rd#|d"<   d$|d!   v rd#|d$<   |j                  |«       Œÿ |rbt5        d| j                  › d%d&j                  |j7                  «       «      › d'd&j                  |j                  j7                  «       «      › �«      ‚t        |«      dk(  ri }n dj                  |«      }|j8                  |d(œ}t        |«      dkD  rdj                  |«      nd}||||fS ))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   ÚdescriptionNzParameters:Ú	parameterzExample:ÚexampleÚ(Ú)r   r   ÚignorezReturns:Úreturnú<br>ú    úDocumentation format for ú has format error in line: é   r   r   éÿÿÿÿé   Ú_Úself)ÚkwargsÚargs)ÚnameÚ
annotationÚdocÚ"Úbuiltinsz()Údefaultri   re   Trf   z# documents nonexistent parameters: z, z. Valid parameters: )rh   ri   )r   Úgetdocr   Ú	signatureÚrstripr   r   rL   r   ÚprintÚSyntaxErrorr   ÚlenÚlstripr   Ú
parametersÚitemsrh   Úgetrl   Ú	ParameterÚemptyÚ
isinstanceÚstrÚ	__class__Ú
__module__r   ÚkeysÚreturn_annotation)Úfnr    Údoc_strÚ	doc_linesrn   rU   rt   ÚreturnsÚexamplesÚmodeÚcurrent_parameterÚbase_indentr#   ÚcÚcolon_indexÚparameter_docÚdescription_docÚparameter_docsÚ
param_nameÚparamrl   Úreturn_docsÚreturn_doc_textÚexamples_docs                           r
   Údocument_fnr‘   t   s“  € ô �n‰n˜RÓ Ò& B€GØ—‘˜dÓ#€IÜ×!Ñ! "Ó%€IØ13°R¸¸R°Ñ.€K�˜W hØ€DØÐØ€KÜˆØ�{‰{‹}ˆØ�=Ò ØˆDØ‰KØ�_‰_˜ZÔ(ØˆDØˆKØ�dŠ{˜s dš{Ø—J‘J˜s“O AÑ&×,Ñ,¨SÓ1°!Ñ4�Ø˜Ÿ™Ó$Ø#‘DØ�ZÒØˆDØ‰Kà�}Ò$Ø×"Ñ"¨4¯:©:¬<¡4¸VÔDØØ—O‘O FÔ+¨t¯z©z«|¸rÒ/AÜ�d”Ø—O‘O FÔ+¨t¯z©z«|¸rÒ/AÜ!Ø/°·±¨}Ð<WÐX\ÐW]Ð^óð ð ˜˜�8ˆDØ�{Ò"Ø˜4‘<¨¯©¸Ô(<Ø"&§*¡*¨TÓ"2�KØ" RÒ'Ü)Ø7¸¿¹°}ÐD_Ð`dÐ_eÐfóð ð )-¨\¨kÐ(:Ð%Ø$(¨°q©Ð):Ð$;�MØ4A�JÐ0Ñ1Ø"&’KÛ&¨4¯:©:®<Ø"Ð*Ü&)¨$£i´#°d·k±k³mÓ2DÑ&D˜Ø" Q’¨4¯?©?¸3ÀÑ;LÔ+MØ# K LÐ1˜ØÐ0Ó1°T¸D±[Ñ@Õ1Ø˜Ò!Ø—‘˜tÖ$Ø˜Ô"Ø—‘ Ö%ð] ð^ —h‘h˜{Ó+€OØ€NØ&×1Ñ1×7Ñ7Ö9Ñˆ
�EØ× Ñ  Ô%ØØ˜ÒØØÐ+Ñ+°
À*Ñ0LØàØ×*Ñ*Ø—>‘> *Ó-ñ
ˆð
 ˜Ñ#Ø˜:Ð&Ø�=‰=œG×-Ñ-×3Ñ3Ò3Ø—m‘mˆGÜ˜'¤3Ô'Ø ™-¨#Ñ-�Ø× Ñ ×+Ñ+¨zÒ9Ø$×.Ñ.×7Ñ7Ð8¸Ð;�Ø'.ˆM˜)Ò$Ø˜5Ñ!Ð-Ø˜=¨Ñ/Ñ/Ø*.�˜hÑ'Ø˜ uÑ-Ñ-Ø(,�˜fÑ%Ø×Ñ˜mÕ,ð5 :ñ6 ÜØ'¨¯© }ð 5'Ø'+§y¡y°·±Ó1BÓ'CÐ&Dð E!Ø!%§¡¨9×+?Ñ+?×+DÑ+DÓ+FÓ!GÐ HðJó
ð 	
ô
 ˆ7ƒ|�qÒØ‰àŸ)™) GÓ,ˆà#×5Ñ5Ø"ñ
ˆô +.¨h«-¸!Ò*;�4—9‘9˜XÔ&À€LØ˜N¨K¸ÐEÐEr   c                óÒ  — t        j                  | «      }|€di dfS i }g }d}|j                  d«      D �]0  }|j                  «       }|j	                  d«      rd|vr|d d j                  «       }g ||<   ŒB|j                  d«      d   j	                  d«      rP|j                  d«      s?|d |j                  d«       j                  «       }||j                  d«      d	z   d  }|||<   Œµ|dk(  r$|j                  |j                  «       r|nd
«       ŒÞ|j                  d«      s+|j                  «       rt        d| j                  › d|› �«      ‚||   j                  |dd  «       �Œ3 d|v rdj                  |d   «      }|d= nd }|j                  «       D ]*  \  }	}
t        |
t        «      sŒd
j                  |
«      ||	<   Œ, dj                  |«      j!                  dd
«      }|||fS )NrT   rU   r   r   r   ra   r   r]   rb   r\   r^   r_   r`   rW   )r   rm   r   ro   ÚendswithÚlowerr   r   rL   r   rq   r   r   ru   ry   rD   Úreplace)r    r€   ÚtagsÚdescription_linesr„   r#   ÚtagÚvaluerW   ÚkeyÚvalrU   s               r
   Údocument_clsrœ   ä   sØ  € Ü�n‰n˜SÓ!€GØ€Ø�2�rˆzÐØ€DØÐØ€DØ—‘˜d×#ˆØ�{‰{‹}ˆØ�=‰=˜Ô #¨T¡/Ø˜˜�9—?‘?Ó$ˆDØˆD�ŠJØ�Z‰Z˜‹_˜QÑ×(Ñ(¨Ô-°d·o±oÀfÔ6MØÐ(˜Ÿ™ C›Ð)×/Ñ/Ó1ˆCØ˜Ÿ™ C›¨1Ñ,Ð.Ð/ˆEØˆD�ŠIØ�]Ò"Ø×$Ñ$¨T¯Z©Z¬\¡T¸vÕFà—O‘O FÔ+°4·:±:´<Ü!Ø/°·±¨~Ð=XÐY]ÐX^Ð_óð ð �‰J×Ñ˜d 1 2˜hÖ'ð! $ð" �DÑØ—)‘)˜D ™OÓ,ˆØ�‰OàˆØ—J‘J–L‰ˆˆSÜ�cœ4Õ ØŸ™ CÓ(ˆD�ŠIð !ð —(‘(Ð,Ó-×5Ñ5°d¸FÓC€KØ˜˜gÐ%Ð%r   c                 óP  — i } t         j                  «       D �]F  \  }}g | |<   |D �]5  \  }}t        j                  |«      st	        j
                  |«      r|n|j                  }t        ||«      \  }}}}t        |d«      rxt        |j                  «      rct        |d«      rWt        |j                  «      rBt        |j                  |«      }	t        |j                  |«      }
|	d   |	d   dœ|
d   |
d   dœ}
}	t        |«      \  }}}||j                  |||||g dœ}t        |d«      r@t        |j                  «      r+t        |d«      rt        |j                  «      r
	|d<   
|d<   |D ]Ã  }|j                  d«      }|r!|dd  }t         |«       |«      j                   }nt        ||«      }t        |«      s$t#        |«      }i }i }d}d	|j                  › d
|› �}n't        ||«      \  }}}}|t        |dg «      v r|dd  }d }|rt%        ||«      }|d   j'                  |||i ||||dœ«       ŒÅ | |   j'                  |«       |t(        v s�Œ*|d   t(        |<   �Œ8 �ŒI t         j                  «       D ]Ÿ  \  }}t+        |«      D ]Œ  \  }\  }}t(        j                  «       D ]m  \  }}t        j,                  |«      sŒt/        ||«      sŒ)||k7  sŒ/|D ]:  }t1        |«      }	 t%        ||d   «      |d<   | |   |   d   j'                  |«       Œ< Œo ŒŽ Œ¡ | S # t2        $ r Y Œ/w xY w)NÚ
preprocessÚpostprocessr   rb   )r‰   Ú
return_doc)Úclassrg   rU   r–   rt   r‚   rW   rP   Ú*rT   zgr.Ú.rC   rP   )r   rg   rU   r–   rt   r‚   rW   Úoverride_signaturerg   rU   )rK   ru   r   Ú
isfunctionÚdataclassesÚis_dataclassr   r‘   rE   Úcallablerž   rŸ   rœ   r   r   ÚgetattrÚ__call__rz   r*   rL   rF   r   ÚisclassÚ
issubclassÚdictr   )Údocumentationr„   Ú
class_listr    rP   Úfn_to_documentrc   r‰   r    Úpreprocess_docÚpostprocess_docÚcls_descriptionÚcls_tagsÚcls_exampleÚcls_documentationÚfn_nameÚinstance_attribute_fnr   rŠ   r‹   rŽ   r�   r¤   r%   Úsuper_classÚinherited_fns                             r
   Úgenerate_documentationr»     s€  € Ø€MÜ/×5Ñ5×7ÑˆˆjØ ˆ�dÑÜ"‰HˆC�ô ×%Ñ% cÔ*¬k×.FÑ.FÀsÔ.Kñ à—\‘\ð ô
 /:¸.È#Ó.NÑ+ˆAˆ}˜j¨!ä˜˜\Ô*Ü˜SŸ^™^Ô,Ü˜C Ô/Ü˜SŸ_™_Ô-ä!,¨S¯^©^¸SÓ!A�Ü"-¨c¯o©o¸sÓ"C�ð *8¸Ñ):Ø&4°QÑ&7ñð
 *9¸Ñ);Ø&5°aÑ&8ñð !0�ô 6BÀ#Ó5FÑ2ˆO˜X {àØŸ™Ø.Ø Ø+Ø%Ø&Øñ	!Ðô ˜˜\Ô*Ü˜SŸ^™^Ô,Ü˜C Ô/Ü˜SŸ_™_Ô-à2@Ð! ,Ñ/Ø3BÐ! -Ñ0Û�Ø(/×(:Ñ(:¸3Ó(?Ð%Ù(Ø% a b˜k�Gô !¡£¨Ó0×9Ñ9‘Bä   gÓ.�BÜ ”|Ü&)¨"£g�OØ%'�NØ"$�KØ#%�LØ+.¨s¯|©|¨n¸A¸g¸YÐ)GÑ&ô $ B¨Ó,ñØ'Ø&Ø#Ø$à¤'¨#¨x¸Ó"<Ñ<Ø)7¸¸Ð);˜Ø)-Ð&Ù(Ü&?ÀÀWÓ&M�OØ! %Ñ(×/Ñ/à Ø 'Ø'6Ø "Ø&4Ø#.Ø#/Ø.@ñ	õð7 ðN ˜$Ñ×&Ñ&Ð'8Ô9ØÔ3Ó3Ø5FÀuÑ5MÔ-¨cÓ2òk #ð 8ôp 0×5Ñ5Ö7ÑˆˆjÜ$ ZÖ0‰KˆA‰x��QÜ$A×$GÑ$GÖ$IÑ �˜Sä—O‘O CÕ(Ü" 3¨Õ4Ø˜{Ó*ã(+˜Ü'+¨LÓ'9˜ð!Ü:SØ # \°&Ñ%9ó;˜L¨Ñ7ð
 & dÑ+¨AÑ.¨uÑ5×<Ñ<¸\ÕJñ ),ñ %Jñ 1ð 8ð" Ðøô  *ò !Ù ð!ús   Ë#LÌ	L%Ì$L%)r[   rz   )r   r   r[   z(tuple[str, list[dict], dict, str | None])Ú__doc__Ú
__future__r   r¦   r   rI   Úcollectionsr   Úcollections.abcr   Ú	functoolsr   rD   rK   rF   r   r*   r:   r>   rR   r‘   rœ   r»   r   r   r
   Ú<module>rÁ      s|   ðÙ Tå "ã Û Û Ý #Ý $Ý á! $Ó'Ð Ø "Ð ò	ò
ò2Ð ñ0 �2ÔòMó ðMð !°dô #óLmFò`!&óHkr   