| 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
�ab� � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z m
Z
m Z m Z m
Z
mZ ddlmZ ddlmZ ddlmZ ddlmZmZ dd lmZmZ dd
lm Z dd l m Z dd l m Z g d
�Z!d,ee"e#dd�dd�Z$d-ee"e#dd�dd�Z%e"e"dd�dd�Z&d.ee
e"e
dd�dd�Z'e"e
d�dd �Z(G d d � d �Z)G d d � d ej*�Z+G d!d"� d"�Z,e�-d#�Z.d/e"e/e e"ddf d$�d%d&�Z0e"e"d'�d(d)�Z1d*d+� Z2dS )0z�
sphinx.testing.util
~~~~~~~~~~~~~~~~~~~
Sphinx test suite utilities
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�StringIO)�IO�Any�Dict� Generator�List�Pattern)� ElementTree)�nodes)�Node)�
directives�roles)� application�locale)�ModuleAnalyzer��path)�relpath)�Struct�
SphinxTestApp�#SphinxTestAppWrapperForSkipBuilding)�regex�text�flags�returnc C s& t �| ||�s"ds"J d| |f ��d S )NFz%r did not match %r��re�search�r r r � r �7/usr/lib/python3.9/site-packages/sphinx/testing/util.py�assert_re_search! s r! c C s& t �| ||�r"ds"J d| |f ��d S )NFz%r did match %rr r r r r �assert_not_re_search& s r" )�thing�prefixr c C s" | � |�s ds J d| |f ��d S )NFz%r does not start with %r��
startswith)r# r$ r r r �assert_startswith+ s
r' � )�node�cls�xpath�kwargsr c K s |�r�t |t�r�t| |d fd|i|�� |dd � r�t |d t�r`t| |d fd|i|�� n^t | tj�sxJ d| ��t| �dks�J d|t| �f ��t| d |dd � fd|d i|�� n�t |t��rPt | ttjf�s�J d| ��t| �t|�k�sJ d|t| �t|�f ��t|�D ]0\}}|d | }t| | |fd|i|�� �q nHt |t��rz| |k�s�J d
||| f ��n t | |��s�J d ||| f ��|�rt | tj��s�J d | ��|� � D ]L\}}|| v �s�J d
||| f ��| | |k�s�J d|||| | f ���q�d S )Nr r+ � 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]zThe node %r is not %r: %rz$The node%s is not subclass of %r: %rz'The node%s does not have any attributesz)The node%s does not have %r attribute: %rz The node%s[%s] is not %r: %r)
�
isinstance�list� assert_node�tupler
ZElement�len� enumerate�str�items) r) r* r+ r, �iZnodeclsr �key�valuer r r r0 0 sN
��( �� �� ��r0 )r r c C sH t jdd��( t jdtd� t�| �W d � S 1 s:0 Y d S )NF)�record�ignore)�category)�warnings�catch_warnings�filterwarnings�DeprecationWarningr �parser r r r � etree_parseV s rA c @ s e Zd Zedd�dd�ZdS )r N)r, r c K s | j �|� d S �N)�__dict__�update)�selfr, r r r �__init__] s zStruct.__init__)�__name__�
__module__� __qualname__r rF r r r r r \ s r c
sz e Zd ZU dZdZeed< dZeed< dee e e
e e e e
e eedd� � fd d
�
Zde
dd �d d
�Zed�dd�Z� ZS )r z�
A subclass of :class:`Sphinx` that runs on the test root, with some
better default values for the initialization parameters.
N�_status�_warning�htmlFr ) � buildername�srcdir�builddir�freshenv�
confoverrides�status�warning�tags� docutilsconf�parallelr c s� | d ur|d � | � |d u r&|d }|} |�|�} | jdd� |�d�}
|
jdd� |d u rbi }d}tjd d � | _tj�� | _ t
j �� | _ dd� t
tj�D �| _z(t� j|| | |
||||||||
d � W n ty� | �� � Y n0 d S )
Nz
docutils.confZ_buildT)�exist_ok�doctreesFc S s h | ]}|� d �r|�qS )�visit_r% )�.0�vr r r � <setcomp>� s
�z)SphinxTestApp.__init__.<locals>.<setcomp>)rV )�
write_text�joinpath�makedirs�sysr � _saved_pathr � _directives�copy�_saved_directivesr
�_roles� _saved_roles�dirr
�GenericNodeVisitor�_saved_nodeclasses�superrF � Exception�cleanup)rE rM rN rO rP rQ rR rS rT rU rV Zconfdir�outdirZ
doctreedirZwarningiserror�� __class__r r rF i s0
�
zSphinxTestApp.__init__)rX r c C s� t j�� tj�� | jtjd d �< tj� dd � | j
t _ | j
t_ttj�D ]H}|�d�rL|| jvrLttjd|dd � � ttjd|dd � � qLd S )NZautodoc_fodderrY � Zdepart_)r �cache�clearr Z translatorsra r` r �modules�poprd r rb rf r
re rg r
rh r& ri �delattr)rE rX �methodr r r rl � s
�zSphinxTestApp.cleanup)r c C s d| j j| jjf S )Nz<%s buildername=%r>)ro rG Zbuilder�name)rE r r r �__repr__� s zSphinxTestApp.__repr__)
rL NNFNNNNNr )F)rG rH rI �__doc__rJ r �__annotations__rK r4 r �boolr r r �intrF rl rx �
__classcell__r r rn r r a s
�
�#
r c @ sB e Zd ZdZedd�dd�Zeed�dd�Zeedd �d
d �Z dS ) 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.
N)�app_r c C s
|| _ d S rB )�app)rE r~ r r r rF � s z,SphinxTestAppWrapperForSkipBuilding.__init__)rw r c C s t | j|�S rB )�getattrr )rE rw r r r � __getattr__� s z/SphinxTestAppWrapperForSkipBuilding.__getattr__)�argsr, r c O s" | j j�� s | j j|i |�� d S rB )r rm �listdir�build)rE r� r, r r r r� � s z)SphinxTestAppWrapperForSkipBuilding.build)
rG rH rI ry r rF r4 r r� r� r r r r r � s r zu(".*?")|u(\'.*?\'))�root�suffixr c # sR t j| dd�D ]>\}}}t|�}� fdd�|D �D ]}|| }t|| �V q2qd S )NT)� followlinksc s g | ]}� r|� � �r|�qS r )�endswith)rZ �f�r� r r �
<listcomp>� � z find_files.<locals>.<listcomp>)�os�walkr r )r� r� �dirpathZ_dirs�filesr� Zfpathr r� r �
find_files� s
r� )r r c C s t �dd| �S )Nz.*?mr( )r �sub)r r r r � strip_escseq� s r� c s t �� �� fdd��}|S )zA
A simple decorator that does nothing, for tests to use.
c s � | i |��S rB r )r� r, �r� r r �wrapper� s z!simple_decorator.<locals>.wrapper)� functools�wraps)r� r� r r� r �simple_decorator� s r� )r )r )Nr( )N)3ry r� r� r r` r< �ior �typingr r r r r r Z xml.etreer Zdocutilsr
Zdocutils.nodesr Zdocutils.parsers.rstr r
Zsphinxr r Z
sphinx.pycoder Zsphinx.testing.pathr Zsphinx.util.osutilr �__all__r4 r| r! r" r' r0 rA r ZSphinxr r �compileZ_unicode_literals_rer{ r� r� r� r r r r �<module> s8 &<