§
    _÷#dE  ã                   ó¬  — d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlm	Z	m
Z
mZmZmZmZ ddlZddlmZ ddlmZmZ d	d
gZd„ Z ej        d¬¦  «        dee         fd„¦   «         Z G d„ d¦  «        Zej        de	dededededeeef         fd„¦   «         Zej        de	defd„¦   «         Z ej        d¬¦  «        dedeeef         de
dedeeddf         f
d„¦   «         Z ej        d¬¦  «        dedefd„¦   «         Z ej        d¬¦  «        dedefd„¦   «         Z ej        ¦   «         ded e	dee
ddf         fd!„¦   «         Z ej        defd"„¦   «         Z! ej        d#d$¬%¦  «        d.d&„¦   «         Z"ej        deddfd'„¦   «         Z# ej        d¬¦  «        d(e	dd)fd*„¦   «         Z$ej        d+edd)fd,„¦   «         Z%ej        d-„ ¦   «         Z&dS )/zSphinx test fixtures for pytesté    N)Ú
namedtuple)ÚStringIO)ÚPIPE)ÚAnyÚCallableÚDictÚ	GeneratorÚOptionalÚTuple)Úutil)ÚSphinxTestAppÚ#SphinxTestAppWrapperForSkipBuildingz¢sphinx(builder, testroot=None, freshenv=False, confoverrides=None, tags=None, docutilsconf=None, parallel=0): arguments to initialize the sphinx test application.z0test_params(shared_result=...): test parameters.c                 óF   — t           D ]}|                      d|¦  «         ŒdS )zRegister custom markersÚmarkersN)ÚDEFAULT_ENABLED_MARKERSÚaddinivalue_line)ÚconfigÚmarkers     ú9/usr/lib/python3/dist-packages/sphinx/testing/fixtures.pyÚpytest_configurer      s4   € å)ð 3ð 3ˆØ×Ò 	¨6Ñ2Ô2Ð2Ð2ð3ð 3ó    Úsession)ÚscopeÚreturnc                  ó   — d S ©N© r   r   r   Úrootdirr      s   € àˆ4r   c                   ór   — e Zd ZU i Zeeeeef         f         ed<   dededefd„Z	dedeee
f         fd„ZdS )ÚSharedResultÚcacheÚkeyÚapp_r   c                 ó–   — || j         v rd S |j                             ¦   «         |j                             ¦   «         dœ}|| j         |<   d S )N©ÚstatusÚwarning)r!   Ú_statusÚgetvalueÚ_warning)Úselfr"   r#   Údatas       r   ÚstorezSharedResult.store&   sS   € Ø�$”*ÐÐØˆFà”l×+Ò+Ñ-Ô-Ø”}×-Ò-Ñ/Ô/ð
ð 
ˆð ˆŒ
�3‰ˆˆr   c                 óˆ   — || j         vri S | j         |         }t          |d         ¦  «        t          |d         ¦  «        dœS )Nr&   r'   r%   )r!   r   )r+   r"   r,   s      r   ÚrestorezSharedResult.restore/   sL   € Ø�d”jÐ Ð ØˆIØŒz˜#Œˆå˜t Hœ~Ñ.Ô.Ý  Y¤Ñ0Ô0ð
ð 
ð 	
r   N)Ú__name__Ú
__module__Ú__qualname__r!   r   ÚstrÚ__annotations__r   r   r-   r   r/   r   r   r   r    r    #   sŒ   € € € € € € Ø')€Eˆ4��T˜#˜s˜(”^Ð#Ô$Ð)Ð)Ñ)ð˜ð  Mð °cð ð ð ð ð
˜3ð 
 4¨¨X¨Ô#6ð 
ð 
ð 
ð 
ð 
ð 
r   r    ÚrequestÚtest_paramsÚshared_resultÚsphinx_test_tempdirr   c                 óþ  ‡— i Ši }t          t          | j                             d¦  «        ¦  «        ¦  «        D ];}t	          |j        ¦  «        D ]
\  }}|‰|<   Œ|                     |j        ¦  «         Œ<ˆfd„t          ‰ 	                    ¦   «         ¦  «        D ¦   «         }	|d         rSd|v rt          j        d¦  «        ‚|d         |d<   |                     |d         ¦  «        }
|                     |
¦  «         |                     dd¦  «        }||                     d|¦  «        z  x|d<   }|r1|                     ¦   «         s|d|z   z  }|                     |¦  «          t#          d	d
¦  «        |	|¦  «        S )zp
    Parameters that are specified by 'pytest.mark.sphinx' for
    sphinx.application.Sphinx initialization
    Úsphinxc                 ó    •— g | ]
}‰|         ‘ŒS r   r   )Ú.0ÚiÚpargss     €r   ú
<listcomp>zapp_params.<locals>.<listcomp>L   s   ø€ Ð3Ð3Ð3˜ˆE�!ŒHÐ3Ð3Ð3r   r7   Úsrcdirz:You can not specify shared_result and srcdir in same time.ÚtestrootÚrootztest-Ú
app_paramszargs,kwargs)ÚreversedÚlistÚnodeÚiter_markersÚ	enumerateÚargsÚupdateÚkwargsÚsortedÚkeysÚpytestÚ	Exceptionr/   ÚpopÚgetÚexistsÚcopytreer   )r5   r6   r7   r8   r   rK   Úinfor=   ÚarI   r/   rA   r@   Útestroot_pathr>   s                 @r   rC   rC   9   s¤  ø€ ð €EØ€Fõ �˜gœl×7Ò7¸ÑAÔAÑBÔBÑCÔCð #ð #ˆÝ˜dœiÑ(Ô(ð 	ð 	‰DˆAˆqØˆE�!‰HˆHØ�Š�d”kÑ"Ô"Ð"Ð"à3Ð3Ð3Ð3�f U§Z¢Z¡\¤\Ñ2Ô2Ð3Ñ3Ô3€Dð �?Ô#ð Ø�vÐÐÝÔ"ð $:ñ ;ô ;ð ;à& Ô7ˆˆxÑØ×'Ò'¨°OÔ(DÑEÔEˆØ�Š�gÑÔÐð �zŠz˜* fÑ-Ô-€HØ 3°f·j²jÀÈ8Ñ6TÔ6TÑ TÐT€Fˆ8Ñ�vð ð '�v—}’}‘”ð 'Ø 7¨XÑ#5Ñ6ˆØ×Ò˜vÑ&Ô&Ð&à2�:�l MÑ2Ô2°4¸Ñ@Ô@Ð@r   c                 óð   — | j                              d¦  «        }|r|j        ni }ddi}|                     |¦  «         |d         r/t	          |d         t
          ¦  «        st          j        d¦  «        ‚|S )au  
    Test parameters that are specified by 'pytest.mark.test_params'

    :param Union[str] shared_result:
       If the value is provided, app._status and app._warning objects will be
       shared in the parametrized test functions and/or test functions that
       have same 'shared_result' value.
       **NOTE**: You can not specify both shared_result and srcdir.
    r6   r7   Nz@You can only provide a string type of value for "shared_result" )rF   Úget_closest_markerrK   rJ   Ú
isinstancer3   rN   rO   )r5   ÚenvrK   Úresults       r   r6   r6   d   s‹   € ð Œ,×
)Ò
)¨-Ñ
8Ô
8€CØÐ&ˆSŒZˆZ B€Fà˜ð€Fð ‡M‚M�&ÑÔÐàˆÔð 7­
°6¸/Ô3JÍCÑ(PÔ(Pð 7ÝÔð  6ñ 7ô 7ð 	7à€Mr   ÚfunctionrC   Úmake_appc              #   óð  K  — |\  }} ||i |¤Ž}|V — t          d|                     dd¦  «        ¦  «         t          d|j        j        ¦  «         t          d|j        ¦  «         t          d|j        ¦  «         t          dd|j                             ¦   «         z   ¦  «         t          d	d|j                             ¦   «         z   ¦  «         | d
         r| 	                    | d
         |¦  «         dS dS )z9
    Provides the 'sphinx.application.Sphinx' object
    z# testroot:rA   rB   z
# builder:z	# srcdir:z	# outdir:z	# status:ú
z
# warning:r7   N)
ÚprintrQ   ÚbuilderÚnamer@   Úoutdirr(   r)   r*   r-   )r6   rC   r]   r7   rI   rK   r#   s          r   Úapprd   |   s  è è € ð �L€Dˆ&Øˆ8�TÐ$˜VÐ$Ð$€DØ
€J€J€Jå	ˆ-˜Ÿš J°Ñ7Ô7Ñ8Ô8Ð8Ý	ˆ,˜œÔ)Ñ*Ô*Ð*Ý	ˆ+�t”{Ñ#Ô#Ð#Ý	ˆ+�t”{Ñ#Ô#Ð#Ý	ˆ+�t˜dœl×3Ò3Ñ5Ô5Ñ5Ñ6Ô6Ð6Ý	ˆ,˜˜tœ}×5Ò5Ñ7Ô7Ñ7Ñ8Ô8Ð8à�?Ô#ð @Ø×Ò˜K¨Ô8¸$Ñ?Ô?Ð?Ð?Ð?ð@ð @r   rd   c                 ó   — | j         S ©zJ
    Back-compatibility for testing with previous @with_app decorator
    )r(   ©rd   s    r   r&   r&   ‘   s   € ð
 Œ;Ðr   c                 ó   — | j         S rf   )r*   rg   s    r   r'   r'   ™   s   € ð
 Œ<Ðr   Úmonkeypatchc              #   óê   ‡ ‡K  — |                      dd„ ¦  «         g Št          j        dd…         }ˆˆ fd„}|V — |t          j        dd…<   t          ‰¦  «        D ]}|                     ¦   «          ŒdS )zÉ
    Provides make_app function to initialize SphinxTestApp instance.
    if you want to initialize 'app' in your test function. please use this
    instead of using SphinxTestApp class directory.
    zsphinx.application.abspathc                 ó   — | S r   r   )Úxs    r   ú<lambda>zmake_app.<locals>.<lambda>¨   s   € À€ r   Nc                  ó  •— t          ¦   «         t          ¦   «         }}|                     d|¦  «         |                     d|¦  «         t          | i |¤Ž}‰                     |¦  «         ‰d         rt	          |¦  «        }|S )Nr&   r'   r7   )r   Ú
setdefaultr   Úappendr   )rI   rK   r&   r'   r#   Úappsr6   s        €€r   Úmakezmake_app.<locals>.make­   sƒ   ø€ Ý"™*œ*¥h¡j¤j�ˆØ×Ò˜( FÑ+Ô+Ð+Ø×Ò˜) WÑ-Ô-Ð-Ý! 4Ð2¨6Ð2Ð2ˆØ�Š�DÑÔÐØ�Ô'ð 	=Ý6°tÑ<Ô<ˆDØˆr   )ÚsetattrÚsysÚpathrD   Úcleanup)r6   ri   Úsyspathrr   r#   rq   s   `    @r   r]   r]   ¡   s�   øøè è € ð ×ÒÐ4°k°kÑBÔBÐBà€DÝŒh�q�q�qŒk€Gðð ð ð ð ð ð €J€J€Jà…C„HˆQˆQˆQ�KÝ˜‘”ð ð ˆØ�Š‰Œˆˆðð r   c                  ó   — t          ¦   «         S r   )r    r   r   r   r7   r7   ½   s   € å‰>Œ>Ðr   ÚmoduleT)r   Úautousec                  óB   — t           j                             ¦   «          d S r   )r    r!   Úclearr   r   r   Ú_shared_result_cacher}   Â   s   € åÔ×ÒÑÔÐÐÐr   c                 óÌ   — t          | j        dd¦  «        }	 |r%t          j        |dgt          t          ¬¦  «         dS n# t
          $ r Y nw xY wt          j        d¦  «         dS )zt
    The test will be skipped when using 'if_graphviz_found' fixture and graphviz
    dot command is not found.
    Úgraphviz_dotÚ z-V)ÚstdoutÚstderrNzgraphviz "dot" is not available)Úgetattrr   Ú
subprocessÚrunr   ÚOSErrorrN   Úskip)rd   r   s     r   Úif_graphviz_foundrˆ   Ç   s…   € õ ˜3œ: ~°rÑ:Ô:€LðØð 	ÝŒN˜L¨$Ð/½ÅTÐJÑJÔJÐJØˆFð	øõ ð ð ð Øˆðøøøõ „KÐ1Ñ2Ô2Ð2Ð2Ð2s   ˜%A  Á 
AÁAÚtmpdir_factoryz	util.pathc                 óv   — |                       ¦   «         }t          j        |¦  «                             ¦   «         S )z8
    Temporary directory wrapped with `path` class.
    )Úgetbasetempr   ru   Úabspath)r‰   Útmpdirs     r   r8   r8   Ø   s1   € ð
 ×'Ò'Ñ)Ô)€FÝŒ9�VÑÔ×$Ò$Ñ&Ô&Ð&r   r�   c                 ó*   — t          j        | ¦  «        S )z�
    Temporary directory wrapped with `path` class.
    This fixture is for back-compatibility with old test implementation.
    )r   ru   )r�   s    r   Útempdirr�   á   s   € õ Œ9�VÑÔÐr   c               #   óL  K  — 	 t          t          j        ¦  «        } dV — t          t          j        ¦  «        D ]%}|| vrt          j                             |¦  «         Œ&dS # t          t          j        ¦  «        D ]%}|| vrt          j                             |¦  «         Œ&w xY w)zÎ
    Rollback sys.modules to its value before testing to unload modules
    during tests.

    For example, used in test_ext_autosummary.py to permit unloading the
    target module to clear its cache.
    N)rE   rt   ÚmodulesrP   )Ú
sysmodulesÚmodnames     r   Úrollback_sysmodulesr”   ê   s§   è è € ð)Ý�#œ+Ñ&Ô&ˆ
Øˆˆˆå�CœKÑ(Ô(ð 	)ð 	)ˆGØ˜jÐ(Ð(Ý”—’ Ñ(Ô(Ð(øð	)ð 	)ø•t�CœKÑ(Ô(ð 	)ð 	)ˆGØ˜jÐ(Ð(Ý”—’ Ñ(Ô(Ð(øð	)øøøs   „A" Á"AB#)r   N)'Ú__doc__r„   rt   Úcollectionsr   Úior   r   Útypingr   r   r   r	   r
   r   rN   Úsphinx.testingr   Úsphinx.testing.utilr   r   r   r   Úfixturer3   r   r    rC   r6   rd   r&   r'   r]   r7   r}   rˆ   r8   r�   r”   r   r   r   ú<module>rœ      s,  ðØ %Ð %à Ð Ð Ð Ø 
€
€
€
Ø "Ð "Ð "Ð "Ð "Ð "Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ BÐ Bà €€€à Ð Ð Ð Ð Ð Ø RÐ RÐ RÐ RÐ RÐ RÐ RÐ Rð	`ð 7ðÐ ð3ð 3ð 3ð €„�iÐ Ñ Ô ð�˜#”ð ð ð ñ !Ô ðð
ð 
ð 
ð 
ð 
ñ 
ô 
ð 
ð, „ð'A˜ð 'A¨$ð 'A¸|ð 'AØ$'ð'AØ25ð'AØ:?ÀÀdÀ
Ô:Kð'Að 'Að 'Añ „ð'AðT „ð˜ð  ð ð ð ñ „ðð. €„�jÐ!Ñ!Ô!ð@�Tð @ u¨T°4¨ZÔ'8ð @ÀHð @Ø#ð@Ø(1°-ÀÀtÐ2KÔ(Lð@ð @ð @ñ "Ô!ð@ð( €„�jÐ!Ñ!Ô!ð�ð  (ð ð ð ñ "Ô!ðð €„�jÐ!Ñ!Ô!ð�ð  8ð ð ð ñ "Ô!ðð €„ÑÔð˜$ð ¨Sð °Y¸xÈÈtÐ?SÔ5Tð ð ð ñ Ôðð6 „ð�|ð ð ð ñ „ðð €„�h¨Ð-Ñ-Ô-ðð ð ñ .Ô-ðð „ð3˜=ð 3¨Tð 3ð 3ð 3ñ „ð3ð  €„�iÐ Ñ Ô ð'¨ð '°ð 'ð 'ð 'ñ !Ô ð'ð „ð�Cð ˜Kð ð ð ñ „ðð „ð)ð )ñ „ð)ð )ð )r   