| 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/domains/__pycache__/ |
Upload File : |
a
�ab,( � @ 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/ �Z0e/ee/e/f d�dd�Z1G dd� de0�Z2G dd� de0�Z3G d d � d e0�Z4G d d � d e�Z5eee/ef d �d!d"�Z6dS )#z�
sphinx.domains.rst
~~~~~~~~~~~~~~~~~~
The reStructuredText domain.
:copyright: Copyright 2007-2022 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 @ sF e Zd ZdZeeedd�dd�Zeeed�dd�Zeed �d
d �ZdS ) �
ReSTMarkupz-
Description of generic reST markup.
N��name�sig�signode�returnc C s� t | j| jj| j|�}|d �|� | �|�}|| jjjvrV||d vrV|d �|� | jj�|� t t
| j� d��}|j | j|||d� | �
| j|�}|r�| jd �d||dd f� 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�domainZ indextext� r8 �6/usr/lib/python3.9/site-packages/sphinx/domains/rst.py�add_target_and_index( s
z ReSTMarkup.add_target_and_index��
objectnamer r c C s dS )Nr' r8 �r4 r< r r8 r8 r9 r2 ; s zReSTMarkup.get_index_text�r r c 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+ �r4 r r8 r8 r9 r- > s zReSTMarkup.make_old_id) �__name__�
__module__� __qualname__�__doc__�strr r: r2 r- r8 r8 r8 r9 r # s r )�dr c C sh | � � }|�d�s|dfS t�|�}|s0|dfS |�� \}}|� � rX|� � d|� � fS |� � dfS dS )z�Parse a directive signature.
Returns (directive, arguments) string tuple. If no arguments are given,
returns (directive, '').
�.r' � N)�strip�
startswith�
dir_sig_re�match�groups)rF �dir�mZ
parsed_dirZ parsed_argsr8 r8 r9 �parse_directiveG s
rP c @ sP e Zd ZdZeeed�dd�Zeeed�dd�Zdd �d
d �Zdd �d d
�Z dS )�
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�lenZ desc_addname)r4 r r r �argsrS r8 r8 r9 �handle_signature_ s z ReSTDirective.handle_signaturer; c C s t d�| S )N�%s (directive)�r r= r8 r8 r9 r2 g s z ReSTDirective.get_index_textN�r c C s* | j r&| jj�dg �}|�| j d � d S )N�rst:directivesr )�namesr( � ref_context�
setdefaultr, �r4 r
r8 r8 r9 �before_contentj s z ReSTDirective.before_contentc C s | j j�dg �}|r |�� d S )NrZ )r( r\ r] �popr^ r8 r8 r9 �
after_contento s zReSTDirective.after_content)
rA rB rC rD rE r rV r2 r_ ra r8 r8 r8 r9 rQ [ s
rQ c @ s| e Zd ZU dZej�� Zeed< e� de
j i� e e
e d�dd�Ze e e
dd�d d
�Zee d �d d
��Ze e d�dd�ZdS )�ReSTDirectiveOptionz6
Description of an option for reST directive.
� option_spec�typerR c C s� zt �d|�� d�\}}W n ty6 |d }}Y n0 |t�d| d| �7 }|rl|t�d| d| �7 }| j�d�r�d| jd }|t�||�7 }|S )Nz\s*:\s+� �:%s:rH rd z (%s)) �re�splitrI �
ValueErrorr rS Zdesc_annotation�options�get)r4 r r r �argument�textr8 r8 r9 rV ~ s z$ReSTDirectiveOption.handle_signatureNr c
C s> t t| j�d��}| j}|r<d�| j|g�}d�||g�}n
| j}|}t| j| jj ||�}|d �
|� | � |�} | | jj j vr�| |d vr�|d �
| � | jj �
|� |j| j|||d� |�r|d �� }
td�| td�| g} | jd �
d
d �| �|d |
f� n2|d �� }
td�| } | jd �
d
| |d |
f� d S )Nr" r? �:r! r# r rW z:%s: (directive option)r% �pairz; r' r& )r r/ r( r0 �current_directive�joinr+ r r) r* r, r- r! r. r1 �upperr r3 )
r4 r r r r7 Zdirective_name�prefixZobjnamer5 r6 �keyro rm r8 r8 r9 r: � s.
�" z(ReSTDirectiveOption.add_target_and_indexrY c C s" | j j�d�}|r|d S dS d S )NrZ ���r' )r( r\ rk r^ r8 r8 r9 rp � s z%ReSTDirectiveOption.current_directiver> c 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? )rq r+ rp r@ r8 r8 r9 r- � s z ReSTDirectiveOption.make_old_id)rA rB rC rD r rc �copyr �__annotations__�updater
Z unchangedrE r rV r: �propertyrp r- r8 r8 r8 r9 rb u s
�!rb c @ s4 e Zd ZdZeeed�dd�Zeeed�dd�ZdS ) �ReSTRolez%
Description of a reST role.
rR c C s |t �d| d| �7 }|S )Nrf )r rS )r4 r r r8 r8 r9 rV � s zReSTRole.handle_signaturer; c C s t d�| S )Nz %s (role)rX r= r8 r8 r9 r2 � s zReSTRole.get_index_textN)rA rB rC rD rE r rV r2 r8 r8 r8 r9 rz � s rz c
@ sV e Zd ZU dZdZdZeed�d�eed�d�eed�d�d�Ze e
e d�Z e
� e
� d �Zd
i iZeeeeeef ef f ed < eeeeef eeef f d �d
d��Zd!eeeedd�dd�Zedd�dd�Zee edd�dd�Zeee eee e e e d�dd�Z eee ee e eeee f d �d d �Z!e"eeeeeee#f d �d d �Z$dS )"r/ zReStructuredText domain.r" ZreStructuredText� directiverN zdirective-option�role)r{ zdirective:optionr| )rN r| �objects� initial_datarY c C s | j �di �S �Nr} )�datar] )r4 r8 r8 r9 r} � s zReSTDomain.objectsN)r+ r r5 r$ 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} �loggerZwarningr r( �docname)r4 r+ r r5 r$ r� r8 r8 r9 r1 � s
��zReSTDomain.note_object)r� r c C s8 t | j�� �D ]$\\}}\}}||kr| j||f= qd S )N)�listr} �items)r4 r� �typr �docZ_node_idr8 r8 r9 � clear_doc� s zReSTDomain.clear_doc)�docnames� otherdatar c C s< |d � � D ]*\\}}\}}||v r ||f| j||f< q d S r )r� r} )r4 r� r� r� r r� r5 r8 r8 r9 �merge_domaindata� s zReSTDomain.merge_domaindata)r( � fromdocname�builderr� �target�node�contnoder c C sP | � |�}|D ]<} | j�| |fd�\}
} |
rt|||
| ||d | � S qd S )N�NNrH )Zobjtypes_for_roler} rk r ) r4 r( r� r� r� r� r� r� Zobjtypesr+ � todocnamer5 r8 r8 r9 � resolve_xref� s
�
zReSTDomain.resolve_xref)r( r� r� r� r� r� r c C s\ g }| j D ]L}| j�||fd�\} }
| r
|�d| �|� t||| |
||d | �f� q
|S )Nr� zrst:rH )� object_typesr} rk r, Zrole_for_objtyper ) r4 r( r� r� r� r� r� �resultsr+ r� r5 r8 r8 r9 �resolve_any_xref s
��zReSTDomain.resolve_any_xrefc c s6 | j d �� D ]"\\}}\}}|||||dfV qd S )Nr} re )r� r� )r4 r� r r� r5 r8 r8 r9 � get_objects s zReSTDomain.get_objects)N)%rA rB rC rD r Zlabelr r r� rQ rb rz r
r Zrolesr~ r rE r rw ry r} r r1 r� r r� r r r
r r r� r� r �intr� r8 r8 r8 r9 r/ � s<
����$(� � r/ )�appr c C s | � t� ddddd�S )NZbuiltin� T)�versionZ env_versionZparallel_read_safeZparallel_write_safe)Z
add_domainr/ )r� r8 r8 r9 �setup s
�r� )7rD rg �typingr r r r r r r Zdocutils.nodesr Zdocutils.parsers.rstr
Zsphinxr Zsphinx.addnodesr r
Zsphinx.applicationr Zsphinx.buildersr Zsphinx.directivesr Zsphinx.domainsr r Zsphinx.environmentr Z
sphinx.localer r Z sphinx.rolesr Z sphinx.utilr Zsphinx.util.nodesr r Zsphinx.util.typingr Z getLoggerrA r� �compilerK rE r rP rQ rb rz r/ r� r8 r8 r8 r9 �<module> s2
$
$I J