| 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/__pycache__/ |
Upload File : |
a
�ab"6 � @ s� U d Z ddlZddlmZmZmZmZmZmZ ddl m
Z
m Z ddl m
Z
mZmZmZ ddlmZ ddlmZmZ ddlmZ dd lmZmZ dd
lm Z er�dd 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 �Z0G d d � d e�Z1e�+d ej2�Z3G d d!� d!e�Z4e'ej5d"�e(d#d$�e)� e*� e-� e.� e1� e1� e4� d%� Z6ee7e f e8d&< d'ee7ef d(�d)d*�Z9dS )+z�
sphinx.roles
~~~~~~~~~~~~
Handlers for additional ReST roles.
:copyright: Copyright 2007-2022 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)
ZcommandZdfnZkbdZ
mailheaderZmakevar�manpageZmimetypeZ newsgroupZprogramZregexpc s e Zd ZU dZejZee e d< e
j Z ee
e d< deeee ee
edd�� fdd�
Zeeeeef d �d
d �Zeee ee f d �d
d�Zeee ee f d �dd�Zeee ee f d �dd�Zdeeeeeeef d�dd�Ze
jdeeeee ee f d�dd�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� lowercaser r �
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__� �0/usr/lib/python3.9/site-packages/sphinx/roles.pyr! G s zXRefRole.__init__)�title�targetr c C sJ | j s,|�d�r |d d� }| jjr,|d7 }|�d�rB|d d� }||fS )Nz()���)�has_explicit_title�endswithZconfigZadd_function_parentheses)r" r' r( r% r% r& �update_title_and_targetT s
z XRefRole.update_title_and_target�r c C sr d| j vr(d| j | _| _d| jg| _n0| j �dd�\| _| _d| jd| j| jf g| _| jrf| �� S | �� S d S )N�:� Zxref� z%s-%s)�name� refdomain�reftype�classes�splitZdisabled�create_non_xref_node�create_xref_node�r" r% r% r& �runa s
z XRefRole.runc C s\ t �| jdd � �}| jr0d| _| �|d�\}}| j| j|| jd�}| j | j
j | j |dd�S )Nr0 Fr/ �r4 ��is_ref)
r Zunescape�textr r* r, r �rawtextr4 � result_nodes�inliner�document�env)r" r= r( �noder% r% r& r6 n s z XRefRole.create_non_xref_nodec C s� | j }| j}| jr|�� }| jr0| �||�\}}| jj| j| j | j
| j d�}| j | j
fi |��}| �|� | �| j|| j
||�\}}||d< || j| j
|| jd�7 }| j| jj| j|dd�S )N)Zrefdocr2 r3 Z refexplicitZrefwarnZ reftargetr: Tr; )r( r' r �lowerr r, rB Zdocnamer2 r3 r* r r r> Zset_source_info� process_linkr r4 r? r@ rA )r" r( r' �options�refnoder% r% r& r7 w s( �
�zXRefRole.create_xref_noder �rB rG r* r' r( r 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" rB rG r* r' r( r% r% r& rE � s zXRefRole.process_link)rA rB rC r< r 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" rA rB rC r< r% r% r& r? � s zXRefRole.result_nodes)FFNNF) �__name__�
__module__� __qualname__�__doc__r Z pending_xrefr r r
�__annotations__r �literalr r �boolr! �strr r, r r r
r9 r6 r7 rE rA r? �
__classcell__r% r% r# r& r , s(
� �
� �r c s4 e Zd Zdeeeeeeef d�� fdd� Z� ZS )� AnyXRefRoler rH c s& t � �|||||�}|j�|j� |S r )r rE Z
attributes�updateZ ref_context)r" rB rG r* r' r( �resultr# r% r& rE � s zAnyXRefRole.process_link) rK rL rM r
rQ rR r rE rS r% r% r# r& rT � s �rT c @ s8 e Zd Zeee ee f d�dd�Zed�dd�Z dS )�PEPr- c
C s d| j �d� }dtd�| j |dd fg}tj|d�}tjdd|gd�}| jj� |� zX| �
� }tj ddd|d gd
�}| j r�|t�
| j| j�7 }nd | j }|t�
||�7 }W nR t�y | jjjtd �| j | jd
�}| j�| j| j|�} | g|gf Y S 0 |||gg fS )N�index-%s�index�singlez$Python Enhancement Proposals; PEP %sr/ ��entries�ZidsF�pep�Zinternal�refurir4 zPEP zinvalid PEP number %s��line)rB � new_serialnor r( r rY r r@ rA �note_explicit_target� build_uri� referencer* �strongr' �
ValueError�reporter�errorr �lineno� problematicr> �
r" Z target_idr\ rY r( r` rf r' �msgZprbr% r% r& r9 � s* �
�zPEP.runc C sZ | j jjj}| j�dd�}t|�dkrB|dt|d �|d f S |dt|d � S d S )N�#r0 � z pep-%04d#%sr zpep-%04d)r@ rA �settingsZ pep_base_urlr( r5 �len�int�r" Zbase_url�retr% r% r& re � s
z
PEP.build_uriN�
rK rL rM r r r r
r9 rR re r% r% r% r& rW � s rW c @ s8 e Zd Zeee ee f d�dd�Zed�dd�Z dS )�RFCr- c
C s
d| j �d� }dd| j |dd fg}tj|d�}tjdd|gd�}| jj�|� zX| � � }tj
ddd|d gd
�}| j r�|t� | j
| j
�7 }nd | j
}|t� ||�7 }W nP ty� | jjjtd �| j | jd
�}| j�| j| j|�} | g|gf Y S 0 |||gg fS )NrX rY rZ z RFC; RFC %sr/ r[ r] F�rfcr_ zRFC zinvalid RFC number %sra )rB rc r( r rY r r@ rA rd re rf r* rg r' rh ri rj r rk rl r> rm r% r% r& r9 � s&
�zRFC.runc C sf | j jjj}| j�dd�}t|�dkrJ|| j jt|d � d |d S || j jt|d � S d S )Nro r0 rp r ) r@ rA rq Z rfc_base_urlr( r5 rr Zrfc_urlrs rt r% r% r& re � s
$z
RFC.build_uriNrv r% r% r% r& rw � s rw �(?<!&)&(?![&\s])c @ s4 e Zd Ze�d�Zeee ee f d�dd�Z
dS )�GUILabelry r- c C s� t j| j| jgd�}| j�| j�}|t �|�d��7 }|D ]P}|� dd�}t �|d �}t jdd|dgd�}||7 }|t �|dd � �7 }q:|gg fS ) N)r> r4 r z&&�&r/ � acceleratorr: r0 )
r Zinliner> r1 �amp_rer5 r= �Text�pop�replace)r" rC Zspans�spanZletterr| r% r% r& r9 � s z GUILabel.runN) rK rL rM �re�compiler} r r r r
r9 r% r% r% r& rz � s
rz c s6 e Zd ZdZeee ee f d�� fdd� Z� Z S )�
MenuSelectionu ‣r- c s | j �d| j�| _ t� �� S )Nz-->)r= r� �BULLET_CHARACTERr r9 r8 r# r% r& r9 s zMenuSelection.run)
rK rL rM r� r r r r
r9 rS r% r% r# r& r� s r� z {([^}]+)}z (\\*{|\\*})c @ sH e Zd Ze�d�Zeee ee f d�dd�Z
e ee d�dd�Z dS ) �EmphasizedLiteralz(\\\\|\\{|\\}|{|})r- c C s> | � | j�}tj| jdg|�R | j�� | jgd��}|gg fS )Nr/ )�roler4 )�parser= r rP r> r1 rD )r" ZchildrenrC r% r% r& r9 s
�zEmphasizedLiteral.run)r= r c C s� g }dg}| j �|�D �]<}|dkr6|d d7 < q|dkr~t|�dkrh|d dkrh|d d7 < n|�d� |�d� q|dk�r t|�d kr�|d
dkr�t|d �d kr�|d r�|�t�|d |d �� |�t�|d |d �� dg}n|�d� d�|�g}q|d k�r(|d d7 < q|d
k�rD|d d7 < q|d |7 < qd�|��r~d�|�}|�t�||�� |S )Nr/ z\\����\�{rp r) �}� r0 r z\{z\})� parens_rer5 rr �appendr r~ �emphasis�join)r" r= rV �stack�partr% r% r& r� s6
(
zEmphasizedLiteral.parseN)
rK rL rM r� r� r� r r r r
r9 rR r� r% r% r% r& r� s
r� � \((.*)\)$c @ s8 e Zd Ze�dej�Zeee ee
f d�dd�Z dS )� Abbreviationr� r- c C sd | j �� }| j�| j�}|rB| jd |�� � �� }|�d�|d< n| j}tj | j
|fi |��gg fS )Nr0 Z explanation) rF �copy�abbr_re�searchr= �start�strip�groupr Z abbreviationr> )r" rF Zmatchedr= r% r% r& r9 L s
zAbbreviation.runN) rK rL rM r� r� �Sr� r r r r
r9 r% r% r% r& r� I s r� )r T)r ) Zdownload�anyr^ rx ZguilabelZ
menuselection�fileZsampZabbr�specific_docrolesr )�appr c C st ddl m} t�� D ]4\}}|�||�}|�||d|gi�}|�||� qt�� D ]\}}|�||� qRdddd�S )Nr )�rolesr4 ZbuiltinT)�versionZparallel_read_safeZparallel_write_safe)Zdocutils.parsers.rstr� �generic_docroles�itemsZ GenericRoleZ
CustomRoleZregister_local_roler� )r� r� Zrolenamer Zgenericr� �funcr% r% r& �setuph s �r� ):rN r� �typingr r r r r r Zdocutilsr r Zdocutils.nodesr
r r r
Zsphinxr Z
sphinx.localer r Z sphinx.utilr Zsphinx.util.docutilsr r Zsphinx.util.typingr Zsphinx.applicationr Zsphinx.environmentr Zliteral_strongr� rP Zliteral_emphasisr r� r rT rW rw r� Z_amp_rerz r� Z
_litvar_rer� r� r� Z_abbr_rer� Zdownload_referencer� rR rO r� r% r% r% r& �<module> s\
�y #"
2
�