| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/testing/__pycache__/ |
Upload File : |
a
�abA � @ s d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlm Z m
Z
m Z m Z m
Z
ddlZddlmZ ddlmZmZ d d
gZd d � Zejd
d�ed�dd��ZG dd� d�Zeje e eeee
e e f d�dd��Zeje e d�dd��Zejdd�e e
e e f e
ee eddf d�d d ��Z ejdd�eed �d d ��Z ejdd�eed �d!d"��Z e�� e e e e
ddf d#�d$d%��Z ejed�d&d'��Z ejd(d)d*�dd�d+d,��Z!ejedd �d-d.��Z"ejd
d�e d/d0�d1d2��Z#ejed/d3�d4d5��Z$ejd6d7� �Z%dS )8z�
sphinx.testing.fixtures
~~~~~~~~~~~~~~~~~~~~~~~
Sphinx test fixtures for pytest
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
namedtuple)�StringIO)�PIPE)�Any�Callable�Dict� Generator�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 C s t D ]}| �d|� qdS )zRegister custom markers�markersN)�DEFAULT_ENABLED_MARKERSZaddinivalue_line)�configZmarker� r �;/usr/lib/python3.9/site-packages/sphinx/testing/fixtures.py�pytest_configure s r Zsession)�scope)�returnc C s d S �Nr r r r r �rootdir& s r c @ sT e Zd ZU i Zeeeeef f ed< eeed�dd�Z eeee
f d�dd�Z dS ) � SharedResult�cache)�key�app_r c C s2 || j v rd S |j�� |j�� d�}|| j |< d S )N��status�warning)r �_status�getvalue�_warning)�selfr r �datar r r �store. s
�zSharedResult.store)r r c C s2 || j vri S | j | }t|d �t|d �d�S )Nr r r )r r )r! r r" r r r �restore7 s
�zSharedResult.restoreN) �__name__�
__module__� __qualname__r r �str�__annotations__r r r# r r$ r r r r r + s
r )�request� test_params�
shared_result�sphinx_test_tempdirr r c s" t | jd�r| j�d�}n | j�d�}i � i }|durptt|��D ],}t|j�D ]\}} | � |< qP|�|j � qB� fdd�t
� � � �D �}
|d r�d|v r�t �
d��|d |d< |�|d �} |�| � |�d d
�} ||�d| � |d< }
|�r|
�� �s|d | }|�|
� td d
�|
|�S )zp
Parameters that are specified by 'pytest.mark.sphinx' for
sphinx.application.Sphinx initialization
� iter_markersZsphinxNc s g | ] }� | �qS r r )�.0�i�Zpargsr r �
<listcomp>Y � z app_params.<locals>.<listcomp>r, �srcdirz:You can not specify shared_result and srcdir in same time.�testroot�rootztest-�
app_paramsz args,kwargs)�hasattr�noder. �
get_marker�reversed�list� enumerate�args�update�kwargs�sorted�keys�pytest� Exceptionr$ �pop�get�exists�copytreer )r* r+ r, r- r r
r@ �infor0 �ar> r$ r5 r4 Z
testroot_pathr r1 r r7 A s.
r7 )r* r c C sj t | jd�r| j�d�}n | j�d�}|r0|jni }ddi}|�|� |d rft|d t�sft� 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.
�get_closest_markerr+ r, Nz@You can only provide a string type of value for "shared_result" )
r8 r9 rK r: r@ r? �
isinstancer( rC rD )r* �envr@ �resultr r r r+ q s �
r+ �function)r+ r7 �make_appr, r c c s� |\}}||i |��}|V t d|�dd�� t d|jj� t d|j� t d|j� t dd|j�� � t d d|j�� � | d
r�|� | d
|� d S ) z9
Provides the 'sphinx.application.Sphinx' object
z # testroot:r5 r6 z
# builder:z # srcdir:z # outdir:z # status:�
z
# warning:r, N)
�printrF Zbuilder�namer4 Zoutdirr r r r# )r+ r7 rP r, r> r@ r r r r �app� s rT )rT r c C s | j S �zJ
Back-compatibility for testing with previous @with_app decorator
)r �rT r r r r � s r c C s | j S rU )r rV r r r r � s r )r+ � monkeypatchr c # s^ |� ddd� � g � tjdd� }� �fdd�}|V |tjdd�< t� �D ] }|�� qLdS )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.
zsphinx.application.abspathc S s | S r r )�xr r r �<lambda>� r3 zmake_app.<locals>.<lambda>Nc sR t � t � }}|�d|� |�d|� t| i |��}� �|� �d rNt|�}|S )Nr r r, )r �
setdefaultr �appendr )r> r@ r r r �Zappsr+ r r �make� s
zmake_app.<locals>.make)�setattr�sys�pathr; Zcleanup)r+ rW Zsyspathr] r r r\ r rP � s rP c C s t � S r )r r r r r r, � s r, �moduleT)r Zautousec C s t j�� d S r )r r �clearr r r r �_shared_result_cache� s rc c C sR t | jdd�}z"|r.tj|dgttd� W dS W n tyB Y n0 t�d� dS )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 �OSErrorrC �skip)rT rd r r r �if_graphviz_found� s
rm z util.path)�tmpdir_factoryr c C s | � � }t�|��� S )z8
Temporary directory wrapped with `path` class.
)Z getbasetempr
r` �abspath)rn �tmpdirr r r r- � s r- )rp r c C s
t �| �S )z�
Temporary directory wrapped with `path` class.
This fixture is for back-compatibility with old test implementation.
)r
r` )rp r r r �tempdir� s rq c
c sd z8t tj�} dV W t tj�D ]}|| vr tj�|� q n&t tj�D ]}|| vrDtj�|� qD0 dS )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)r< r_ �modulesrE )Z
sysmodules�modnamer r r �rollback_sysmodules� s
�rt )&�__doc__ri r_ � collectionsr �ior r �typingr r r r r rC Zsphinx.testingr
Zsphinx.testing.utilr r r r Zfixturer( r r r7 r+ rT r r rP r, rc rm r- rq rt r r r r �<module> sX
�
�/
�