§
    _÷#dŸ  ã                   ó  — d Z ddlZddlZddlZddlZddlZddlmZ ddlm	Z	m
Z
mZmZmZmZmZ ddlmZ ddlmZ ddlmZ ddlmZmZ dd	lmZmZ dd
lmZ ddlmZ ddl m!Z! g d¢Z"d+dede#de$ddfd„Z%d+dede#de$ddfd„Z&de#de#ddfd„Z'd,dede
de#de
ddf
d„Z(de#de
fd„Z) G d„ d ¦  «        Z* G d!„ d"ej+        ¦  «        Z, G d#„ d$¦  «        Z- ej.        d%¦  «        Z/d-d&e#d'ee#         dee#ddf         fd(„Z0de#de#fd)„Z1d*„ Z2dS ).zSphinx test suite utilitiesé    N)ÚStringIO)ÚIOÚAnyÚDictÚ	GeneratorÚListÚOptionalÚPattern)ÚElementTree)Únodes)ÚNode)Ú
directivesÚroles)ÚapplicationÚlocale)ÚModuleAnalyzer©Úpath)Úrelpath)ÚStructÚSphinxTestAppÚ#SphinxTestAppWrapperForSkipBuildingÚregexÚtextÚflagsÚreturnc                 óZ   — t          j        | ||¦  «        st          | ›d|›�¦  «        ‚d S )Nz did not match ©ÚreÚsearchÚAssertionError©r   r   r   s      ú5/usr/lib/python3/dist-packages/sphinx/testing/util.pyÚassert_re_searchr$      s>   € ÝŒ9�U˜D %Ñ(Ô(ð DÝ°e°e°e¸T¸TÐBÑCÔCÐCðDð Dó    c                 óZ   — t          j        | ||¦  «        rt          | ›d|›�¦  «        ‚d S )Nz did match r   r"   s      r#   Úassert_not_re_searchr'      s>   € Ý	„y�˜˜eÑ$Ô$ð @Ý°%°%°%¸¸Ð>Ñ?Ô?Ð?ð@ð @r%   ÚthingÚprefixc                 óX   — |                       |¦  «        st          | ›d|›�¦  «        ‚d S )Nz does not start with )Ú
startswithr!   )r(   r)   s     r#   Úassert_startswithr,   #   s>   € Ø×Ò˜FÑ#Ô#ð LÝ¸E¸E¸EÀ6À6ÐJÑKÔKÐKðLð Lr%   Ú ÚnodeÚclsÚxpathÚkwargsc                 óü  — |�rôt          |t          ¦  «        rÌt          | |d         fd|i|¤Ž |dd …         rªt          |d         t          ¦  «        rt          | |d         fd|i|¤Ž �nŒt          | t          j        ¦  «        sJ d|z  ¦   «         ‚t          | ¦  «        dk    sJ d|t          | ¦  «        fz  ¦   «         ‚t          | d         |dd …         fd|dz   i|¤Ž �nt          |t          ¦  «        r¬t          | t          t          j        f¦  «        sJ d|z  ¦   «         ‚t          | ¦  «        t          |¦  «        k    s*J d|t          | ¦  «        t          |¦  «        fz  ¦   «         ‚t          |¦  «        D ]#\  }}|d	|z  z   }t          | |         |fd|i|¤Ž Œ$nRt          |t          ¦  «        r| |k    sJ d
|›d|›d| ›�¦   «         ‚n#t          | |¦  «        sJ d|›d|›d| ›�¦   «         ‚|r€t          | t          j        ¦  «        sJ d|z  ¦   «         ‚| 	                    ¦   «         D ]F\  }}|| v sJ d|›d|›d| ›�¦   «         ‚| |         |k    sJ d|›d|›d|›d| |         ›�¦   «         ‚ŒEd S d S )Nr   r0   é   z%The node%s does not have any childrenz&The node%s has %d child nodes, not onez[0]z"The node%s does not have any itemsz%The node%s has %d child nodes, not %rz[%d]z	The node z is not z: zThe nodez is not subclass of z'The node%s does not have any attributesz does not have z attribute: ú[z	] is not )
Ú
isinstanceÚlistÚassert_nodeÚtupler   ÚElementÚlenÚ	enumerateÚstrÚitems)	r.   r/   r0   r1   ÚiÚnodeclsr   ÚkeyÚvalues	            r#   r7   r7   (   sV  € Ø
ñ LÝ�c�4Ñ Ô ð 	LÝ˜˜c !œfÐ<Ð<¨EÐ<°VÐ<Ð<Ð<Ø�1�2�2Œwð QÝ˜c !œf¥eÑ,Ô,ð QÝ  c¨!¤fÐDÐD°EÐD¸VÐDÐDÐDÑDå% d­E¬MÑ:Ô:ð Hð HØ?À%ÑGñHô Hð Hå˜t™9œ9¨š>˜>˜>Ø@ÀEÍ3ÈtÉ9Ì9ÐCUÑUñ *œ>˜>å  Q¤¨¨Q¨R¨R¬ÐPÐP¸À¹ÐPÈÐPÐPÐPùÝ˜�UÑ#Ô#ð 	LÝ˜d¥T­5¬=Ð$9Ñ:Ô:ð =ð =Ø4°uÑ<ñ=ô =ð =å�t‘9”9¥ C¡¤Ò(Ð(Ð(Ø7¸5Å#ÀdÁ)Ä)ÍSÐQTÉXÌXÐ:VÑVñ )Ô(Ð(å'¨™nœnð Dð D‘
��7Ø˜v¨™zÑ)�Ý˜D œG WÐCÐC°DÐC¸FÐCÐCÐCÐCðDõ ˜�SÑ!Ô!ð 	LØ˜3’;�;�;�;¸u¸u¸uÀcÀcÀcÈ4È4Ð P‘;”;�;�;å˜d CÑ(Ô(ð Lð Lð LØ:?¸%¸%ÀÀÀÀdÀdÐKñLô Lð Lð ð PÝ˜$¥¤Ñ.Ô.ð 	>ð 	>Ø5¸Ñ=ñ	>ô 	>ð 	>ð !Ÿ,š,™.œ.ð 	Pð 	P‰JˆC�Ø˜$�;�;�;�;Ø?D¸u¸uÀcÀcÀcÈ4È4ÐPñ ”;�;à˜”9 Ò%Ð%Ð%Ð%Ø27°%°%¸¸¸¸e¸e¸eÀTÈ#ÄYÀYÐOñ &Ô%Ð%Ð%ðPð Pð	Pð 	Pr%   r   c                 ó¾   — t          j        d¬¦  «        5  t          j        dt          ¬¦  «         t	          j        | ¦  «        cd d d ¦  «         S # 1 swxY w Y   d S )NF)ÚrecordÚignore)Úcategory)ÚwarningsÚcatch_warningsÚfilterwarningsÚDeprecationWarningr   Úparser   s    r#   Úetree_parserK   N   sŸ   € Ý	Ô	 ¨Ð	.Ñ	.Ô	.ð 'ð 'ÝÔ Õ3EÐFÑFÔFÐFÝÔ  Ñ&Ô&ð'ð 'ð 'ð 'ñ 'ô 'ð 'ð 'ð 'ð 'ð 'ð 'øøøð 'ð 'ð 'ð 'ð 'ð 's   –/AÁAÁAc                   ó   — e Zd Zdeddfd„ZdS )r   r1   r   Nc                 ó:   — | j                              |¦  «         d S ©N)Ú__dict__Úupdate)Úselfr1   s     r#   Ú__init__zStruct.__init__U   s   € ØŒ×Ò˜VÑ$Ô$Ð$Ð$Ð$r%   )Ú__name__Ú
__module__Ú__qualname__r   rR   © r%   r#   r   r   T   s6   € € € € € ð% ð %¨ð %ð %ð %ð %ð %ð %r%   r   c                   óú   ‡ — e Zd ZU dZeed<   eed<   	 	 	 	 	 	 	 	 	 	 dded	ee         d
ee         de	dee
         dee         dee         deee                  dee         deddfˆ fd„Zdde	ddfd„Zdefd„Zˆ xZS )r   zŠ
    A subclass of :class:`Sphinx` that runs on the test root, with some
    better default values for the initialization parameters.
    Ú_statusÚ_warningÚhtmlNFr   ÚbuildernameÚsrcdirÚbuilddirÚfreshenvÚconfoverridesÚstatusÚwarningÚtagsÚdocutilsconfÚparallelr   c                 ó¶  •— |	�|dz                        |	¦  «         |€|dz  }|}|                     |¦  «        }|                     d¬¦  «         |                     d¦  «        }|                     d¬¦  «         |€i }d}t          j        d d …         | _        t          j                             ¦   «         | _	        t          j                             ¦   «         | _        d„ t          t          j        ¦  «        D ¦   «         | _        	 t#          ¦   «                              ||||||||||||
¬¦  «         d S # t&          $ r |                      ¦   «          ‚ w xY w)	Nzdocutils.confÚ_buildT)Úexist_okÚdoctreesFc                 ó<   — h | ]}|                      d ¦  «        ¯|’ŒS )Úvisit_)r+   )Ú.0Úvs     r#   ú	<setcomp>z)SphinxTestApp.__init__.<locals>.<setcomp>‚   s8   € ð #>ð #>ð #>¨Ø&'§l¢l°8Ñ&<Ô&<ð#> 1ð #>ð #>ð #>r%   )rd   )Ú
write_textÚjoinpathÚmakedirsÚsysr   Ú_saved_pathr   Ú_directivesÚcopyÚ_saved_directivesr   Ú_rolesÚ_saved_rolesÚdirr   ÚGenericNodeVisitorÚ_saved_nodeclassesÚsuperrR   Ú	ExceptionÚcleanup)rQ   r[   r\   r]   r^   r_   r`   ra   rb   rc   rd   ÚconfdirÚoutdirÚ
doctreedirÚwarningiserrorÚ	__class__s                  €r#   rR   zSphinxTestApp.__init__a   s€  ø€ ð Ð#Ø�oÑ%×1Ò1°,Ñ?Ô?Ð?àÐØ Ñ(ˆHàˆØ×"Ò" ;Ñ/Ô/ˆØ�Š ˆÑ&Ô&Ð&Ø×&Ò& zÑ2Ô2ˆ
Ø×Ò TÐÑ*Ô*Ð*ØÐ ØˆMØˆåœ8 A A Aœ;ˆÔÝ!+Ô!7×!<Ò!<Ñ!>Ô!>ˆÔÝ!œL×-Ò-Ñ/Ô/ˆÔð#>ð #>­cµ%Ô2JÑ.KÔ.Kð #>ñ #>ô #>ˆÔð	Ý‰GŒG×Ò˜V W¨f°jØ(¨-¸ÀØ% ~°tÀhð ñ Pô Pð Pð Pð Pøõ ð 	ð 	ð 	Ø�LŠL‰NŒNˆNØð	øøøs   Ä	-D8 Ä8 Erh   c                 ó6  — t           j                             ¦   «          t          j                             ¦   «          | j        t          j        d d …<   t          j         	                    dd ¦  «         | j
        t          _        | j        t          _        t!          t"          j        ¦  «        D ]j}|                     d¦  «        rS|| j        vrJt+          t"          j        d|dd …         z   ¦  «         t+          t"          j        d|dd …         z   ¦  «         Œkd S )NÚautodoc_fodderrj   é   Údepart_)r   ÚcacheÚclearr   Útranslatorsrr   rq   r   ÚmodulesÚpopru   r   rs   rw   r   rv   rx   r   ry   r+   rz   Údelattr)rQ   rh   Úmethods      r#   r}   zSphinxTestApp.cleanup�   sø   € ÝÔ×"Ò"Ñ$Ô$Ð$ÝÔ× Ò Ñ"Ô"Ð"ØÔ&�Œ���‰ÝŒ�ŠÐ(¨$Ñ/Ô/Ð/Ø!%Ô!7�
ÔØÔ(�ŒÝ�%Ô2Ñ3Ô3ð 	Jð 	JˆFØ× Ò  Ñ*Ô*ð JØ˜TÔ4Ð4Ð4Ý�Ô0°(¸VÀAÀBÀB¼ZÑ2GÑHÔHÐHÝ�Ô0°)¸fÀQÀRÀR¼jÑ2HÑIÔIÐIøð		Jð 	Jr%   c                 ó<   — d| j         j        ›d| j        j        ›d�S )Nú<z buildername=ú>)r‚   rS   ÚbuilderÚname)rQ   s    r#   Ú__repr__zSphinxTestApp.__repr__š   s%   € € Ø(,¬Ô(?Ð(?Ð(?ÀÄÔARÐARÐARÐSÐSr%   )
rZ   NNFNNNNNr   )F)rS   rT   rU   Ú__doc__r   Ú__annotations__r<   r	   r   Úboolr   r   r   ÚintrR   r}   r“   Ú__classcell__)r‚   s   @r#   r   r   Y   sh  ø€ € € € € € ðð ð ÐÐÑØÐÐÑð "Ø!%Ø#'ØØ(,Ø#Ø $Ø$(Ø&*Øð*ð *àð*ð ˜”ð*ð ˜4”.ð	*ð
 ð*ð   ”~ð*ð ˜”ð*ð ˜"”ð*ð �t˜C”yÔ!ð*ð ˜s”mð*ð ð*ð 
ð*ð *ð *ð *ð *ð *ðXJð J ð J°ð Jð Jð Jð JðT˜#ð Tð Tð Tð Tð Tð Tð Tð Tr%   r   c                   óF   — e Zd ZdZdeddfd„Zdedefd„Zded	eddfd
„Z	dS )r   zª
    This class is a wrapper for SphinxTestApp to speed up the test by skipping
    `app.build` process if it is already built and there is even one output
    file.
    Úapp_r   Nc                 ó   — || _         d S rN   )Úapp)rQ   rš   s     r#   rR   z,SphinxTestAppWrapperForSkipBuilding.__init__¥   s   € ØˆŒˆˆr%   r’   c                 ó,   — t          | j        |¦  «        S rN   )Úgetattrrœ   )rQ   r’   s     r#   Ú__getattr__z/SphinxTestAppWrapperForSkipBuilding.__getattr__¨   s   € Ý�t”x Ñ&Ô&Ð&r%   Úargsr1   c                 ój   — | j         j                             ¦   «         s | j         j        |i |¤Ž d S d S rN   )rœ   r   ÚlistdirÚbuild)rQ   r    r1   s      r#   r£   z)SphinxTestAppWrapperForSkipBuilding.build«   sC   € ØŒxŒ×&Ò&Ñ(Ô(ð 	,àˆDŒHŒN˜DÐ+ FÐ+Ð+Ð+Ð+Ð+ð	,ð 	,r%   )
rS   rT   rU   r”   r   rR   r<   r   rŸ   r£   rV   r%   r#   r   r   ž   s‹   € € € € € ðð ð˜]ð ¨tð ð ð ð ð' ð '¨ð 'ð 'ð 'ð 'ð,˜3ð ,¨#ð ,°$ð ,ð ,ð ,ð ,ð ,ð ,r%   r   zu(".*?")|u(\'.*?\')ÚrootÚsuffixc              #   ó´   ‡K  — t          j        | d¬¦  «        D ]=\  }}}t          |¦  «        }ˆfd„|D ¦   «         D ]}||z  }t          || ¦  «        V — ŒŒ>d S )NT)Úfollowlinksc                 óB   •— g | ]}‰r|                      ‰¦  «        ¯|‘ŒS rV   )Úendswith)rk   Úfr¥   s     €r#   ú
<listcomp>zfind_files.<locals>.<listcomp>¸   s/   ø€ ÐGÐGÐG˜¨&ÐG°A·J²J¸vÑ4FÔ4FÐG�!ÐGÐGÐGr%   )ÚosÚwalkr   r   )r¤   r¥   ÚdirpathÚ_dirsÚfilesrª   Úfpaths    `     r#   Ú
find_filesr²   µ   s‹   øè è € Ý!#¤¨¸4Ð!@Ñ!@Ô!@ð 'ð 'Ñˆ�˜Ý�w‘-”-ˆØGÐGÐGÐG˜UÐGÑGÔGð 	'ð 	'ˆAØ˜a‘KˆEÝ˜% Ñ&Ô&Ð&Ð&Ð&Ð&ð	'ð'ð 'r%   c                 ó.   — t          j        dd| ¦  «        S )Nz.*?mr-   )r   Úsub)r   s    r#   Ústrip_escseqrµ   ½   s   € ÝŒ6�*˜b $Ñ'Ô'Ð'r%   c                 óF   ‡ — t          j        ‰ ¦  «        ˆ fd„¦   «         }|S )zA
    A simple decorator that does nothing, for tests to use.
    c                  ó   •—  ‰| i |¤ŽS rN   rV   )r    r1   rª   s     €r#   Úwrapperz!simple_decorator.<locals>.wrapperÅ   s   ø€ àˆq�$Ð!˜&Ð!Ð!Ð!r%   )Ú	functoolsÚwraps)rª   r¸   s   ` r#   Úsimple_decoratorr»   Á   s8   ø€ õ „_�QÑÔð"ð "ð "ð "ñ Ôð"à€Nr%   )r   )Nr-   rN   )3r”   r¹   r¬   r   rq   rF   Úior   Útypingr   r   r   r   r   r	   r
   Ú	xml.etreer   Údocutilsr   Údocutils.nodesr   Údocutils.parsers.rstr   r   Úsphinxr   r   Úsphinx.pycoder   Úsphinx.testing.pathr   Úsphinx.util.osutilr   Ú__all__r<   r—   r$   r'   r,   r7   rK   r   ÚSphinxr   r   ÚcompileÚ_unicode_literals_rer²   rµ   r»   rV   r%   r#   ú<module>rÊ      sb  ðØ !Ð !Ø Ð Ð Ð Ø 	€	€	€	Ø 	€	€	€	Ø 
€
€
€
Ø €€€Ø Ð Ð Ð Ð Ð Ø DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DÐ DØ !Ð !Ð !Ð !Ð !Ð !à Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 2Ð 2Ð 2Ð 2Ð 2Ð 2Ð 2Ð 2à &Ð &Ð &Ð &Ð &Ð &Ð &Ð &Ø (Ð (Ð (Ð (Ð (Ð (Ø $Ð $Ð $Ð $Ð $Ð $Ø &Ð &Ð &Ð &Ð &Ð &ðð ð €ð
Dð D˜Gð D¨3ð D°sð DÀ4ð Dð Dð Dð Dð
@ð @ ð @¨sð @¸3ð @Àtð @ð @ð @ð @ð
L˜Sð L¨#ð L°$ð Lð Lð Lð Lð
#Pð #P�dð #P ð #P°Cð #PÈð #PÐPTð #Pð #Pð #Pð #PðL'�cð '˜cð 'ð 'ð 'ð 'ð%ð %ð %ð %ð %ñ %ô %ð %ð
BTð BTð BTð BTð BT�KÔ&ñ BTô BTð BTðJ,ð ,ð ,ð ,ð ,ñ ,ô ,ð ,ð( "�r”zÐ"8Ñ9Ô9Ð ð'ð '�Sð ' (¨3¤-ð '¸9ÀSÈ$ÐPTÀ_Ô;Uð 'ð 'ð 'ð 'ð(�sð (˜sð (ð (ð (ð (ðð ð ð ð r%   