|
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/domains/__pycache__/ |
Upload File : |
o
�$�a+( � @ s� d Z ddlZddlmZmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZ ddlmZ dd lmZ dd
lmZ dd lmZmZ dd l m Z dd
l m Z m Z ddl!m"Z" ddl#m$Z$ ddl%m&Z&m'Z' ddl(m)Z) e$�*e+�Z,e�-d�Z.G dd� dee/ �Z0de/dee/e/f fdd�Z1G dd� de0�Z2G dd � d e0�Z3G d d � d e0�Z4G d d � d e�Z5d!edee/ef fd"d#�Z6dS )$z�
sphinx.domains.rst
~~~~~~~~~~~~~~~~~~
The reStructuredText domain.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Any�Dict�Iterator�List�Optional�Tuple�cast)�Element)�
directives)�addnodes)�desc_signature� pending_xref)�Sphinx)�Builder)�ObjectDescription)�Domain�ObjType)�BuildEnvironment)�_�__)�XRefRole)�logging)�make_id� make_refnode)�
OptionSpecz\.\. (.+?)::(.*)$c @ sR e Zd ZdZdedededdfdd�Zd ededefd
d �Zdedefd d
�ZdS )�
ReSTMarkupz-
Description of generic reST markup.
�name�sig�signode�returnNc C s� t | j| jj| j|�}|d �|� | �|�}|| jjjvr+||d vr+|d �|� | jj�|� t t
| j� d��}|j | j|||d� | �
| j|�}|r]| jd �d||dd f� d S d S )N�ids�rst��location�entries�single� )r �env�state�document�objtype�append� make_old_idr �note_explicit_targetr �
ReSTDomain�
get_domain� note_object�get_index_text� indexnode)�selfr r r �node_id� old_node_id�domain� indextext� r8 �4/usr/lib/python3/dist-packages/sphinx/domains/rst.py�add_target_and_index( s
�z ReSTMarkup.add_target_and_index�
objectnamec C s dS )Nr& r8 �r3 r; r r8 r8 r9 r1 ; s zReSTMarkup.get_index_textc C s | j d | S )z�Generate old styled node_id for reST markups.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
�-)r* �r3 r r8 r8 r9 r, > s zReSTMarkup.make_old_id) �__name__�
__module__� __qualname__�__doc__�strr r: r1 r, r8 r8 r8 r9 r # s
r �dr c C sd | � � }|�d�s
|dfS t�|�}|s|dfS |�� \}}|� � r,|� � d|� � fS |� � dfS )z�Parse a directive signature.
Returns (directive, arguments) string tuple. If no arguments are given,
returns (directive, '').
�.r& � )�strip�
startswith�
dir_sig_re�match�groups)rD �dir�m�
parsed_dir� parsed_argsr8 r8 r9 �parse_directiveG s
rP c @ sP e Zd ZdZdededefdd�Zdededefd d
�Zdd d
�Zddd�Z d S )�
ReSTDirectivez*
Description of a reST directive.
r r r c C sD t |�\}}d| }|t�||�7 }t|�dkr |t�||�7 }|S )Nz.. %s::r )rP r � desc_name�len� desc_addname)r3 r r r �argsrR r8 r8 r9 �handle_signature_ s z ReSTDirective.handle_signaturer; r c C � t d�| S )N�%s (directive)�r r< r8 r8 r9 r1 g � z ReSTDirective.get_index_textNc C s. | j r| jj�dg �}|�| j d � d S d S )N�rst:directivesr )�namesr' � ref_context�
setdefaultr+ �r3 r
r8 r8 r9 �before_contentj s �z ReSTDirective.before_contentc C s$ | j j�dg �}|r|�� d S d S )Nr[ )r' r] r^ �popr_ r8 r8 r9 �
after_contento s �zReSTDirective.after_content)r N)
r? r@ rA rB rC r rV r1 r` rb r8 r8 r8 r9 rQ [ s
rQ c @ s� e Zd ZU dZej�� Zeed< e� de
j i� de de
de fdd�Zd e de de
dd
fd d �Zede fd
d��Zd e de fdd�Zd
S )�ReSTDirectiveOptionz6
Description of an option for reST directive.
� option_spec�typer r r c C s� z
t �d|�� d�\}}W n ty |d }}Y nw |t�d| d| �7 }|r6|t�d| d| �7 }| j�d�rKd| jd }|t�||�7 }|S )Nz\s*:\s+� �:%s:rF re z (%s)) �re�splitrG �
ValueErrorr rR �desc_annotation�options�get)r3 r r r �argument�textr8 r8 r9 rV ~ s � z$ReSTDirectiveOption.handle_signaturer Nc
C s> t t| j�d��}| j}|r d�| j|g�}d�||g�}n| j}|}t| j| jj ||�}|d �
|� | � |�} | | jj j vrM| |d vrM|d �
| � | jj �
|� |j| j|||d� |r�|d �� }
td�| td�| g} | jd �
d
d �| �|d |
f� d S |d �� }
td�| } | jd �
d
| |d |
f� d S )Nr! r= �:r r" r rX z:%s: (directive option)r$ �pairz; r& r% )r r. r' r/ �current_directive�joinr* r r( r) r+ r, r r- r0 �upperr r2 )
r3 r r r r6 �directive_name�prefix�objnamer4 r5 �keyrq ro r8 r8 r9 r: � s.
�$ z(ReSTDirectiveOption.add_target_and_indexc C s | j j�d�}|r
|d S dS )Nr[ ���r& )r' r] rm r_ r8 r8 r9 rr � s z%ReSTDirectiveOption.current_directivec C s d� | j| j|g�S )z�Generate old styled node_id for directive options.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
r= )rs r* rr r> r8 r8 r9 r, � s z ReSTDirectiveOption.make_old_id)r? r@ rA rB r rd �copyr �__annotations__�updater
� unchangedrC r rV r: �propertyrr r, r8 r8 r8 r9 rc u s
�!rc c @ s< e Zd ZdZdededefdd�Zdededefd d
�Zd S ) �ReSTRolez%
Description of a reST role.
r r r c C s |t �d| d| �7 }|S )Nrg )r rR )r3 r r r8 r8 r9 rV � s zReSTRole.handle_signaturer; r c C rW )Nz %s (role)rY r< r8 r8 r9 r1 � rZ zReSTRole.get_index_textN)r? r@ rA rB rC r rV r1 r8 r8 r8 r9 r � s r c @ s~ e Zd ZU dZdZdZeed�d�eed�d�eed�d�d�Ze e
e d�Z e
� e
� d �Zd
i iZeeeeeef ef f ed < ed eeeef eeef f fd
d��Zd*dedededed df
dd�Zded dfdd�Zdee ded dfdd �Zd ed ed e d ed!ed"e d#e d e e fd$d%�Z d ed ed e d!ed"e d#e d eeee f fd&d'�Z!d e"eeeeeee#f fd(d)�Z$dS )+r. zReStructuredText domain.r! �reStructuredText� directiverL zdirective-option�role)r� zdirective:optionr� )rL r� �objects� initial_datar c C s | j �di �S �Nr� )�datar^ )r3 r8 r8 r9 r� � s zReSTDomain.objectsNr* r r4 r# c C sV ||f| j v r | j ||f \}}tjtd�|||f |d� | jj|f| j ||f< d S )Nz4duplicate description of %s %s, other instance in %sr" )r� �logger�warningr r' �docname)r3 r* r r4 r# r� r8 r8 r9 r0 � s
��zReSTDomain.note_objectr� c C s8 t | j�� �D ]\\}}\}}||kr| j||f= qd S �N)�listr� �items)r3 r� �typr �docr4 r8 r8 r9 � clear_doc� s
��zReSTDomain.clear_doc�docnames� otherdatac C s< |d � � D ]\\}}\}}||v r||f| j||f< qd S r� )r� r� )r3 r� r� r� r r� r4 r8 r8 r9 �merge_domaindata� s
��zReSTDomain.merge_domaindatar' � fromdocname�builderr� �target�node�contnodec C sP | � |�}|D ] } | j�| |fd�\}
} |
r%t|||
| ||d | � S qd S )N�NNrF )�objtypes_for_roler� rm r ) r3 r' r� r� r� r� r� r� �objtypesr* � todocnamer4 r8 r8 r9 � resolve_xref� s
��zReSTDomain.resolve_xrefc C s\ g }| j D ]&}| j�||fd�\} }
| r+|�d| �|� t||| |
||d | �f� q|S )Nr� zrst:rF )� object_typesr� rm r+ �role_for_objtyper ) r3 r' r� r� r� r� r� �resultsr* r� r4 r8 r8 r9 �resolve_any_xref s
���zReSTDomain.resolve_any_xrefc c s8 � | j d �� D ]\\}}\}}|||||dfV qd S )Nr� rf )r� r� )r3 r� r r� r4 r8 r8 r9 � get_objects s � �zReSTDomain.get_objectsr� )%r? r@ rA rB r �labelr r r� rQ rc r r
r �rolesr� r rC r r{ r~ r� r r0 r� r r� r r r
r r r� r� r �intr� r8 r8 r8 r9 r. � sV
���$�( ����
� ���
�& r. �appc C s | � t� ddddd�S )N�builtin� T)�version� env_version�parallel_read_safe�parallel_write_safe)�
add_domainr. )r� r8 r8 r9 �setup s
�r� )7rB rh �typingr r r r r r r �docutils.nodesr �docutils.parsers.rstr
�sphinxr �sphinx.addnodesr r
�sphinx.applicationr �sphinx.buildersr �sphinx.directivesr �sphinx.domainsr r �sphinx.environmentr �
sphinx.localer r � sphinx.rolesr � sphinx.utilr �sphinx.util.nodesr r �sphinx.util.typingr � getLoggerr? r� �compilerI rC r rP rQ rc r r. r� r8 r8 r8 r9 �<module> s4
$
$I J