File: //usr/lib/python3/dist-packages/sphinx/directives/__pycache__/code.cpython-310.pyc
o
�$�a�G �
@ s� 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" erlddl#m$Z$ e �%e&�Z'G dd� de �Z(d(de e) de*de
e)e*f de e) fdd�Z+de dede)de j,fd d �Z-G d d � d e �Z.G d d!� d!�Z/G d"d#� d#e �Z0d$d%dee)ef fd&d'�Z1dS ))z�
sphinx.directives.code
~~~~~~~~~~~~~~~~~~~~~~
:copyright: Copyright 2007-2021 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< dee fdd �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
�
highlightlang)�self�languager r � r) �8/usr/lib/python3/dist-packages/sphinx/directives/code.py�run0 s
�z
Highlight.runN)�__name__�
__module__� __qualname__�__doc__� has_content�required_arguments�optional_arguments�final_argument_whitespacer �flag� positive_intr r �__annotations__r r
r+ r) r) r) r* r ! s
�r �lines�dedent�locationr c s| � s
t �d�| ���d�S t� fdd�| D ��r!tjtd�|d� g }| D ]}|� d � }|�d�r6|s6d}|� |� q%|S )N� Tc 3 s � | ] }|d � � � � V qd S �N)r )�.0�s�r8 r) r* � <genexpr>? � � z dedent_lines.<locals>.<genexpr>z!non-whitespace stripped by dedent�r9 �
)
�textwrapr8 �join�
splitlines�any�logger�warningr �endswith�append)r7 r8 r9 � new_lines�line�new_liner) r> r* � dedent_lines; s rN � directive� literal_node�captionc C s� t jdddgd�}t �� }| j�t|gdd�| j|� t|d t j�r1t d|d �
� �}t |��t|d t j�r[t j |d j
dg|d j�R � }|j|_|j|_||7 }||7 }|S t�)Nr: Tzliteral-block-wrapper)�
literal_block�classes��sourcer zInvalid caption: %s)r � containerr �state� nested_parser �content_offset�
isinstance�system_messager �astext�
ValueErrorrQ � rawsource�childrenrU rL � RuntimeError)rO rP rQ �container_node�parsed�msg� caption_noder) r) r* �container_wrapperL s( ���re c @ s^ e Zd ZU dZdZdZdZdZej ej e
e ej ej ej
ejd�Zeed< dee fd d
�Zd S ) � CodeBlockz^
Directive for a code block with special highlighting or line numbering
settings.
Tr r F)r �linenosr8 � lineno-start�emphasize-linesrQ �class�namer r c
s: | j j}d�| j�}| j�| j�}| j�d�}|rfz0t | j�� t
|� �}t � fdd�|D ��r?t j
td�� | jd f |d� � fdd�|D �}W n tye } z|jj
|| jd �gW Y d }~S d }~ww d }d
| jv r�| j�| j�}|�d�}t|| jd
|d�}d�|�}t�||�}d | jv s�d | jv r�d
|d < |d | j�dg �7 < d| jv |d< | jr�| jd |d< n | jj�d| jj�|d< i } |d< |d ur�|| d< d | jv r�| jd | d< | �|� | j�d�}
|
�rzt| ||
�}W n t�y } z|jj
| | jd �gW Y d } ~ S d } ~ ww | � |� |gS )NrB ri c 3 � � | ]}|� kV qd S r; r) �r< �i��nlinesr) r* r? � � � z CodeBlock.run.<locals>.<genexpr>�*line number spec is out of range(1-%d): %rrA c � g | ]
}|� k r|d �qS �r r) �r< �xro r) r* �
<listcomp>� � z!CodeBlock.run.<locals>.<listcomp>�rL r8 rg rh TrS rj r r r( r �highlight_args�hl_lines� linenostartrQ ) rW �documentrD �content�
state_machine�get_source_and_line�linenor r! �lenr rF rG rH r r] �reporter�splitrN r rR r r$ r% �configr �set_source_infore �add_name) r' r} �coder9 �linespecr{ �errr7 �literal�
extra_argsrQ �excr) ro r* r+ v sf
�� ��
�
��
z
CodeBlock.runN)r, r- r. r/ r0 r1 r2 r3 r r4 r �int�unchanged_required� class_option� unchangedr r r6 r r
r+ r) r) r) r* rf a s
� rf c @ s� e Zd Zg d�Zdedededdfdd�Zd!d d
�Zd"ded e ee
f de e fd d
�Z d"d e ee
f de ee
f fdd�Z
d"d e ee
f de e fdd�Zd"de e d e ee
f de e fdd�Zd"de e d e ee
f de e fdd�Zd"de e d e ee
f de e fdd�Zd"de e d e ee
f de e fdd�Zd"de e d e ee
f de e fdd �Zd"de e d e ee
f de e fd d �Zd"de e d e ee
f de e fd d �ZdS )#�LiteralIncludeReader)
)� lineno-matchrh )r� rJ )r� �prepend)� start-after�start-at)�
end-before�end-at)�diff�pyobject)r� rh )r� r� )r� r7 )r� r� )r� r� )r� r� )r� r� �filenamer r� r Nc C s8 || _ || _|�d|j�| _| j�dd�| _| �� d S )N�encodingrh r )r� r r! �source_encodingr� � lineno_start�
parse_options)r' r� r r� r) r) r* �__init__� s
z LiteralIncludeReader.__init__c C s< | j D ]\}}|| jv r|| jv rttd�||f ��qd S )Nz%Cannot use both "%s" and "%s" options)�INVALID_OPTIONS_PAIRr r] r )r' �option1�option2r) r) r* r� � s ���z"LiteralIncludeReader.parse_optionsr9 c
C s� z2t || jdd�� }|�� }d| jv r|�| jd �}|�d�W d � W S 1 s+w Y W d S tyG } z ttd�| �|�d }~w ty^ } z ttd�| j|f �|�d }~ww )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 �
expandtabsrE �OSErrorr � UnicodeError)r' r� r9 �f�textr� r) r) r* � read_file� s,
(��������z LiteralIncludeReader.read_filec C sl d| j v r
| �� }n#| j| j| j| j| j| j| jg}| j | j
|d�}|D ]}|||d�}q$d� |�t |�fS )Nr� rA r: )
r � show_diff�pyobject_filter� start_filter�
end_filter� lines_filter�prepend_filter�
append_filter�
dedent_filterr� r� rD r� )r' r9 r7 �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' r9 rK � old_filename� old_linesr� r) r) r* r� � s
z LiteralIncludeReader.show_diffr7 c C s� | j �d�}|rDddlm} |�| jd�}|�� }||vr(ttd�|| jf ��|| d }|| d }||d |� }d| j v rD|| _ |S ) Nr� r )�ModuleAnalyzerr: z,Object named %r not found in include file %rr � r� )
r r! �
sphinx.pycoder� �for_filer� � find_tagsr] r r� ) r' r7 r9 r� r� �analyzer�tags�start�endr) r) r* r� � s �
z$LiteralIncludeReader.pyobject_filterc s� | j �d�}|rgt|t���}t�fdd�|D ��r)tjtd�t��|f |d� d| j v rO|d � t� fdd�t |�D ��rI| j
|d 7 _
nt td ����fd
d �|D ���g krgt td �|| j f ���S )
Nr7 c 3 s � | ] }|t � �kV qd S r; �r� rm �r7 r) r* r? s � z4LiteralIncludeReader.lines_filter.<locals>.<genexpr>rr rA r� r c 3 s � | ] \}}� | |kV qd S r; r) )r< rn �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* rw s z5LiteralIncludeReader.lines_filter.<locals>.<listcomp>z2Line spec %r: no lines pulled from include file %r)
r r! r r� rF rG rH r �all� enumerater� r] r� )r' r7 r9 r� �linelistr) )r� r7 r* r�
s(
��
�z!LiteralIncludeReader.lines_filterc C s� d| j v r| j �d�}d}nd| j v r | j �d�}d}nd }|rkt|�D ]6\}}||v rZ|rFd| j v r<| j|d 7 _||d d � S d| j v rR| j|7 _||d � S q$|du retd| ��td| ��|S ) Nr� Fr� Tr� r z!start-after pattern not found: %sz start-at pattern not found: %s)r r! r� r� r] )r' r7 r9 r� � inclusiver� rL r) r) r* r� % s,
� z!LiteralIncludeReader.start_filterc C s� d| j v r| j �d�}d}nd| j v r | j �d�}d}nd }|rVt|�D ]!\}}||v rE|r8|d |d � S |dkr=q$|d |� S q$|du rPtd| ��td| ��|S ) Nr� Tr� Fr r z end-at pattern not found: %sz end-before pattern not found: %s)r r! r� r] )r' r7 r9 r� r� r� rL r) r) r* r� D s(
� z LiteralIncludeReader.end_filterc C s$ | j �d�}|r|�d|d � |S )Nr� r rB )r r! �insert)r' r7 r9 r� r) r) r* r� _ s z#LiteralIncludeReader.prepend_filterc C s" | j �d�}|r|�|d � |S )NrJ rB )r r! rJ )r' r7 r9 rJ r) r) r* r� f s z"LiteralIncludeReader.append_filterc C s$ d| j v rt|| j �d�|d�S |S )Nr8 rA )r rN r! )r' r7 r9 r) r) r* r� m s
z"LiteralIncludeReader.dedent_filter)r Nr; )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 dZdZdZdZdZi de�de j
�de �d e j
�d
e �d e j �d e j
�d
e j
�de j �de j �de j �de j �de j �de j �de j �de j �de j �e je je je j d��Zeed< dee fdd�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 Tr8 rg rh r� r� r( r r� r� r7 r� r� r� r� r� rJ ri )rQ rj rk r� r r c
s( | j j}|jjs|jjd| jd�gS d| jv r'| j� | jd �\}}|| jd< z�| j
� | j�}| j� | j d �\}}| j�
|� t|| j| j�}|j|d�\}� tj|||d�} d| jv | d< | �| � | j�d�rod| d < n d | 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 �y }
z|jj|
| jd�gW Y d }
~
S d }
~
ww )NzFile insertion disabledry r� r rA rT r �udiffr( rg rh r� TrS rj rz ri c 3 rl r; r) rm r� r) r* r? � rq z%LiteralInclude.run.<locals>.<genexpr>rr c rs rt r) ru r� r) r* rw � rx z&LiteralInclude.run.<locals>.<listcomp>r{ r| rQ ) rW r} �settings�file_insertion_enabledr� rH r� r r$ �
relfn2pathr r� r �note_dependencyr� r� r� r rR r� r! r rF rG r r� re r� � Exception)r' r} �_�pathr9 � rel_filenamer� �readerr� �retnoder� r{ rQ r� r) r� r* r+ � sZ �
��
��zLiteralInclude.runN)r, r- r. r/ r0 r1 r2 r3 r r r4 r� r� r� r� r� r r r6 r r
r+ r) r) r) r* r� t s^
�������� �
� � �
������r� �appr c C s< t �dt� t �dt� t �dt� t �dt� dddd�S )N� highlightz
code-block�
sourcecode�literalinclude�builtinT)�version�parallel_read_safe�parallel_write_safe)r �register_directiver rf r� )r� r) r) r* �setup� s �r� r; )2r/ r" rC �difflibr �typingr r r r r �docutilsr �docutils.nodesr r
�docutils.parsers.rstr �docutils.statemachiner �sphinxr
�
sphinx.configr �sphinx.directivesr �
sphinx.localer � sphinx.utilr r �sphinx.util.docutilsr �sphinx.util.typingr �sphinx.applicationr � getLoggerr, rG r r� r� rN rV re rf r� r� r� r) r) r) r* �<module> s6
, S A W