| 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/ext/__pycache__/ |
Upload File : |
a
�ab#Y � @ s d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ d dlmZ d dlmZmZmZ d dlmZ d dlm Z m Z d d l m Z d dl Z d d
l!m"Z" d d l#m$Z$ d d l%m&Z& d d
l'm(Z( d dl)m*Z* d dl+m,Z, d dl-m.Z. e �r d dl/m0Z0 e&�1e2�Z3e�4dej5�Z6e�4dej5�Z7e8e8e9d�dd�Z:G dd� de*�Z;G dd� de;�Z<G dd � d e;�Z=G d d � d e;�Z>G d d � d e;�Z?G d!d"� d"e;�Z@e �A� ZBG d#d$� d$�ZCG d%d&� d&�ZDG d'd(� d(e jE�ZFG d)d*� d*e"�ZGd+e e8e
f d,�d-d.�ZHdS )/� N)�StringIO)�path)
�
TYPE_CHECKING�Any�Callable�Dict�Iterable�List�Sequence�Set�Tuple�Type)�nodes)�Element�Node� TextElement)�
directives)�InvalidSpecifier� SpecifierSet)�Version)�Builder)�__)�logging)�bold)�SphinxDirective)�relpath)�
OptionSpec)�Sphinxz^\s*<BLANKLINE>z#\s*doctest:.+$)�spec�version�returnc C s t |�t| �v S �N)r r )r r � r" �6/usr/lib/python3.9/site-packages/sphinx/ext/doctest.py�is_allowed_version. s r$ c @ s. e Zd ZdZdZdZdZee d�dd�Z dS )�
TestDirectiveTr � �r c
C s� d� | j�}d }| jdkrZd|v r2|}t�d|�}t�|�rZd| jvrZ|sN|}t�d|�}tj }| jdv std| jv rztj
}| j r�dd � | j d
� d �D �}nd g}|||| j|d
�}| �
|� |d ur�||d< | jdkr�| jjdv r�d|d< nd|d< nB| jdk�r&| jjdv �r d|d< nd|d< n| jdk�r:d|d< i |d< | jdv �rd| jv �r| jd �d d�� � }|D ]�}|d
|dd � }} |d v�r�| jjjjtd �| | jd � �qt| tjv�r�| jjjjtd �| | jd � �qttj|dd � }
|d
d k|d |
< �qt| jdk�r�d!| jv �r�zN| jd! } d"� d#d � tjd d$� D ��} t| | ��svtjd% }
d&|d |
< W n2 t �y� | jjjjtd'�| | jd � Y n0 d(| jv �r�| jd( |d(< d)| jv �r�d&|d*< nd| jv �r�d+|d*< |gS ),N�
�doctestz <BLANKLINE>� �no-trim-doctest-flags)� testsetup� testcleanup�hidec S s g | ] }|� � �qS r" )�strip)�.0�xr" r" r# �
<listcomp>^ � z%TestDirective.run.<locals>.<listcomp>r �,�default)� testnodetype�groups�test)�py�pythonZpycon�languageZpycon3�testcoder: Zpython3�
testoutputZnone�options)r) r= � r& z+-z"missing '+' or '-' in '%s' option.)�linez'%s' is not a valid option.�+� pyversion�.c S s g | ] }t |��qS r" )�str)r0 �vr" r" r# r2 � r3 � ZSKIPTz$'%s' is not a valid pyversion option�skipif�trim-doctest-flagsZ
trim_flagsF) �joinZcontent�name� blankline_re�sub�
doctestopt_re�searchr> r �
literal_block�commentZ arguments�splitZset_source_info�configZhighlight_language�replace�stateZdocumentZreporter�warningr �linenor) ZOPTIONFLAGS_BY_NAME�sys� version_infor$ r )
�self�coder8 Znodetyper7 �node�option_strings�option�prefixZ option_name�flagr Zpython_versionr" r" r# �runL s�
�
�
�
zTestDirective.runN)
�__name__�
__module__� __qualname__Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacer r r` r" r" r" r# r% B s
r% c @ s e Zd ZU dejiZeed< dS )�TestsetupDirectiverG � option_specN�ra rb rc r �unchanged_requiredre r �__annotations__r" r" r" r# rd � s
�rd c @ s e Zd ZU dejiZeed< dS )�TestcleanupDirectiverG re Nrf r" r" r" r# ri � s
�ri c @ s4 e Zd ZU ejejejejejejd�Zee d< dS )�DoctestDirective�r. r+ r> rB rG rH re N�
ra rb rc r r_ Z unchangedrg re r rh r" r" r" r# rj � s
�rj c @ s0 e Zd ZU ejejejejejd�Zeed< dS )�TestcodeDirective)r. r+ rB rG rH re N) ra rb rc r r_ rg re r rh r" r" r" r# rm � s
�rm c @ s4 e Zd ZU ejejejejejejd�Zee d< dS )�TestoutputDirectiverk re Nrl r" r" r" r# rn � s
�rn c @ s> e Zd Zedd�dd�Zd
dedd�dd �Zed
�d d �ZdS )� TestGroupN)rJ r c C s || _ g | _g | _g | _d S r! )rJ �setup�tests�cleanup)rY rJ r" r" r# �__init__� s zTestGroup.__init__F�TestCode)rZ �prependr c C s� |j dkr,|r | j�d|� q�| j�|� n�|j dkrD| j�|� nt|j dkr^| j�|g� nZ|j dkrz| j�|d g� n>|j dkr�| jr�t| jd �dkr�|| jd d < n ttd
���d S ) Nr, r r- r) r< r= ���� r& zinvalid TestCode type) �typerp �insert�appendrr rq �len� RuntimeErrorr )rY rZ ru r" r" r# �add_code� s
zTestGroup.add_coder' c C s d| j | j| j| jf S )Nz2TestGroup(name=%r, setup=%r, cleanup=%r, tests=%r))rJ rp rr rq �rY r" r" r# �__repr__� s �zTestGroup.__repr__)F)ra rb rc rD rs �boolr} r r" r" r" r# ro � s ro c @ s4 e Zd Zdeeeeedd�dd�Zed�dd�ZdS ) rt N)rZ rx �filenamerV r> r c C s& || _ || _|| _|| _|p i | _d S r! �rZ rx r� rV r> )rY rZ rx r� rV r> r" r" r# rs � s
zTestCode.__init__r' c C s d| j | j| j| j| jf S )Nz4TestCode(%r, %r, filename=%r, lineno=%r, options=%r)r� r~ r" r" r# r � s �zTestCode.__repr__)N)ra rb rc rD �intr rs r r" r" r" r# rt � s
�� rt c sD e Zd Zdeeeeef d�� fdd�
Zd ee e d�dd�Z
� Z S )
�SphinxDocTestRunnerN)�out�verboser c sB t � }tj}|t_zt� �|�}W |t_n|t_0 ||�� � |S r! )r rW �stdout�super� summarize�getvalue)rY r� r� Z string_ioZ
old_stdout�res�� __class__r" r# r� � s z SphinxDocTestRunner.summarize)r� �module_globalsr c C sh | j �|�}|r\|�d�| jjkr\z| jjt|�d�� }W n tyN Y n0 |j� d�S | �
||�S )NrJ Z
examplenumT) Z%_DocTestRunner__LINECACHE_FILENAME_RE�match�groupr8 rJ �examplesr� �
IndexError�source�
splitlinesZsave_linecache_getlines)rY r� r� �m�exampler" r" r# �*_DocTestRunner__patched_linecache_getlines s z>SphinxDocTestRunner._DocTestRunner__patched_linecache_getlines)N)N) ra rb rc r r� r r� r� rD r r� �
__classcell__r" r" r� r# r� � s
�
��r� c @ s e Zd ZdZed�Zdd�dd�Zedd�dd �Zedd�d
d �Z d(eeed �d
d�Z
e e d�dd�Z dd�dd�Z
d)ee ee edd�dd�Zeeed�dd�Zeeed�dd ��Zeed�d d �Zeedd �d d!�Zeeeeeed"�d#d$�Ze dd%�d&d'�Z dS )*�DocTestBuilderr) zZTesting of doctests in the sources finished, look at the results in %(outdir)s/output.txt.Nr' c C s� | j j| _| jt_| j jtjdd�< d| _d| _ d| _
d| _ d| _ d| _
d| _t�d�}tt�| jd�ddd�| _| j�d|d t|� f � d S )
Nr �singlez%Y-%m-%d %H:%M:%Sz
output.txt�wzutf-8)�encodingzJResults of doctest builder run on %s
==================================%s
�=)rR �doctest_default_flags�opt�compiler) � doctest_pathrW r rx �total_failures� total_tries�setup_failures� setup_tries�cleanup_failures�
cleanup_tries�time�strftime�openrI Zoutdir�outfile�writer{ )rY �dater" r" r# �init s
�zDocTestBuilder.init)�textr c C s t j|dd� | j�|� d S �NT)Znonl)�logger�infor� r� �rY r� r" r" r# �_out; s zDocTestBuilder._outc C s: | j js| j jr t�|� ntj|dd� | j�|� d S r� )�app�quietZwarningiserrorr� rU r� r� r� r� r" r" r# � _warn_out? s zDocTestBuilder._warn_out)�docname�typr c C s dS )Nr* r" )rY r� r� r" r" r# �get_target_uriF s z DocTestBuilder.get_target_uric C s | j jS r! )�envZ
found_docsr~ r" r" r# �get_outdated_docsI s z DocTestBuilder.get_outdated_docsc C sz t td�dd�}| j|| j�| j|| j�| j|| j�| j|| j�f}| �d| � | j�� | jsn| jsn| jrvd| j _
d S )N)rE r c S s | dkr dS dS )Nr& �sr* r" )rE r" r" r# r� N s z DocTestBuilder.finish.<locals>.sz}
Doctest summary
===============
%5d test%s
%5d failure%s in tests
%5d failure%s in setup code
%5d failure%s in cleanup code
r& ) r� rD r� r� r� r� r� r� �closer� Z
statuscode)rY r� �replr" r" r# �finishL s ��
zDocTestBuilder.finish�update)�build_docnames�updated_docnames�methodr c C sH |d u rt | jj�}t�td�� |D ] }| j�|�}| �||� q&d S )Nzrunning tests...)�sortedr� Zall_docsr� r� r Z get_doctree�test_doc)rY r� r� r� r� �doctreer" r" r# r� a s zDocTestBuilder.write)r[ r� r c C sJ z"t |j| jj�jddd�d }W n" tyD | jj|d d�}Y n0 |S )N�:docstring of r& )�maxsplitr )�base)r r� r� Zsrcdir�rsplit� ExceptionZdoc2path)rY r[ r� r� r" r" r# �get_filename_for_nodel s �� z$DocTestBuilder.get_filename_for_node�r[ r c C s0 dt �| jpd�v rd S | jd ur,| jd S d S )Nr� r* r& )r �basenamer� r@ �r[ r" r" r# �get_line_numberv s
z DocTestBuilder.get_line_numberc C sV d|vr dS |d }i }| j jr.t| j j|� t||�}| j jrNt| j j|� |S d S )NrG F)rR �doctest_global_setup�exec�eval�doctest_global_cleanup)rY r[ � condition�contextZ should_skipr" r" r# �skipped� s
zDocTestBuilder.skipped)r� r� r c C s� i }g }t d| jd�| _t d| jd�| _t d| jd�| _| jj| j_| jj| j_| jjrjtt d�dd�}ntt d�dd�}|�
|�D ]�}| � |�r�q�d|v r�|d n|� � }| �
||�}| �|�} |s�t�td�|�d d
�|| � t||�d d
�|| |�d �d �}
|�d
dg�} d| v �r&|�|
� q�| D ]*} | |v�rDt| �|| < || �|
� �q*q�|D ] }
|�� D ]}
|
�|
� �qh�q\| jj�r�t| jjdd dd�}
|�� D ]}
|
j|
dd� �q�| jj�r�t| jjdd dd�}
|�� D ]}
|
�|
� �q�|�s�d S | �d|dt|� f � |�� D ]}
| � |
� �q | jj | jdd�\}}| j |7 _ | j |7 _ | jj �r�| jj | jdd�\}}| j!|7 _!| j"|7 _"| jj �r�| jj | jdd�\}}| j#|7 _#| j$|7 _$d S )NF)r� Z optionflagsr� c S s& t | tjtjf�rd| v p$t | tj�S �Nr6 )�
isinstancer rO rP Z
doctest_blockr� r" r" r# r� � s
�
�z*DocTestBuilder.test_doc.<locals>.conditionc S s t | tjtjf�od| v S r� )r� r rO rP r� r" r" r# r� � s �r8 z#no code/output in %s block at %s:%sr6 r) r> )rx r� rV r> r7 r5 �*r, r )r� rV T)ru r- z
Document: %s
----------%s
�-)r� )%r� r� � setup_runner� test_runner�cleanup_runnerZ_fakeoutrR �doctest_test_doctest_blocksr r� �findallr� Zastextr� r� r� rU r �getrt rz ro r} �valuesr� r� r� r{ �
test_groupr� r� r� Ztriesr� r� r� r� )rY r� r� r7 Zadd_to_all_groupsr� r[ r� r� Z line_numberrZ Z node_groupsZ groupnamer� Zres_fZres_tr" r" r# r� � s� ���
��
�
� �
�
zDocTestBuilder.test_doc)rZ rJ rx �flags� dont_inheritr c C s t ||| j||�S r! )r� rx )rY rZ rJ rx r� r� r" r" r# r� � s zDocTestBuilder.compile)r� r c
s� i �t tt t td�� ��fdd� }|�j� jd�s8d S � jD �]x}t|�dkr�z*t� |d j
i � j |d j |d j
�}W n@ ty� tjtd�|d j
|d j |d j
fd� Y q>Y n0 |js�q>|jD ]$}|d j�� }|�|j� ||_q�d �_n�|d �r |d j
nd
}|d �r$|d jni }d |tj< tj�|�} | �rP| �d �}
nd }
tj |d j
||
|d j
|d
�}t� |gi � j |d j |d j
d �}d�_�|_ �j j |�j!dd� q>|�j"� j#d� d S )N)�runner� testcodes�whatr c s� g }|D ]"}t j|jd|jd�}|�|� q|s4dS t �|i d� j|f |d jdd �}�|_| j }d�_
| j |�j dd� | j |kr�dS dS ) Nr* )rV Tz %s (%s code)r r� F�r� Z clear_globs)
r) �ExamplerZ rV rz �DocTestrJ r� �globsZfailuresrx r` r� )r� r� r� r� r< r� Z sim_doctestZold_f�r� �nsrY r" r# �run_setup_cleanup� s" �
z4DocTestBuilder.test_group.<locals>.run_setup_cleanuprp r& r z!ignoring invalid doctest code: %r)�locationr� r* T�msg)�exc_msgrV r> r� Fr� rr )$r r rt r� r� rp rq r{ �parserZ get_doctestrZ rJ r� rV r� r� rU r r� r> �copyr� rx r) ZDONT_ACCEPT_BLANKLINEZ
_EXCEPTION_REr� r� r� r� r� r� r` r� r� rr ) rY r� r� rZ r8 r� Znew_opt�outputr> r� r� r" r� r# r� � sN � �
��zDocTestBuilder.test_group)N)r� ) ra rb rc rJ r �epilogr� rD r� r� r� r r� r� r r
r� r r� � staticmethodr� r� r r� r� r� r r� ro r� r" r" r" r# r� s& ��
Nr� r )r� r c C s� | � dt� | � dt� | � dt� | � dt� | � dt� | �t� | �dg d� | �dd d� | �d
d d� | �d d d� | �d
t j
t j B t j B d� t
jdd�S )Nr, r- r) r< r= r� Fr� r5 r� r* r� r� T)r Zparallel_read_safe)Z
add_directiverd ri rj rm rn Z add_builderr� Zadd_config_valuer) ZDONT_ACCEPT_TRUE_FOR_1�ELLIPSISZIGNORE_EXCEPTION_DETAIL�sphinxZ__display_version__)r� r" r" r# rp , s
�rp )Ir) �rerW r� �ior �osr �typingr r r r r r r
r r r
Zdocutilsr Zdocutils.nodesr r r Zdocutils.parsers.rstr Zpackaging.specifiersr r Zpackaging.versionr r� Zsphinx.buildersr Z
sphinx.localer Z sphinx.utilr Zsphinx.util.consoler Zsphinx.util.docutilsr Zsphinx.util.osutilr Zsphinx.util.typingr Zsphinx.applicationr Z getLoggerra r� r� � MULTILINErK rM rD r� r$ r% rd ri rj rm rn Z
DocTestParserr� ro rt Z
DocTestRunnerr� r� rp r" r" r" r# �<module> sN 0
W