File: //usr/lib/python3/dist-packages/sphinx/testing/__pycache__/util.cpython-310.pyc
o
�$�a� � @ 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!d3dede"de#ddfdd�Z$d3dede"de#ddfdd�Z%de"de"ddfdd�Z&d4ded e
d e"d e
ddf
d d �Z'd!e"de
fd"d#�Z(G d$d%� d%�Z)G d&d'� d'ej*�Z+G d(d)� d)�Z,e�-d*�Z.d5d+e"d,e/de e"ddf fd-d.�Z0de"de"fd/d0�Z1d1d2� Z2dS )6z�
sphinx.testing.util
~~~~~~~~~~~~~~~~~~~
Sphinx test suite utilities
:copyright: Copyright 2007-2021 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 �| ||�sJ d| |f ��d S )NFz%r did not match %r��re�search�r r r � r �5/usr/lib/python3/dist-packages/sphinx/testing/util.py�assert_re_search! � �r! c C s" t �| ||�rJ d| |f ��d S )NFz%r did match %rr r r r r �assert_not_re_search& r" r# �thing�prefixc C s | � |�s
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�kwargsc K s� |r�t |t�r_t| |d fd|i|�� |dd � r^t |d t�r/t| |d fd|i|�� n�t | tj�s;J d| ��t| �dksKJ d|t| �f ��t| d |dd � fd|d i|�� nft |t�r�t | ttjf�srJ d| ��t| �t|�ks�J d|t| �t|�f ��t|�D ]\}}|d | }t| | |fd|i|�� q�n!t |t�r�| |ks�J d
||| f ��nt | |�s�J d ||| f ��|r�t | tj�s�J d | ��|� � D ]%\}}|| v s�J d
||| f ��| | |ks�J d|||| | f ��q�d S 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
�Element�len� enumerate�str�items) r* r+ r, r- �i�nodeclsr �key�valuer r r r1 0 sV
��&�
�� �
��
���r1 r c C sH t jdd�� t jdtd� t�| �W d � S 1 s w Y d S )NF)�record�ignore)�category)�warnings�catch_warnings�filterwarnings�DeprecationWarningr �parser r r r � etree_parseV s $�rD c @ s e Zd Zdeddfdd�ZdS )r r- r Nc K s | j �|� d S �N)�__dict__�update)�selfr- r r r �__init__] s zStruct.__init__)�__name__�
__module__� __qualname__r rI r r r r r \ s r c s� e Zd ZU dZdZeed< dZeed< dded e d
e d e
d e d
e de de
e dededdf� fdd�
Zdde
ddfdd�Zdefdd�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 r1i }d}tjd d � | _tj�� | _ t
j �� | _ dd� t
tj�D �| _zt� j|| | |
||||||||
d � W d S tys | �� � w )
Nz
docutils.conf�_buildT)�exist_ok�doctreesFc S s h | ] }|� d �r|�qS )�visit_r& )�.0�vr r r � <setcomp>� s
�z)SphinxTestApp.__init__.<locals>.<setcomp>)rY )�
write_text�joinpath�makedirs�sysr � _saved_pathr � _directives�copy�_saved_directivesr
�_roles� _saved_roles�dirr
�GenericNodeVisitor�_saved_nodeclasses�superrI � Exception�cleanup)rH rP rQ rR rS rT rU rV rW rX rY �confdir�outdir�
doctreedir�warningiserror�� __class__r r rI i s2
� �zSphinxTestApp.__init__r\ c C s� t j�� tj�� | jtjd d �< tj� dd � | j
t _ | j
t_ttj�D ]$}|�d�rJ|| jvrJttjd|dd � � ttjd|dd � � q&d S )N�autodoc_fodderr] � �depart_)r �cache�clearr � translatorsre rd r �modules�poprh r rf rj r
ri rk r
rl r' rm �delattr)rH r\ �methodr r r rp � s
��zSphinxTestApp.cleanupc C s d| j j| jjf S )Nz<%s buildername=%r>)rv rJ �builder�name)rH r r r �__repr__� s zSphinxTestApp.__repr__)
rO NNFNNNNNr )F)rJ rK rL �__doc__rM r �__annotations__rN r6 r �boolr r r �intrI rp r� �
__classcell__r r ru r r a s6
���������#
r c @ sJ e Zd ZdZdeddfdd�Zdedefdd �Zd
ed eddfd 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.
�app_r Nc C s
|| _ d S rE )�app)rH r� r r r rI � s
z,SphinxTestAppWrapperForSkipBuilding.__init__r� c C s t | j|�S rE )�getattrr� )rH r� r r r � __getattr__� s z/SphinxTestAppWrapperForSkipBuilding.__getattr__�argsr- c O s& | j j�� s| j j|i |�� d S d S rE )r� rr �listdir�build)rH r� r- r r r r� � s �z)SphinxTestAppWrapperForSkipBuilding.build)
rJ rK rL r� r rI r6 r r� r� r r r r r � s
r zu(".*?")|u(\'.*?\')�root�suffixc # sT � t j| dd�D ] \}}}t|�}� fdd�|D �D ] }|| }t|| �V qqd S )NT)� followlinksc s g | ] }� r |� � �r|�qS r )�endswith)r^ �f�r� r r �
<listcomp>� s z find_files.<locals>.<listcomp>)�os�walkr r )r� r� �dirpath�dirs�filesr� �fpathr r� r �
find_files� s ���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 rE 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 )Nr) rE )3r� r� r� r rd r? �ior �typingr 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__r6 r� r! r# r( r1 rD r �Sphinxr r �compile�_unicode_literals_rer� r� r� r� r r r r �<module> s: &<
"