| 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�G � @ sx d Z ddlZddlZddlmZ ddlmZmZmZm Z m
Z
ddl m Z ddl
mZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
l m Z m Z ddl m Z ddl!m"Z" er�ddl#m$Z$ e �%e&�Z'G dd� de �Z(d#e e) e*e
e)e*f e e) d�dd�Z+e ee)e j,d�dd�Z-G dd� de �Z.G dd � d �Z/G d d � d e �Z0d ee)ef d �d!d"�Z1dS )$z�
sphinx.directives.code
~~~~~~~~~~~~~~~~~~~~~~
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)� unified_diff)�
TYPE_CHECKING�Any�Dict�List�Tuple)�nodes)�Element�Node)�
directives)�
StringList)�addnodes)�Config)� optional_int)�__)�logging� parselinenos)�SphinxDirective)�
OptionSpec)�Sphinxc @ sJ e Zd ZU dZdZdZdZdZej ej
d�Z e e
d< ee d�dd �Zd
S ) � Highlightzt
Directive to set the highlighting language for code blocks, as well
as the threshold for line numbers.
F� r )�force�linenothreshold� option_spec��returnc C sF | j d �� }| j�dtj�}d| jv }|| jjd< tj |||d�gS )Nr r r �highlight_language)�langr r )
� arguments�strip�options�get�sys�maxsize�env� temp_datar
Z
highlightlang)�self�languager r � r) �:/usr/lib/python3.9/site-packages/sphinx/directives/code.py�run0 s
�z
Highlight.runN)�__name__�
__module__� __qualname__�__doc__� has_content�required_arguments�optional_arguments�final_argument_whitespacer �flagZ positive_intr r �__annotations__r r
r+ r) r) r) r* r ! s
�r )�lines�dedent�locationr c s� � d u r t �d�| ���d�S t� fdd�| D ��rFtjtd�|d� g }| D ],}|� d � }|�d�rp|spd}|� |� qN|S )N� Tc 3 s | ]}|d � � � � V qd S �N)r )�.0�s�r7 r) r* � <genexpr>? � z dedent_lines.<locals>.<genexpr>z!non-whitespace stripped by dedent�r8 �
)
�textwrapr7 �join�
splitlines�any�logger�warningr �endswith�append)r6 r7 r8 � new_lines�lineZnew_liner) r= r* � dedent_lines; s rL )� directive� literal_node�captionr c C s� t jdddgd�}t �� }| j�t|gdd�| j|� t|d t j�rdt d|d �
� �}t |��nXt|d t j�r�t j |d j
dg|d j�R � }|j|_|j|_||7 }||7 }|S t�d S )Nr9 Tzliteral-block-wrapper)�
literal_block�classes��sourcer zInvalid caption: %s)r � containerr �stateZ nested_parser Zcontent_offset�
isinstanceZsystem_messager Zastext�
ValueErrorrO Z rawsourceZchildrenrS rK � RuntimeError)rM rN rO Zcontainer_node�parsed�msgZ caption_noder) r) r* �container_wrapperL s( ��
�r[ c @ s^ e Zd ZU dZdZdZdZdZej ej e
e ej ej ej
ejd�Zeed< ee d�d d
�Zd S ) � CodeBlockz^
Directive for a code block with special highlighting or line numbering
settings.
Tr r F)r �linenosr7 � lineno-start�emphasize-linesrO �class�namer r c
sH | j j}d�| j�}| j�| j�}| j�d�}|r�z`t | j�� t
|� �}t � fdd�|D ��r~t j
td�� | jd f |d� � fdd�|D �}W q� ty� } z |jj
|| jd �gW Y d }~S d }~0 0 nd }d
| jv �r| j�| j�}|�d �}t|| jd
|d�}d �|�}t�||�}d
| jv �s8d| jv �r@d |d
< |d | j�dg �7 < d| jv |d< | j�r�| jd |d< n| jj�d| jj�|d< i } |d< |d u�r�|| d< d| jv �r�| jd | d< | �|� | j�d�}
|
�r8zt| ||
�}W n: t�y6 } z |jj
| | jd �gW Y d } ~ S d } ~ 0 0 | � |� |gS )NrA r_ c 3 s | ]}|� kV qd S r: r) �r; �i�Znlinesr) r* r> � r? z CodeBlock.run.<locals>.<genexpr>�*line number spec is out of range(1-%d): %rr@ c s g | ]}|� k r|d �qS �r r) �r; �xrd r) r* �
<listcomp>� r? z!CodeBlock.run.<locals>.<listcomp>�rK r7 Tr9 r] r^ rQ r` r r r( r �highlight_args�hl_lines� linenostartrO ) rU �documentrC Zcontent�
state_machine�get_source_and_line�linenor! r" �lenr rE rF rG r rW �reporterrD rL r rP r r% r& �configr �set_source_infor[ �add_name) r' rn �coder8 �linespecrl �errr6 �literal�
extra_argsrO �excr) rd r* r+ v s^
��,
�
*
z
CodeBlock.runN)r, r- r. r/ r0 r1 r2 r3 r r4 r �int�unchanged_required� class_option� unchangedr r r5 r r
r+ r) r) r) r* r\ a s
� r\ c @ s� e Zd Zg d�Zeeedd�dd�Zdd�dd�Zd ee ee
f e e d �d
d �Z d!e ee
f e ee
f d �d
d�Z
d"e ee
f e e d �dd�Zd#e e e ee
f e e d�dd�Zd$e e e ee
f e e d�dd�Zd%e e e ee
f e e d�dd�Zd&e e e ee
f e e d�dd�Zd'e e e ee
f e e d�dd�Zd(e e e ee
f e e d�d d �Zd)e e e ee
f e e d�d d �ZdS )*�LiteralIncludeReader)
)� lineno-matchr^ )r� rI )r� �prepend)� start-after�start-at)�
end-before�end-at)�diff�pyobject)r� r^ )r� r� )r� r6 )r� r� )r� r� )r� r� )r� r� N)�filenamer! rt r c C s8 || _ || _|�d|j�| _| j�dd�| _| �� d S )N�encodingr^ r )r� r! r" Zsource_encodingr� � lineno_start�
parse_options)r' r� r! rt r) r) r* �__init__� s
z LiteralIncludeReader.__init__r c C s< | j D ]0\}}|| jv r|| jv rttd�||f ��qd S )Nz%Cannot use both "%s" and "%s" options)�INVALID_OPTIONS_PAIRr! rW r )r' Zoption1Zoption2r) r) r* r� � s
�z"LiteralIncludeReader.parse_options)r� r8 r c
C s� zbt || jdd��>}|�� }d| jv r6|�| jd �}|�d�W d � W S 1 sV0 Y W np ty� } z ttd�| �|�W Y d }~nDd }~0 ty� } z$ttd�| j|f �|�W Y d }~n
d }~0 0 d S )N�strict)r� �errors� tab-widthTz.Include file %r not found or reading it failedz`Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option) �openr� �readr! �
expandtabsrD �OSErrorr � UnicodeError)r' r� r8 �f�textr| r) r) r* � read_file� s$
.����z LiteralIncludeReader.read_file)r8 r c C sl d| j v r| �� }nF| j| j| j| j| j| j| jg}| j | j
|d�}|D ]}|||d�}qHd� |�t |�fS )Nr� r@ r9 )
r! � show_diff�pyobject_filter� start_filter�
end_filter� lines_filter�prepend_filter�
append_filter�
dedent_filterr� r� rC rr )r' r8 r6 �filters�funcr) r) r* r� � s
�zLiteralIncludeReader.readc C s: | � | j�}| j�d�}| � |�}t|||| j�}t|�S )Nr� )r� r� r! r" r �list)r' r8 rJ Z old_filenameZ old_linesr� r) r) r* r� � s
z LiteralIncludeReader.show_diff)r6 r8 r c C s� | j �d�}|r�ddlm} |�| jd�}|�� }||vrRttd�|| jf ��n8|| d }|| d }||d |� }d| j v r�|| _ |S ) Nr� r )�ModuleAnalyzerr9 z,Object named %r not found in include file %rr � r� )
r! r" Z
sphinx.pycoder� Zfor_filer� Z find_tagsrW r r� ) r' r6 r8 r� r� Zanalyzer�tags�start�endr) r) r* r� � s �
z$LiteralIncludeReader.pyobject_filterc s� | j �d�}|r�t|t���}t�fdd�|D ��rRtjtd�t��|f |d� d| j v r�|d � t� fdd�t |�D ��r�| j
|d 7 _
n t td ����fd
d �|D ���g kr�t td �|| j f ���S )
Nr6 c 3 s | ]}|t � �kV qd S r: �rr rb �r6 r) r* r> r? z4LiteralIncludeReader.lines_filter.<locals>.<genexpr>re r@ r� r c 3 s | ]\}}� | |kV qd S r: r) )r; rc �n)�firstr) r* r> r? z8Cannot use "lineno-match" with a disjoint set of "lines"c s g | ]}|t � �k r� | �qS r) r� )r; r� r� r) r* ri r? z5LiteralIncludeReader.lines_filter.<locals>.<listcomp>z2Line spec %r: no lines pulled from include file %r)
r! r" r rr rE rF rG r �all� enumerater� rW r� )r' r6 r8 rx Zlinelistr) )r� r6 r* r�
s(
��
�z!LiteralIncludeReader.lines_filterc C s� d| j v r | j �d�}d}n d| j v r8| j �d�}d}nd }|r�t|�D ]l\}}||v rH|r�d| j v rx| j|d 7 _||d d � S d| j v r�| j|7 _||d � S qH|du r�td| ��n td| ��|S ) Nr� Fr� Tr� r z!start-after pattern not found: %sz start-at pattern not found: %s)r! r" r� r� rW )r' r6 r8 r� � inclusiverq rK r) r) r* r� % s*
z!LiteralIncludeReader.start_filterc C s� d| j v r | j �d�}d}n d| j v r8| j �d�}d}nd }|r�t|�D ]B\}}||v rH|rp|d |d � S |dkrzqH|d |� S qH|du r�td| ��n td| ��|S ) Nr� Tr� Fr r z end-at pattern not found: %sz end-before pattern not found: %s)r! r" r� rW )r' r6 r8 r� r� rq rK r) r) r* r� D s&
z LiteralIncludeReader.end_filterc C s$ | j �d�}|r |�d|d � |S )Nr� r rA )r! r" �insert)r' r6 r8 r� r) r) r* r� _ s z#LiteralIncludeReader.prepend_filterc C s" | j �d�}|r |�|d � |S )NrI rA )r! r" rI )r' r6 r8 rI r) r) r* r� f s z"LiteralIncludeReader.append_filterc C s( d| j v r t|| j �d�|d�S |S d S )Nr7 r@ )r! rL r" )r' r6 r8 r) r) r* r� m s
z"LiteralIncludeReader.dedent_filter)N)N)N)N)N)N)N)N)N)N)r, r- r. r� �strr r r� r� r r} r r� r� r� r� r� r� r� r� r� r� r) r) r) r* r� � s " $$$ $$$r� c @ s� e Zd ZU dZdZdZdZdZee j
e e j
e e j e j
e j
e j e j e j e j e j e j e j e j e j e je je je j d�Zeed< ee d�d d
�Zd S ) �LiteralIncludez�
Like ``.. include:: :literal:``, but only warns if the include file is
not found, and does not raise errors. Also has several options for
selecting what to include.
Fr r T)r7 r] r^ r� r� r( r r� r� r6 r� r� r� r� r� rI r_ rO r` ra r� r r c
s< | j j}|jjs$|jjd| jd�gS d| jv rN| j� | jd �\}}|| jd< �z�| j
� | j�}| j� | j d �\}}| j�
|� t|| j| j�}|j|d�\}� tj|||d�} d| jv | d< | �| � | j�d�r�d| d < nd | jv r�| jd | d < d
| jv �s d | jv �s d | jv �r$d
| d
< | d | j�dg �7 < i }
| d< d| jv �r�t| jd � �} t� fdd�| D ���r�tjtd�� | jd f |d� � fdd�| D �|
d< |j|
d< d| jv �r�| jd �p�| j d } t| | | �} | �| � | gW S t �y6 }
z |jj|
| jd�gW Y d }
~
S d }
~
0 0 d S )NzFile insertion disabledrj r� r r@ rR r Zudiffr( r] r^ r� TrQ r` rk r_ c 3 s | ]}|� kV qd S r: r) rb r� r) r* r> � r? z%LiteralInclude.run.<locals>.<genexpr>re c s g | ]}|� k r|d �qS rf r) rg r� r) r* ri � r? z&LiteralInclude.run.<locals>.<listcomp>rl rm rO ) rU rn ZsettingsZfile_insertion_enabledrs rG rq r! r% Z
relfn2pathro rp r Znote_dependencyr� rt r� r rP ru r" r rE rF r r� r[ rv � Exception)r' rn �_�pathr8 Z rel_filenamer� �readerr� Zretnoder{ rl rO r| r) r� r* r+ � sX �
�
��
zLiteralInclude.runN)r, r- r. r/ r0 r1 r2 r3 r r r4 r} r~ r� r� r r r r5 r r
r+ r) r) r) r* r� t s8
�r� r )�appr c C s< t �dt� t �dt� t �dt� t �dt� dddd�S )NZ highlightz
code-blockZ
sourcecodeZliteralincludeZbuiltinT)�versionZparallel_read_safeZparallel_write_safe)r Zregister_directiver r\ r� )r� r) r) r* �setup� s �r� )N)2r/ r# rB Zdifflibr �typingr r r r r Zdocutilsr Zdocutils.nodesr r
Zdocutils.parsers.rstr Zdocutils.statemachiner Zsphinxr
Z
sphinx.configr Zsphinx.directivesr Z
sphinx.localer Z sphinx.utilr r Zsphinx.util.docutilsr Zsphinx.util.typingr Zsphinx.applicationr Z getLoggerr, rF r r� r} rL rT r[ r\ r� r� r� r) r) r) r* �<module> s4
&S AW