|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/sphinx/__pycache__/ |
Upload File : |
o
�$�a6 � @ s� U d Z ddlZddlmZmZmZmZmZmZ ddl m
Z
m Z ddl m
Z
mZmZmZ ddlmZ ddlmZ ddlmZ dd lmZmZ dd
lmZ erYdd l m Z dd l m Z ej e
j!e
j"ej#ej ej$ej#ej#ej e
j"d
�
Z%G dd� de�Z&G dd� de&�Z'G dd� de�Z(G dd� de�Z)e�*d�Z+G dd� de�Z,G dd� de,�Z-e�*d�Z.e�*d �Z/G d d � d e�Z0e�*d ej1�Z2G d d!� d!e�Z3e&ej4d"�e'd#d$�e(� e)� e,� e-� e0� e0� e3� d%� Z5ee6ef e7d&< d'd(d)ee6ef fd*d+�Z8dS ),z�
sphinx.roles
~~~~~~~~~~~~
Handlers for additional ReST roles.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
TYPE_CHECKING�Any�Dict�List�Tuple�Type)�nodes�utils)�Element�Node� TextElement�system_message)�addnodes)�_)�ws_re)�
ReferenceRole�
SphinxRole)� RoleFunction)�Sphinx)�BuildEnvironment)
�command�dfn�kbd�
mailheader�makevar�manpage�mimetype� newsgroup�program�regexpc sB e Zd ZU dZejZee e d< e
j Z ee
e d< d!dededee dee
ded df � fd
d �
Zd ed
ed eeef fdd�Zd eee ee f fdd�Zd eee ee f fdd�Zd eee ee f fdd�Zdddeded ed
ed eeef f dd�Zd e
jddd ed ed eee ee f f
d d �Z� Z S )"�XRefRoleaA
A generic cross-referencing role. To create a callable that can be used as
a role function, create an instance of this class.
The general features of this role are:
* Automatic creation of a reference and a content node.
* Optional separation of title and target with `title <target>`.
* The implementation is a class rather than a function to make
customization easier.
Customization can be done in two ways:
* Supplying constructor parameters:
* `fix_parens` to normalize parentheses (strip from target, and add to
title if configured)
* `lowercase` to lowercase the target
* `nodeclass` and `innernodeclass` select the node classes for
the reference and the content node
* Subclassing and overwriting `process_link()` and/or `result_nodes()`.
� nodeclass�innernodeclassFN�
fix_parens� lowercase�
warn_dangling�returnc s< || _ || _|| _|d ur|| _|d ur|| _t� �� d S �N)r# r$ r% r! r" �super�__init__)�selfr# r$ r! r" r% �� __class__� �./usr/lib/python3/dist-packages/sphinx/roles.pyr) G s zXRefRole.__init__�title�targetc C sJ | j s|�d�r|d d� }| jjr|d7 }|�d�r!|d d� }||fS )Nz()���)�has_explicit_title�endswith�config�add_function_parentheses)r* r/ r0 r- r- r. �update_title_and_targetT s
z XRefRole.update_title_and_targetc C sn d| j vrd| j | _| _d| jg| _n| j �dd�\| _| _d| jd| j| jf g| _| jr3| �� S | �� S )N�:� �xref� z%s-%s)�name� refdomain�reftype�classes�split�disabled�create_non_xref_node�create_xref_node�r* r- r- r. �runa s
z XRefRole.runc C s\ t �| jdd � �}| jrd| _| �|d�\}}| j| j|| jd�}| j | j
j | j |dd�S )Nr: Fr8 �r> ��is_ref)
r �unescape�textr# r2 r6 r" �rawtextr> � result_nodes�inliner�document�env)r* rI r0 �noder- r- r. rA n s z XRefRole.create_non_xref_nodec C s� | j }| j}| jr
|�� }| jr| �||�\}}| jj| j| j | j
| j d�}| j | j
fi |��}| �|� | �| j|| j
||�\}}||d< || j| j
|| jd�7 }| j| jj| j|dd�S )N)�refdocr< r= � refexplicit�refwarn� reftargetrE TrF )r0 r/ r$ �lowerr# r6 rN �docnamer< r= r2 r% r! rJ �set_source_info� process_linkr" r> rK rL rM )r* r0 r/ �options�refnoder- r- r. rB w s( �
�zXRefRole.create_xref_noderN r rY r2 c C s |t �d|�fS )z�Called after parsing title and target text, and creating the
reference node (given in *refnode*). This method can alter the
reference node and must return a new (or the same) ``(title, target)``
tuple.
� )r �sub)r* rN rY r2 r/ r0 r- r- r. rW � s zXRefRole.process_linkrM rO rG c C s
|gg fS )a( Called before returning the finished nodes. *node* is the reference
node if one was created (*is_ref* is then true), else the content node.
This method can add other nodes and must return a ``(nodes, messages)``
tuple (the usual return value of a role function).
r- )r* rM rN rO rG r- r- r. rK � s
zXRefRole.result_nodes)FFNNF) �__name__�
__module__� __qualname__�__doc__r � pending_xrefr! r r
�__annotations__r �literalr" r �boolr) �strr r6 r r r
rD rA rB rW rM rK �
__classcell__r- r- r+ r. r , s@
�����
��
� ��r c s> e Zd Zdddededededeeef f � fdd � Z� ZS )
� AnyXRefRolerN r rY r2 r/ r0 r& c s& t � �|||||�}|j�|j� |S r' )r( rW �
attributes�update� ref_context)r* rN rY r2 r/ r0 �resultr+ r- r. rW � s zAnyXRefRole.process_link) r\ r] r^ r
rc rd r rW re r- r- r+ r. rf � s ��
�rf c @ �8 e Zd Zdeee ee f fdd�Zdefdd�Z dS )�PEPr& c
C s
d| j �d� }dtd�| j |dd fg}tj|d�}tjdd|gd�}| jj� |� z,| �
� }tj ddd|d gd
�}| j rI|t�
| j| j�7 }n
d | j }|t�
||�7 }W n& ty} | jjjd | j | jd
�}| j�| j| j|�} | g|gf Y S w |||gg fS )N�index-%s�index�singlez$Python Enhancement Proposals; PEP %sr8 ��entries��idsF�pep��internal�refurir> zPEP zinvalid PEP number %s��line)rN � new_serialnor r0 r rn r rL rM �note_explicit_target� build_uri� referencer2 �strongr/ �
ValueError�reporter�error�lineno� problematicrJ �
r* � target_idrq rn r0 rw r} r/ �msg�prbr- r- r. rD � s. �
� ��zPEP.runc C sV | j jjj}| j�dd�}t|�dkr!|dt|d �|d f S |dt|d � S )N�#r: � z pep-%04d#%sr zpep-%04d)rL rM �settings� pep_base_urlr0 r? �len�int�r* �base_url�retr- r- r. r| � s
z
PEP.build_uriN�
r\ r] r^ r r r r
rD rd r| r- r- r- r. rl � s rl c @ rk )�RFCr& c
C s d| j �d� }dd| j |dd fg}tj|d�}tjdd|gd�}| jj�|� z,| � � }tj
ddd|d gd
�}| j rG|t� | j
| j
�7 }n
d | j
}|t� ||�7 }W n& ty{ | jjjd | j | jd
�}| j�| j| j|�} | g|gf Y S w |||gg fS )Nrm rn ro z RFC; RFC %sr8 rp rr F�rfcru zRFC zinvalid RFC number %srx )rN rz r0 r rn r rL rM r{ r| r} r2 r~ r/ r r� r� r� r� rJ r� r- r- r. rD � s*
� ��zRFC.runc C sb | j jjj}| j�dd�}t|�dkr%|| j jt|d � d |d S || j jt|d � S )Nr� r: r� r ) rL rM r� � rfc_base_urlr0 r? r� �rfc_urlr� r� r- r- r. r| � s
$z
RFC.build_uriNr� r- r- r- r. r� � s r� �(?<!&)&(?![&\s])c @ s4 e Zd Ze�d�Zdeee ee f fdd�Z
dS )�GUILabelr� r& c C s� t j| j| jgd�}| j�| j�}|t �|�d��7 }|D ](}|� dd�}t �|d �}t jdd|dgd�}||7 }|t �|dd � �7 }q |gg fS ) N)rJ r> r z&&�&r8 � acceleratorrE r: )
r �inlinerJ r; �amp_rer? rI �Text�pop�replace)r* rO �spans�span�letterr� r- r- r. rD � s
z GUILabel.runN) r\ r] r^ �re�compiler� r r r r
rD r- r- r- r. r� � s
"r� c s6 e Zd ZdZdeee ee f f� fdd� Z� Z S )�
MenuSelectionu ‣r& c s | j �d| j�| _ t� �� S )Nz-->)rI r� �BULLET_CHARACTERr( rD rC r+ r- r. rD s
zMenuSelection.run)
r\ r] r^ r� r r r r
rD re r- r- r+ r. r� s *r� z {([^}]+)}z (\\*{|\\*})c @ sJ e Zd Ze�d�Zdeee ee f fdd�Z
de dee fdd�Z dS ) �EmphasizedLiteralz(\\\\|\\{|\\}|{|})r& c C s> | � | j�}tj| jdg|�R | j�� | jgd��}|gg fS )Nr8 )�roler> )�parserI r rb rJ r; rT )r* �childrenrO r- r- r. rD s
�
zEmphasizedLiteral.runrI c C sx g }dg}| j �|�D ]�}|dkr|d d7 < q |dkr>t|�dkr3|d dkr3|d d7 < q |�d� |�d� q |dkr�t|�d krx|d
dkrxt|d �d krx|d rg|�t�|d |d �� |�t�|d |d �� dg}q |�d� d�|�g}q |d kr�|d d7 < q |d
kr�|d d7 < q |d |7 < q d�|�r�d�|�}|�t�||�� |S )Nr8 z\\����\�{r� r1 �}� r: r z\{z\})� parens_rer? r� �appendr r� �emphasis�join)r* rI rj �stack�partr- r- r. r� s6
(
zEmphasizedLiteral.parseN)
r\ r] r^ r� r� r� r r r r
rD rd r� r- r- r- r. r� s
r� � \((.*)\)$c @ s8 e Zd Ze�dej�Zdeee ee
f fdd�Z dS )� Abbreviationr� r& c C sd | j �� }| j�| j�}|r!| jd |�� � �� }|�d�|d< n| j}tj | j
|fi |��gg fS )Nr: � explanation) rX �copy�abbr_re�searchrI �start�strip�groupr � abbreviationrJ )r* rX �matchedrI r- r- r. rD L s
zAbbreviation.runN) r\ r] r^ r� r� �Sr� r r r r
rD r- r- r- r. r� I s "r� )r! T)r% ) �download�anyrt r� �guilabel�
menuselection�file�samp�abbr�specific_docroles�appr r& c C st ddl m} t�� D ]\}}|�||�}|�||d|gi�}|�||� q
t�� D ]
\}}|�||� q)dddd�S )Nr )�rolesr> �builtinT)�version�parallel_read_safe�parallel_write_safe)�docutils.parsers.rstr� �generic_docroles�items� GenericRole�
CustomRole�register_local_roler� )r� r� �rolenamer! �genericr� �funcr- r- r. �setuph s �r� )9r_ r� �typingr r r r r r �docutilsr r �docutils.nodesr
r r r
�sphinxr �
sphinx.localer � sphinx.utilr �sphinx.util.docutilsr r �sphinx.util.typingr �sphinx.applicationr �sphinx.environmentr �literal_strongr� rb �literal_emphasisr r� r rf rl r� r� �_amp_rer� r� �
_litvar_rer� r� r� �_abbr_rer� �download_referencer� rd ra r� r- r- r- r. �<module> s^
�y #
"
2
�