| 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/directives/__pycache__/ |
Upload File : |
a
�ab�8 � @ s� d Z ddlZddlmZmZmZmZmZ ddlm Z ddl
m Z m Z ddl
mZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZmZ dd
l m Z m Z m Z ddl m!Z! ddl"m#Z#m$Z$ ddl%m&Z& ddl'm(Z( er�ddl)m*Z* e�+d�Z,e �-e.�Z/e0e1d�dd�Z2G dd� de!�Z3G dd� de!�Z4G dd � d e�Z5G d d � d e!�Z6G d d � d e!�Z7G d!d"� d"e!�Z8G d#d$� d$e!�Z9G d%d&� d&e!�Z:G d'd(� d(ee!�Zd)ee0ef d*�d+d,�Z;dS )-z�
sphinx.directives.other
~~~~~~~~~~~~~~~~~~~~~~~
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
TYPE_CHECKING�Any�Dict�List�cast)�nodes)�Element�Node)�
directives)�BaseAdmonition)�Class)�Include)�addnodes)�
VersionChange)�_�__)� docname_join�logging�url_re)�SphinxDirective)�Matcher� patfilter)�explicit_title_re)�
OptionSpec)�Sphinxz
.*[*?\[].*)�argument�returnc C s | sdS t | �S )Ni� )�int)r � r �;/usr/lib/python3.9/site-packages/sphinx/directives/other.py�int_or_nothing$ s r c
@ sn e Zd ZdZdZdZdZdZee j
e j e j e j e j e
e j e j d� Zee d�dd�Zejee d �d
d �Zd S )
�TocTreez�
Directive to notify Sphinx about the hierarchical structure of the docs,
and to include a table-of-contents like tree in the current document.
Tr F) �maxdepth�name�caption�glob�hidden�
includehidden�numbered�
titlesonly�reversed�r c C s� t �� }| jj|d< g |d< g |d< | j�dd�|d< | j�d�|d< d| jv |d< d| jv |d< d | jv |d < | j�d
d �|d
< d | jv |d < | �|� tjd
gd�}|� |� | �
|� | � |�}|� |� |S )N�parent�entries� includefilesr" ���r$ r% r& r' r( r r) ztoctree-wrapper)�classes) r �toctree�env�docname�options�get�set_source_infor Zcompound�appendZadd_name�
parse_content)�self�subnodeZ wrappernode�retr r r �run? s$
z TocTree.run)r1 r c C sJ | j j}| jj�� }|�| jj� g }t| j j�}| j D �]�}|sDq8t
� |�}|d r�t � |�r�|s�t
� |�s�t| jj|�}tt||��} | D ].}
|�|
� |d �d |
f� |d �|
� q�| s�tjtd�||d� q8|r�|�d�} |�d�} | }
n | } }
d } |D ]*}
|
�|
��r|
d t|
� � }
�q2�qt| jj|
�}
t
� | ��sV| dk�rj|d �| | f� q8|
| jjv�r�|| j�|
d ���r�td �}d
}n td �}d }tj||
d
||d� | j�� q8|
|v �r�|�|
� ntjtd�|
|d� |d �| |
f� |d �|
� q8d| jv �rFtt |d ��|d< tt |d ��|d< |S )Nr% r- r. z2toctree glob pattern %r didn't match any documents��location� � r9 z2toctree contains reference to excluded document %r�excludedz5toctree contains reference to nonexisting document %rZ not_readableZtoc)�type�subtyper> z%duplicated entry found in toctree: %sr* ) �configZ
source_suffixr2 Z
found_docs�copy�remover3 r Zexclude_patterns�contentr �match�glob_rer r �sortedr r7 �logger�warningr �group�endswith�lenZdoc2pathZ note_rereadr4 �listr* )r9 r1 �suffixesZ all_docnamesr; rA �entryZexplicitZpatnameZdocnamesr3 �ref�title�suffix�messagerC r r r r8 W st
��
�
�
� zTocTree.parse_contentN)�__name__�
__module__� __qualname__�__doc__� has_content�required_arguments�optional_arguments�final_argument_whitespacer r
Z unchangedZunchanged_required�flagr � option_specr r r< r r1 r8 r r r r r! * s" � r! c @ s@ e Zd ZU dZdZdZdZdZi Ze e
d< e e d�dd �Z
d
S ) �Authorz�
Directive to give the name of the author of the current document
or section. Shown in the output only if the show_authors option is on.
Fr@ r Tr` r+ c C s� | j js g S tjdd�}t�� }||7 }| jdkr<td�}n0| jdkrPtd�}n | jdkrdtd�}ntd �}|t�||�7 }| j� | j
d
| j �\}}|� |� |g}||7 }|S ) NF)Z translatable�
sectionauthorzSection author: � moduleauthorzModule author: �
codeauthorz
Code author: zAuthor: r )
rD Z show_authorsr � paragraphZemphasisr# r �Text�state� inline_text� arguments�lineno�extend)r9 ZparaZemph�text�inodes�messagesr; r r r r< � s$
z
Author.runN�rW rX rY rZ r[ r\ r] r^ r` r �__annotations__r r r< r r r r ra � s
ra c @ s e Zd ZdZejZdS )�SeeAlsozB
An admonition mentioning things to look at as reference.
N)rW rX rY rZ r �seealsoZ
node_classr r r r rq � s rq c @ s@ e Zd ZU dZdZdZdZdZi Ze e
d< e e d�dd �Z
d
S ) �TabularColumnszL
Directive to give an explicit tabulary column definition to LaTeX.
Fr@ r Tr` r+ c C s& t �� }| jd |d< | �|� |gS )Nr �spec)r Ztabular_col_specri r6 �r9 �noder r r r< � s
zTabularColumns.runNro r r r r rs � s
rs c @ s@ e Zd ZU dZdZdZdZdZi Ze e
d< e e d�dd �Z
d
S ) �Centeredz;
Directive to create a centered line of bold text.
Fr@ r Tr` r+ c C sH | j s
g S t�� }| j�| j d | j�\}}|�|� |g}||7 }|S )Nr )ri r �centeredrg rh rj rk )r9 r: rm rn r; r r r r< � s
z Centered.runNro r r r r rw � s
rw c @ s@ e Zd ZU dZdZdZdZdZi Ze e
d< e e d�dd�Z
d S )
�Acksz(
Directive for a list of names.
Tr Fr` r+ c C sl t �� }| jj|_| j�| j| j|� t|j�dksFt |jd t
j �sft j
td�| jj| jfd� g S |gS )Nr@ r z .. acks content is not a listr= )r �acksrg �document� nested_parserG �content_offsetrO �children�
isinstancer � bullet_listrK rL r r2 r3 rj ru r r r r< � s
�
�zAcks.runNro r r r r ry � s
ry c @ sD e Zd ZU dZdZdZdZdZdeiZ e
e d< e e
d�dd �Zd
S ) �HListz@
Directive for a list that gets compacted horizontally.
Tr F�columnsr` r+ c C s | j �dd�}t�� }| jj|_| j�| j| j|� t |j
�dksTt |j
d tj �stt
jtd�| jj| jfd� g S |j
d }tt |�|�\}}d}t�� }t|�|d< t|�D ]J}|||k r�|d n| } t� � }
|
|j
|| � 7 }
|t�d|
�7 }| }q�|gS ) Nr� r? r@ r z .. hlist content is not a listr= �ncolumns� )r4 r5 r re rg r{ r| rG r} rO r~ r r� rK rL r r2 r3 rj �divmodr �hlist�str�rangeZhlistcol) r9 r� rv ZfulllistZnpercolZnmore�indexZnewnode�columnZendindexr� r r r r< s.
�
�
z HList.runN)rW rX rY rZ r[ r\ r] r^ r r` r rp r r r< r r r r r� s
� r� c @ s@ e Zd ZU dZdZdZdZdZi Ze e
d< e e d�dd�Z
d S )
�OnlyzI
Directive to only include text if the given tag(s) are enabled.
Tr@ r r` r+ c C sL t �� }| jj|_| �|� | jd |d< | jj}|j}|j}g |_d|_z�| jj | j
| j |dd� |j}|r�|r�|d |vs�| jj s�|gW ||_||_S d}| jj }|r�|d7 }|j }q�|d8 }|d }t
|�} ||v r�|�|�} || d }
ttj| jj �}t|
�D ]} |j �r|j }�q|�|� g W ||_||_S ||_||_0 d S )Nr �exprT)Z match_titlesr@ r? )r �onlyrg r{ r6 ri �memo� title_stylesZ
section_levelr| rG r} r, rO r� r r r r� r7 ) r9 rv r� Zsurrounding_title_stylesZsurrounding_section_levelr� Z
current_depthr, Z title_styleZ nested_depthZn_sects_to_raiseZ_ir r r r< 3 sb
��
���
� �zOnly.runNro r r r r r� ) s
r� c s* e Zd ZdZee d�� fdd� Z� ZS )r
z�
Like the standard "Include" directive, but interprets absolute paths
"correctly", i.e. relative to source directory.
r+ c s` | j d �d�r*| j d �d�r*t� �� S | j�| j d �\}}|| j d< | j�|� t� �� S )Nr �<�>)ri �
startswithrN �superr< r2 Z
relfn2pathZ
note_included)r9 Z rel_filename�filename�� __class__r r r< i s �
z Include.run)rW rX rY rZ r r r< �
__classcell__r r r� r r
c s r
r )�appr c C s� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �d t� t �d
t � t �d t
� t �d t � t �d
t � dddd�S )Nr1 rb rc rd rr Ztabularcolumnsrx rz r� r� ZincludeZcssclassz rst-classZbuiltinT)�versionZparallel_read_safeZparallel_write_safe) r
Zregister_directiver! ra rq rs rw ry r� r� r
r )r� r r r �setupt s" �r� )<rZ �re�typingr r r r r Zdocutilsr Zdocutils.nodesr r Zdocutils.parsers.rstr
Z+docutils.parsers.rst.directives.admonitionsr Z$docutils.parsers.rst.directives.miscr r
Z BaseIncludeZsphinxr Zsphinx.domains.changesetr Z
sphinx.localer r Z sphinx.utilr r r Zsphinx.util.docutilsr Zsphinx.util.matchingr r Zsphinx.util.nodesr Zsphinx.util.typingr Zsphinx.applicationr �compilerI Z getLoggerrW rK r� r r r! ra rq rs rw ry r� r� r� r r r r �<module> s>
t"%: