Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
ext
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: doctest.cpython-310.pyc
o �$�a$Y � @ s d Z ddlZddlZddlZddlZddlmZ ddlmZ ddl m Z m Z m Z m Z mZmZmZmZmZmZ ddlmZ ddlmZmZmZ ddlmZ dd l m Z m Z dd l m Z ddl!Z!dd l"m#Z# dd l$m%Z% dd l&m'Z' ddl(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/ e r�ddl0m1Z1 e'�2e3�Z4e�5dej6�Z7e�5dej6�Z8de9de9de:fdd�Z;G dd� de+�Z<G d d � d e<�Z=G d d � d e<�Z>G d d!� d!e<�Z?G d"d#� d#e<�Z@G d$d%� d%e<�ZAe�B� ZCG d&d'� d'�ZDG d(d)� d)�ZEG d*d+� d+ejF�ZGG d,d-� d-e#�ZHd.d/de e9e f fd0d1�ZIdS )2z� sphinx.ext.doctest ~~~~~~~~~~~~~~~~~~ Mimic doctest by automatically executing code snippets and checking their results. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. � 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 )aa Check `spec` satisfies `version` or not. This obeys PEP-440 specifiers: https://www.python.org/dev/peps/pep-0440/#version-specifiers Some examples: >>> is_allowed_version('3.3', '<=3.5') True >>> is_allowed_version('3.3', '<=3.2') False >>> is_allowed_version('3.3', '>3.2, <4.0') True )r r )r r � r! �4/usr/lib/python3/dist-packages/sphinx/ext/doctest.py�is_allowed_version. s r# c @ s2 e Zd ZdZdZdZdZdZdee fdd�Z dS ) � TestDirectivez4 Base class for doctest-related directives. Tr � r c C s� d� | j�}d }| jdkr-d|v r|}t�d|�}t�|�r-d| jvr-|s'|}t�d|�}tj }| jdv s:d| jv r=tj }| j rNdd � | j d � d �D �}nd g}|||| j|d �}| � |� |d urg||d< | jdkr|| jjdv rwd|d< n#d|d< n | jdkr�| jjdv r�d|d< nd|d< n | jdkr�d|d< i |d< | jdv r�d| jv r�| jd �d d�� � }|D ]I}|d |dd � }} |d vr�| jjjjtd �| | jd � q�| tjvr�| jjjjtd �| | jd � q�tj|dd � } |d d k|d | < q�| jdk�rLd!| jv �rLz'| jd! } d"� d#d � tjd d$� D ��} t| | ��s1tjd% } d&|d | < W n t �yK | jjjjtd'�| | jd � Y nw d(| jv �rY| jd( |d(< d)| jv �rfd&|d*< |gS d| jv �rpd+|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�python�pycon�language�pycon3�testcoder8 �python3� testoutput�none�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)r. �vr! r! r" r0 � r1 � �SKIPTz$'%s' is not a valid pyversion option�skipif�trim-doctest-flags� trim_flagsF) �join�content�name� blankline_re�sub� doctestopt_re�searchr@ r � literal_block�comment� arguments�split�set_source_info�config�highlight_language�replace�state�document�reporter�warningr �linenor' �OPTIONFLAGS_BY_NAME�sys� version_infor# r ) �self�coder6 �nodetyper5 �node�option_strings�option�prefix� option_name�flagr �python_versionr! r! r" �runL s� � � � �� �zTestDirective.runN) �__name__� __module__� __qualname__�__doc__� has_content�required_arguments�optional_arguments�final_argument_whitespacer r rn r! r! r! r" r$ B s r$ c @ � e Zd ZU dejiZeed< dS )�TestsetupDirectiverJ � option_specN�ro rp rq r �unchanged_requiredry r �__annotations__r! r! r! r" rx � � �rx c @ rw )�TestcleanupDirectiverJ ry Nrz r! r! r! r" r~ � r} r~ c @ �4 e Zd ZU ejejejejejejd�Zee d< dS )�DoctestDirective�r, r) r@ rD rJ rK ry N� ro rp rq r rl � unchangedr{ ry r r| r! r! r! r" r� � � �r� c @ s0 e Zd ZU ejejejejejd�Zeed< dS )�TestcodeDirective)r, r) rD rJ rK ry N) ro rp rq r rl r{ ry r r| r! r! r! r" r� � s �r� c @ r )�TestoutputDirectiver� ry Nr� r! r! r! r" r� � r� r� c @ sD e Zd Zdeddfdd�Zdddd eddfd d �Zdefd d �ZdS )� TestGrouprO r Nc C s || _ g | _g | _g | _d S �N)rO �setup�tests�cleanup)rd rO r! r! r" �__init__� s zTestGroup.__init__Fre �TestCode�prependc C s� |j dkr|r| j�d|� d S | j�|� d S |j dkr%| j�|� d S |j dkr3| j�|g� d S |j dkrB| j�|d g� d S |j dkr`| jr\t| jd �dkr^|| jd d < d S d S d S ttd ���) Nr* r r+ r' r< r> ���� r% zinvalid TestCode type) �typer� �insert�appendr� r� �len� RuntimeErrorr )rd re r� r! r! r" �add_code� s � zTestGroup.add_codec C s d| j | j| j| jf S )Nz2TestGroup(name=%r, setup=%r, cleanup=%r, tests=%r))rO r� r� r� �rd r! r! r" �__repr__� s �zTestGroup.__repr__)F)ro rp rq rF r� �boolr� r� r! r! r! r" r� � s r� c @ s@ e Zd Z d dedededededdf dd �Zdefd d �ZdS ) r� Nre r� �filenamer` r@ r c C s& || _ || _|| _|| _|pi | _d S r� �re r� r� r` r@ )rd re r� r� r` r@ r! r! r" r� � s zTestCode.__init__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__r� )ro rp rq rF �intr r� r� r! r! r! r" r� � s ��� �r� c sN e Zd Zd dededeeef f� fdd� Z d dede de fd d �Z � Z S ) �SphinxDocTestRunnerN�out�verboser c sB t � }tj}|t_z t� �|�}W |t_n|t_w ||�� � |S r� )r rb �stdout�super� summarize�getvalue)rd r� r� � string_io� old_stdout�res�� __class__r! r" r� � s z SphinxDocTestRunner.summarizer� �module_globalsc C sh | j �|�}|r.|�d�| jjkr.z | jjt|�d�� }W n ty' Y nw |j� d�S | � ||�S )NrO � examplenumT) �%_DocTestRunner__LINECACHE_FILENAME_RE�match�groupr6 rO �examplesr� � IndexError�source� splitlines�save_linecache_getlines)rd r� r� �m�exampler! r! r" �*_DocTestRunner__patched_linecache_getlines s � z>SphinxDocTestRunner._DocTestRunner__patched_linecache_getlinesr� ) ro rp rq r r� r r� r� rF r r� � __classcell__r! r! r� r" r� � s � ���r� c @ s, e Zd ZdZdZed�Zd/dd�Zdeddfd d �Z deddfd d �Z d0d ededefdd�Z de e fdd�Z d/dd�Z d1dee dee deddfdd�Zded edefd d �Zededefd d ��Zdedefd d!�Zd ed"eddfd#d$�Zd%ed&ed'ed(ed)edef d*d+�Z d,e ddfd-d.�Z dS )2�DocTestBuilderz2 Runs test snippets in the documentation. r' zZTesting of doctests in the sources finished, look at the results in %(outdir)s/output.txt.r Nc 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 �=)rY �doctest_default_flags�opt�compiler' � doctest_pathrb r r� �total_failures� total_tries�setup_failures� setup_tries�cleanup_failures� cleanup_tries�time�strftime�openrM �outdir�outfile�writer� )rd �dater! r! r" �init s �zDocTestBuilder.init�textc C s t j|dd� | j�|� d S �NT)�nonl)�logger�infor� r� �rd r� r! r! r" �_out; s zDocTestBuilder._outc C s: | j js| j jrt�|� ntj|dd� | j�|� d S r� )�app�quiet�warningiserrorr� r_ r� r� r� r� r! r! r" � _warn_out? s zDocTestBuilder._warn_out�docname�typc C s dS )Nr( r! )rd r� r� r! r! r" �get_target_uriF s z DocTestBuilder.get_target_uric C s | j jS r� )�env� found_docsr� r! r! r" �get_outdated_docsI s z DocTestBuilder.get_outdated_docsc C s� dt dtfdd�}| j|| j�| j|| j�| j|| j�| j|| j�f}| �d| � | j�� | js8| js8| jr>d| j _ d S d S )NrG r c S s | dkrdS dS )Nr% �sr( r! )rG 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� rF r� r� r� r� r� r� �closer� � statuscode)rd r� �replr! r! r" �finishL s �� �zDocTestBuilder.finish�update�build_docnames�updated_docnames�methodc C sH |d u r t | jj�}t�td�� |D ]}| j�|�}| �||� qd S )Nzrunning tests...)�sortedr� �all_docsr� r� r � get_doctree�test_doc)rd r� r� r� r� �doctreer! r! r" r� a s �zDocTestBuilder.writerg c C sJ zt |j| jj�jddd�d }W |S ty$ | jj|dd�}Y |S w )zsTry to get the file which actually contains the doctest, not the filename of the document it's included in.�:docstring of r% )�maxsplitr N)�base)r r� r� �srcdir�rsplit� Exception�doc2path)rd rg r� r� r! r! r" �get_filename_for_nodel s �� ��z$DocTestBuilder.get_filename_for_nodec C s0 dt �| jpd�v r dS | jdur| jd S dS )z0Get the real line number or admit we don't know.r� r( Nr% )r �basenamer� rB �rg r! r! r" �get_line_numberv s z DocTestBuilder.get_line_numberc C sR d|vrdS |d }i }| j jrt| j j|� t||�}| j jr't| j j|� |S )NrJ F)rY �doctest_global_setup�exec�eval�doctest_global_cleanup)rd rg � condition�context� should_skipr! r! r" �skipped� s zDocTestBuilder.skippedr� c C s� i }g }t d| jd�| _t d| jd�| _t d| jd�| _| jj| j_| jj| j_| jjr6dtdt fdd�}n dtdt fdd�}|� |�D ]f}| � |�rLqDd|v rT|d n|� � }| � ||�}| �|�} |sst�td �|�d d �|| � t||�d d �|| |�d �d �} |�ddg�} d| v r�|�| � qD| D ]} | |vr�t| �|| < || �| � q�qD|D ]} |�� D ]} | �| � q�q�| jjr�t| jjdd dd�} |�� D ] } | j| dd� q�| jjr�t| jjdd dd�} |�� D ]} | �| � q�|s�d S | �d|dt|� f � |�� D ]} | � | � �q| jj | jdd�\}}| j |7 _ | j |7 _ | jj �rG| jj | jdd�\}}| j!|7 _!| j"|7 _"| jj �rg| jj | jdd�\}}| j#|7 _#| j$|7 _$d S d S )NF)r� � optionflagsrg r c S s& t | tjtjf�r d| v pt | tj�S �Nr4 )� isinstancer rT rU � doctest_blockr� r! r! r" r� � s � �z*DocTestBuilder.test_doc.<locals>.conditionc S s t | tjtjf�o d| v S r )r r rT rU r� r! r! r" r� � s �r6 z#no code/output in %s block at %s:%sr4 r' r@ )r� r� r` r@ r5 r3 �*r* r )r� r` T)r� r+ z Document: %s ----------%s �-)r� )%r� r� � setup_runner� test_runner�cleanup_runner�_fakeoutrY �doctest_test_doctest_blocksr r� �traverser� �astextr� r� r� r_ r �getr� r� r� r� �valuesr� r� r� r� � test_groupr� r� r� �triesr� r� r� r� )rd r� r� r5 �add_to_all_groupsr� rg r� r� � line_numberre � node_groups� groupnamer� �res_f�res_tr! r! r" r� � s� ��� �� � �� � � ��zDocTestBuilder.test_docre rO r� �flags� dont_inheritc C s t ||| j||�S r� )r� r� )rd re rO r� r r r! r! r" r� � s zDocTestBuilder.compiler� c s� i �dt dtt dt dtf� ��fdd� }|�j� jd�s d S � jD ]�}t|�dkr|zt� |d j i � j |d j |d j �}W n ty] tjtd �|d j |d j |d j fd � Y q"w |jsbq"|jD ]}|d j�� }|�|j� ||_qed �_nP|d r�|d j nd }|d r�|d jni }d|tj< tj�|�} | r�| �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|sdS t �|i d� j|f |d jdd �}�|_| j }d�_ | j |�j dd� | j |krEdS dS ) Nr( )r` Tz %s (%s code)r r� F�r� � clear_globs) r' �Examplere r` r� �DocTestrO r� �globs�failuresr� rn r� )r r r r� r< r� � sim_doctest�old_f�r� �nsrd r! r" �run_setup_cleanup� s" � z4DocTestBuilder.test_group.<locals>.run_setup_cleanupr� r% r z!ignoring invalid doctest code: %r)�locationr� r( T�msg)�exc_msgr` r@ r� Fr r� )$r r r� r� r r� r� r� �parser� get_doctestre rO r� r` r� r� r_ r r� r@ �copyr� r� r' �DONT_ACCEPT_BLANKLINE� _EXCEPTION_REr� r� r r r r rn r� r r� ) rd r� r& re r6 r� �new_opt�outputr@ r� r) r! r$ r" r � sP & � �� ��zDocTestBuilder.test_group)r Nr� )r� ) ro rp rq rr rO r �epilogr� rF r� r� r� r r� r� r r r� r r� � staticmethodr� r� r r� r� r� r r� r� r r! r! r! r" r� s. �� � "Nr� 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 r3 r� r( r� r� T)r �parallel_read_safe)� add_directiverx r~ r� r� r� � add_builderr� �add_config_valuer' �DONT_ACCEPT_TRUE_FOR_1�ELLIPSIS�IGNORE_EXCEPTION_DETAIL�sphinx�__display_version__)r� r! r! r" r� , s � r� )Jrr r' �rerb r� �ior �osr �typingr r r r r r r r r r �docutilsr �docutils.nodesr r r �docutils.parsers.rstr �packaging.specifiersr r �packaging.versionr r: �sphinx.buildersr � sphinx.localer � sphinx.utilr �sphinx.util.consoler �sphinx.util.docutilsr �sphinx.util.osutilr �sphinx.util.typingr �sphinx.applicationr � getLoggerro r� r� � MULTILINErP rR rF r� r# r$ rx r~ r� r� r� � DocTestParserr* r� r� � DocTestRunnerr� r� r� r! r! r! r" �<module> sR 0 W
Save
Cancel