File: //usr/lib/python3/dist-packages/docutils/parsers/rst/directives/__pycache__/misc.cpython-310.pyc
o
f'ha�d � @ sT d Z dZddlZddlZddlZddlZddlZddlmZm Z m
Z
m Z ddl m
Z
mZ ddl mZ ddlmZmZ ddlmZmZmZ dd lmZmZ dd
lmZ dd lm Z G d d
� d
e�Z G dd� de�Z G dd� de�Z G dd� de�Z G dd� de�Z!G dd� de�Z"G dd� de�Z#G dd� de�Z$G d d � d e�Z%G d d � d e�Z&dS ) zMiscellaneous directives.�reStructuredText� N)�io�nodes� statemachine�utils)�
SafeString� ErrorString)�locale_encoding)� Directive�convert_directive_function)�
directives�roles�states)� CodeBlock� NumberLines)� set_classes)�miscc
@ sj e Zd ZdZdZdZdZejej ej
ej e e e ej
ej
ej ejej d� Zej�e�ej�d�Zdd� Zd S )
�Includea]
Include content read from a separate source file.
Content may be parsed by the parser, or included as a literal
block. The encoding of the included file can be specified. Only
a part of the given file argument may be included by specifying
start and end line or text to match before and/or after the text
to be used.
� r T) �literal�code�encoding�parser� tab-width�
start-line�end-line� start-after�
end-before� number-lines�class�name�includec sf �j jjjs��d�j ���jj��j �jj
d �}t j �
t j �|��}t� �jd �}|�d�rD|�d�rDt j ��j|dd� �}t j �t j �||��}t�d|�}t�|�}�j�d�j jjj �}�j jjj }�j�d �j jjj �}z�j jjj � |� t!j"|||d
�}W n/ t#y� } z ��$d �jt%|�f ��d}~w t&y� } z ��$d �jt'|�f ��d}~ww �j�d
d�} �j�dd�}
z| s�|
dur�|�(� } d�| | |
� �} n|�)� } W n t*y� } z ��$d�jt'|�f ��d}~ww �j�dd�}
|
�r | �+|
�}|dk �r��$d�j ��| |t,|
� d� } �j�dd�}|�rB| �+|�}|dk �r<��$d�j ��| d|� } t-j.| |dd�� t/� �D ]\}}t,|��j jjj0k�rh��d||d f ���qNd�jv �r�|dk�r{| �1|�}n| }tj2| |�j�dg �d�}d|_3��4|� d�jv �r�z t5�jd �p�d�} W n
t6�y� ��7d ��w | t,� � }
|�d ��r�|dd� }t8g |fg| |
�}|D ]\}}|�r�|tj9|||d �7 }�q�|t�:|�7 }�q�|gS |t�:|�7 }|gS d �jv �r(|�jd < |dk �r | �;� � t<�j�j�=d �g�j� �j �j>�j?�j �j� }|�@� S d!�jv �rI�jd! � }t�A|�j jj�}|�Bd �� �|� |jCS t�d|�}| |
||
f}�j jjD} | �sf|d"tEjFd# fg} �fd$d%�| D �} ||fd&d%� | D �v �r���d'�jd(�|gd)d%� | ddd� D � �f ���j�G� |� | �H||�j f� � fd*d%�| D ��j j_Dg S )+z8Include a file as part of the content of this reST file.�"%s" directive disabled.r r �<�>���Nr r �� source_pathr �
error_handlerzVProblems with "%s" directive path:
Cannot encode input file path "%s" (wrong locale?).�&Problems with "%s" directive path:
%s.r r � � Problem with "%s" directive:
%sr zDProblem with "start-after" option of "%s" directive:
Text not found.r zCProblem with "end-before" option of "%s" directive:
Text not found.T)�convert_whitespacez,"%s": line %d exceeds the line-length-limit.r r )�source�classesr z+:number-lines: with non-integer start value�
)r. r r- r )NNNN� c s g | ] }|d � j kr|�qS �r0 )�lineno)�.0�entry��self� �F/usr/lib/python3/dist-packages/docutils/parsers/rst/directives/misc.py�
<listcomp>� s �z Include.run.<locals>.<listcomp>c S s g | ] \}}}||f�qS r7 r7 �r3 �pth�opt�er7 r7 r8 r9 � s �z(circular inclusion in "%s" directive: %sz < c S s g | ]\}}}|�qS r7 r7 r: r7 r7 r8 r9 � s c s( g | ]\}}}|||t � � d f�qS r1 )�lenr: )�
include_linesr7 r8 r9 � s �)I�state�document�settings�file_insertion_enabled�warningr �
state_machine� input_linesr- r2 � input_offset�os�path�dirname�abspathr � arguments�
startswith�endswith�join�standard_include_path�normpathr �
relative_pathr � reprunicode�options�get�input_encoding� input_encoding_error_handler� tab_width�record_dependencies�addr � FileInput�UnicodeEncodeError�severer �IOErrorr � readlines�read� UnicodeError�findr> r � string2lines� enumerate�line_length_limit�
expandtabs�
literal_block�line�add_name�int�
ValueError�errorr �inline�Text�
splitlinesr �pop�content_offset�
block_text�run� new_document�parse�children� include_log�sys�maxsize� insert_input�append) r6 r- �
source_dirrI r � e_handlerrX � include_filerl � startline�endline�lines�rawtext�
after_text� after_index� before_text� before_index�irh �textrg �tokensr. �value� codeblockr rA � clip_optionsrw r7 )r? r6 r8 rs 7 s �
� �
� �� ��� � ���
�
� �
��
�
�
��
�
�
��
�z Include.runN)�__name__�
__module__� __qualname__�__doc__�required_arguments�optional_arguments�final_argument_whitespacer �flag� unchangedr � parser_namerj �unchanged_required� class_option� option_specrH rI rO �docutils�_datadirr �__file__rP rs r7 r7 r7 r8 r s,
�� r c @ s: e Zd ZdZdZdZdZejej ej
d�Z dZ dd� Z
dS ) �Rawz�
Pass through content unchanged
Content is included in output based on type argument
Content may be included inline (content section of directive) or
imported from a file or url.
r r T)�file�urlr c
C s� | j jjjr| j jjjs d| jv sd| jv r | �d| j ��dd�| j d �
� � � �i}| j� d| j jjj
�}| j jjj}| jrZd| jv sJd| jv rR| �d| j ��d �| j�}�nd| jv r�d| jv rl| �d
| j ��tj�tj�| j jj��}tj�tj�|| jd ��}t�d |�}ztj|||d �}| j jjj� |� W n t y� } z | � d | jt |�f ��d }~ww z|� � }W n t!y� } z | � d
| jt |�f ��d }~ww ||d< n�d| jv �rY| jd } t"j#dkr�ddl$m%}
ddl&m'} nddl(m%}
m'} z|
| �� � } W n | t t)f�y* } z| � d| j| jd t |�f ��d }~ww tj*| | ||d�}z|� � }W n t!�yS } z | � d
| jt |�f ��d }~ww | |d< n| �+� t,j-d|fi |��}
| j.�/| j0�\|
_1|
_2|
gS )Nr� r� r" �format� r r zF"%s" directive may not both specify an external file and have content.r/ zXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.r& r) r+ r- �� r )�urlopen)�URLError)r� r� z*Problems with "%s" directive URL "%s":
%s.)r- r' r r( r* )3r@ rA rB � raw_enabledrC rT rD r rO rL �lower�splitrU rV rW �contentrl rH rI rJ rK �current_sourcerQ r rR r r[ rY rZ r^ r] r r` ra rx � version_info�urllib.requestr� � urllib.errorr� �urllib2�OSError� StringInput�assert_has_contentr �rawrE �get_source_and_liner2 r- rh )r6 �
attributesr r} r� r| rI �raw_filerl r- r� r� �raw_text�raw_noder7 r7 r8 rs � s�
�
� ��
���� � ��� ���
���� ���
�zRaw.runN)r� r� r� r� r� r� r� r rI �urir r� � has_contentrs r7 r7 r7 r8 r� � s � r� c @ � e Zd ZdZdd� ZdS )�ReplaceTc C s� t | jtj�s| �d| j ��| �� d�| j�}t �
|�}| j� | j| j |� d }g }|D ],}|s;t |t j
�r;|}q.t |t j�rKg |d< |�|� q.| jjjd| j | jd�g S |rb||j S |S )N�VInvalid context: the "%s" directive can only be used within a substitution definition.r/ �backrefsz=Error in "%s" directive: may contain a single paragraph only.�rh )�
isinstancer@ r �SubstitutionDefrl r r� rO r� r �Element� nested_parserq � paragraph�system_messager{ rE �reporterr2 rv )r6 r� �element�node�messages�elemr7 r7 r8 rs . s< ��
� ���
z Replace.runN�r� r� r� r� rs r7 r7 r7 r8 r� * � r� c @ s@ e Zd ZdZdZdZdZejejejd�Z e
� d�Z dd� Z
d S )
�Unicodea{
Convert Unicode character codes (numbers) to characters. Codes may be
decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``,
``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character
entities (e.g. ``☮``). Text following ".." is a comment and is
ignored. Spaces are ignored, and any other text remains as-is.
r r T)�trim�ltrim�rtrimz
( |\n|^)\.\. c C s� t | jtj�s| �d| j ��| jj}d| jv r"d|j d< d|j d< d| jv r,d|j d< d| jv r6d|j d< | j
� | j d �d � � }t
�� }|D ](}zt�|�}W n tyi } z | �d|t|�f ��d }~ww |t
�|�7 }qI|jS )Nr� r� r r� r� r z Invalid character code: %s
%s)r� r@ r r� rl r rE r� rT r� �comment_patternr� rL r r� r � unicode_coderk r rn rv )r6 �substitution_definition�codesr� r �decodedrl r7 r7 r8 rs ] s6 ��
���z Unicode.runN)r� r� r� r� r� r� r� r r� r� �re�compiler� rs r7 r7 r7 r8 r� J s �
r� c @ s( e Zd ZdZdZdZdZdZdd� ZdS )�Classz�
Set a "class" attribute on the directive content or the next element.
When applied to the next element, a "pending" element is inserted, and a
transform does the work later.
r r Tc C s� z
t �| jd �}W n ty | �d| j| jd f ��w g }| jrFt�� }| j �
| j| j |� |D ] }|d � |� q4|� |j
� |S t�tj|| jd�| j�}| jj�|� |�|� |S )Nr z7Invalid class attribute value for "%s" directive: "%s".r. )r � directive)r r� rL rk rl r r� r r� r@ r� rq �extendrv �pendingr �ClassAttributerr rE rA � note_pendingr{ )r6 � class_value� node_list� containerr� r� r7 r7 r8 rs � s6 ���� �
�
z Class.runN) r� r� r� r� r� r� r� r� rs r7 r7 r7 r8 r� v s r� c @ s0 e Zd ZdZe�dejjfd �Z dd� Z
dS )�RoleTz (%s)\s*(\(\s*(%s)\s*\)\s*)?$r0 c
C s | j | jks | js| �d| j ��| jd }| j�|�}|s(| �d| j|f ��|�d�}|�d�}g }|rbt� || j
j | j| j j
�\}}|du ra| j j
jd| t�| j| j�| jd�}||g S ntj}t|d �rsJ d
| j|f ��zt|�}| j j| jdd� | j |i d �\} }
} } W n. tjy� }
z!| j
j
jd | j|
f t�| j| j�| jd�}||g W Y d}
~
S d}
~
ww d
|
vr�z t�|�|
d
< W n/ ty� }
z#| j
j
jd| jt|
�f t�| j| j�| jd�}||g W Y d}
~
S d}
~
ww t�|||
| �}t� ||� |S )z?Dynamically create and register a custom interpreted text role.z4"%s" directive requires arguments on the first line.r z4"%s" directive arguments not valid role names: "%s".r r� N�#Unknown interpreted text role "%s".r� rL z[Supplemental directive arguments for "%s" directive not supported (specified by "%r" role).)�option_presetsz Error in "%s" directive:
%s.r z(Invalid argument for "%s" directive:
%s.) rq r2 r� rl r �argument_pattern�match�groupr
�rolerE �languager@ r� r rg rr �generic_custom_role�hasattrr �parse_directive_blockr � MarkupErrorr r� rk r �
CustomRole�register_local_role)r6 �argsr� �
new_role_name�base_role_namer� � base_rolerl �converted_rolerL rT r� rq �detailr� r7 r7 r8 rs � s� �
�
��
� ���� ��� ����� zRole.runN) r� r� r� r� r� r� r �Inliner�
simplenamer� rs r7 r7 r7 r8 r� � s � r� c @ � e Zd ZdZdZdZdd� ZdS )� DefaultRolez&Set the default interpreted text role.r Fc C s� | j sdtjv r tjd= g S | j d }t�|| jj| j| jj�\}}|d u r>| jjj d| t
� | j | j �| jd�}||g S |tjd< |S )Nr* r r� r� )
rL r
�_rolesr� rE r� r2 r@ r� rl r rg rr )r6 � role_namer� r� rl r7 r7 r8 rs � s"
��
zDefaultRole.runN)r� r� r� r� r� r� rs r7 r7 r7 r8 r� � s
r� c @ r� )�Titler r Tc C s | j d | jjd< g S )Nr �title)rL rE rA r5 r7 r7 r8 rs � s z Title.runN)r� r� r� r� r� r� rs r7 r7 r7 r8 r� � s
r� c @ r� )�DateTc C s� t | jtj�s| �d| j ��d�| j�pd}tj dk r4z |�
t p"d�}W n t y3 | �
dt ��w t�|�}tj dk r`z |�t pDd�}W n ty_ |�t pSdd�}| �
d|t f ��w t�|�gS ) Nr� r/ z%Y-%m-%dr� zutf-8z;Cannot encode date format string with locale encoding "%s".�replacez-Error decoding "%s"with locale encoding "%s".)r� r@ r r� rl r rO r� rx r� �encoder r\ rD �time�strftime�decode�UnicodeDecodeErrorr rn )r6 �
format_strr� r7 r7 r8 rs s4 ��
��
�� zDate.runNr� r7 r7 r7 r8 r� � r� r� c @ s. e Zd ZdZdZdZdejiZdZ dd� Z
dS )�
TestDirectivez3This directive is useful only for testing purposes.r T�optionc C sp | j r#d�| j �}| jjjd| j| j| jf t� ||�| j
d�}|gS | jjjd| j| j| jf | j
d�}|gS )Nr/ zBDirective processed. Type="%s", arguments=%r, options=%r, content:r� zGDirective processed. Type="%s", arguments=%r, options=%r, content: None) r� rO rE r� �infor rL rT r rg r2 )r6 r� r r7 r7 r8 rs 3 s �� ���zTestDirective.runN) r� r� r� r� r� r� r r� r� r� rs r7 r7 r7 r8 r * s
r )'r� �
__docformat__rx �os.pathrH r� r� r� r r r r � docutils.utils.error_reportingr r r �docutils.parsers.rstr
r r r
r �$docutils.parsers.rst.directives.bodyr r �docutils.parsers.rst.rolesr �docutils.transformsr r r� r� r� r� r� r� r� r� r r7 r7 r7 r8 �<module> s4 6^ ,&= ,