| 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/util/__pycache__/ |
Upload File : |
a
�ab�[ � " @ s( d Z ddlZddlZddlmZmZmZmZmZm Z m
Z
m Z m Z m
Z
mZ ddlmZ ddlmZmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
l m Z dd l m Z er�dd l m!Z! dd
l"m#Z# ddl$m%Z% ddl&m'Z' e �(e)�Z*e�+dej,�Z-e-Z.G dd� d�Z/ee0d�dd�Z1d|ee2e0d�dd�Z3edd�dd�Z4ej5ej6ej7ej8fZ9ee:d�d d �Z;ee:d�d d �Z<ej6ej7ej=ej>fZ?ej@fZAejBfZCeee ee0f d �d!d"�ZDee e0 d�d#d$�ZEee e2 d�d%d&�ZFd}eeee d'�d(d)�ZGee e d�d*d+�ZHeee eed, f d �d-d.�ZIeeee0d/�d0d1�ZJee0d�d2d3�ZKe0e e:e0e0f d4�d5d6�ZLg d7�ZMe0e0ee e0e0e0e0e e0 f d8�d9d:�ZNd;e
e0 e0ejOeee0 ejOd<�d=d>�ZPe0e0d?�d@dA�ZQe�+dB�ZRe�+dC�ZSdDdEdFdGdHdIdJdJdKdEdLdMdHdNdOdIdIdPdQdRdQdHdNdIdSdKdTdQdUdSdVdWdPdX�!ZTdYdZd[d\d]d^�ZUd~d`ejOe0e0e0da�dbdc�ZVejWe0e e dd�dedf�ZXdd;e0e0e0e
eee f e0ejYdg�dhdi�ZZeeddj�dkdl�Z[ee2eddm�dndo�Z\eeddp�dqdr�Z]ej^ej_ej`ej@ej>ejaejbfZcee:d�dsdt�Zdeduddv�dwdx�Zeeedy�dzd{�Zfefej_gdS )�z�
sphinx.util.nodes
~~~~~~~~~~~~~~~~~
Docutils node-related utility functions for Sphinx.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N) �
TYPE_CHECKING�Any�Callable�Iterable�List�Optional�Set�Tuple�Type�Union�cast)�nodes)�Element�Node)� Directive)�Inliner)�
StringList)�addnodes)�__)�logging)�Builder)�
IndexEntry)�BuildEnvironment)�Tagsz ^(.+?)\s*(?<!\x00)<([^<]*?)>$c @ sF e Zd ZdZee edd�dd�Zeed�dd�Z eed�d d
�Z
dS ) � NodeMatchera" A helper class for Node.findall().
It checks that the given node is an instance of the specified node-classes and
has the specified node-attributes.
For example, following example searches ``reference`` node having ``refdomain``
and ``reftype`` attributes::
matcher = NodeMatcher(nodes.reference, refdomain='std', reftype='citation')
doctree.findall(matcher)
# => [<reference ...>, <reference ...>, ...]
A special value ``typing.Any`` matches any kind of node-attributes. For example,
following example searches ``reference`` node having ``refdomain`` attributes::
from typing import Any
matcher = NodeMatcher(nodes.reference, refdomain=Any)
doctree.findall(matcher)
# => [<reference ...>, <reference ...>, ...]
N)� node_classes�attrs�returnc O s || _ || _d S �N)�classesr )�selfr r � r! �5/usr/lib/python3.9/site-packages/sphinx/util/nodes.py�__init__> s zNodeMatcher.__init__��noder c C s� z|| j rt|| j �sW dS | jrxt|tj�s2W dS | j�� D ]:\}}||vrT W dS |tu r`q<q<|�|�|kr< W dS q<W dS ty� Y dS 0 d S )NFT) r �
isinstancer r
r �itemsr �get� Exception)r r% �key�valuer! r! r" �matchB s
zNodeMatcher.matchc C s
| � |�S r )r, )r r% r! r! r" �__call__X s zNodeMatcher.__call__) �__name__�
__module__� __qualname__�__doc__r
r r r# �boolr, r- r! r! r! r" r ( s r r$ c C s d� | j| jj�S )z�
Return full module dotted path like: 'docutils.nodes.paragraph'
:param nodes.Node node: target node
:return: full module dotted path
z{}.{})�formatr/ � __class__r. �r% r! r! r" �get_full_module_name\ s r6 �P )r% �lengthr c C sP z| � � �� }W n ty* t| �}Y n0 |rLt|�|krL|d|� d }|S )a�
return DOM XML representation of the specified node like:
'<paragraph translatable="False"><inline classes="versionmodified">New in version...'
:param nodes.Node node: target node
:param int length:
length of return value to be striped. if false-value is specified, repr_domxml
returns full of DOM XML representation.
:return: DOM XML representation
Nz...)ZasdomZtoxmlr) �str�len)r% r8 �textr! r! r" � repr_domxmlf s r< c C s0 t | tj�rN| jsNt�dt| �t| �� | j}|j | _ |j
d | _
| � � | _n t | tj�rj| j sj| jj | _ t | tj �r�| j d u r�t�dt| �t| �� | jj | jj
| _ | _
t | tj
�r�| j d u r�t�dt| �t| �� | jj | jj
| _ | _
t | tj��rPt�dt| �t| �� tt| j�tj���D ]&}t�dt�|� � � d| j�| _�q(t | tj��r�| j d u �r�t�dt| �t| �� | jj | jj
| _ | _
t | tj��r�| j d u �r�t| �| _ | j�s�| � � | _| j �r�| j�r�d S t | tjtj
tj tjf��r,t�dt| �t| �� t| ��p d| _ d | _
d S d S )
Nz7[i18n] PATCH: %r to have source, line and rawsource: %s� z)[i18n] PATCH: %r to have source, line: %sz#[i18n] PATCH: %r to have source: %sz&[i18n] PATCH: %r to have rawsource: %sz \s*:\s*%s� z,[i18n] PATCH: %r to have source and line: %sr )r& r
�
classifier� rawsource�logger�debugr6 r< �parent�source�line�astext�image�title�term�reversed�list�findall�re�sub�escapeZtopic�
literal_block�get_node_sourceZrubric�
field_name)r% Zdefinition_list_itemr? r! r! r" �apply_source_workaroundz sf �
� � ��
�
� �rS c C s4 t | tj�r,t | j�dd g�d tj�r,dS dS d S )Nr
r TF)r& r
�pending�detailsr( r �metar5 r! r! r" �is_pending_meta� s
�rW c C s: t | tj�rdS t | tj�r4| �d�s0| �d�r4dS t | tj�rLd| vrLdS t | tj��r| jszt �
dt | �t | �� dS t | t
�r�d| vr�t �
dt | �t | �� dS | �dd�s�t �
dt | �t | �� dS t | tj��r| jd d k�rt �
d
t | �t | �� dS dS t| ��s t | tj��r$dS t | tj��r6dS dS ) NT� translatable�altFz)[i18n] SKIP %r because no node.source: %szO[i18n] SKIP %r because node is in IGNORED_NODES and no node['translatable']: %sz3[i18n] SKIP %r because not node['translatable']: %sr Zorphanz&[i18n] SKIP %r because orphan node: %s)r& r rX r
rG r( ZInlineZ TextElementrD rA rB r6 r< �
IGNORED_NODESrR �childrenrW rV �
docutils_metar5 r! r! r" �is_translatable� sB � � � �r] )�doctreer c c s | � t�D ]�}t|tj�r4|�� D ]}||fV q"q
t|t�rR|j}|s�|�� }n�t|t j
�r�|� d�rv||d fV |� d�r�d|d }q�d}n`t|t �r�|j
}nNt|t j�r�t|�r�|jd d j
}n(t|tj�r�|d }n|j�d d
��� }|r
||fV q
d S ) z3Extract translatable messages from a document tree.rY rX z
.. image:: %sZurir> r
r �content�
� N)rL r] r& r rX Zextract_original_messages�LITERAL_TYPE_NODESr@ rF r
rG r( �META_TYPE_NODESZ
rawcontentrT rW rU r\ �replace�strip)r^ r% �msgr! r! r" �extract_messages s0
rg c C s" t | �D ]}|jr|j S qd S r )�traverse_parentrD �r% Zpnoder! r! r" rQ ' s rQ c C s" t | �D ]}|jr|j S qd S r )rh rE ri r! r! r" �
get_node_line. s rj )r% �clsr c c s( | r$|d u st | |�r | V | j} q d S r )r& rC )r% rk r! r! r" rh 5 s rh c C s* | j �| �}|dkr"| j |d S d S d S )Nr r= )rC �index)r% �posr! r! r" �
get_prev_node< s rn r c c sF t tjdd�}| �|�D ](}d|v r.|d }n|d }||fV qdS )z6Traverse translatable index node from a document tree.F)ZinlineZ raw_entries�entriesN)r r rl rL )r^ Zmatcherr% ro r! r! r" �traverse_translatable_indexD s
rp )�stater_ r% r c C s\ | j j}| j j}g | j _d| j _z$| j|d|dd�W || j _|| j _S || j _|| j _0 dS )z�Version of state.nested_parse() that allows titles and does not require
titles to have the same decoration as the calling document.
This is useful when the parsed content comes from a completely different
context, such as docstrings.
r r= )Z match_titlesN)�memoZ title_stylesZ
section_levelZ nested_parse)rq r_ r% Zsurrounding_title_stylesZsurrounding_section_levelr! r! r" �nested_parse_with_titlesO s � �rs c C sL | � � } | �tj�D ] }d|d< qt| �tj��D ]}|j�|� q2| �� S )z&Like node.astext(), but ignore images.r> rY ) �deepcopyrL r
rG rK �rawrC �removerF )r% Zimgru r! r! r" � clean_astextb s
rw )r; r c C s. t �| �}|r$d|�d�|�d�fS d| | fS )z3Split role content into title and target, if given.Tr= � F)�explicit_title_rer, �group)r; r, r! r! r" �split_explicit_titlel s
r{ )�single�pair�doubleZtripleZseeZseealso)�entry�targetidr c C sJ ddl m} g }| �� } | }d}| �d�r>d}| dd � �� } |D ]T}| �|d �rB| t|�d d � �� }|| d | }|�d |||d f� �qFqBtD ]P}| �|d �r�| t|�d d � �� }|d
kr�d }|�||||d f� �qFq�|�d �D ]L}|�� }d}|�d��r(d}|dd � �� }|�s0q�|�d |||d f� q�|S )
Nr )�pairindextypesr> �!�mainr= �:z; r} r~ �,r| ) Zsphinx.domains.pythonr� re �
startswith�lstripr: �append�
indextypes�split)r r� r� Z indexentriesZoentryr� �typer+ r! r! r" �process_index_entryy s>
r� r )�builder�
docnameset�docname�tree� colorfunc� traversedr c
C s t tj|�� �}t|�tj��D ]�}g }tt |d �}|D ]�} | |vr:zH|�
| � t j || �d dd� t
| || | j�| �||�}
|�| � W n& ty� t jtd�| |d� Y q:0 tj| d�} |
j| _| �tj�D ]} d| vr�| | d< q�|�
| � q:|j�||� q |S ) zwInline all toctrees in the *tree*.
Record all docnames in *docnameset*, and output docnames with *colorfunc*.
� includefilesra T)Znonlz+toctree contains ref to nonexisting file %r��location)r� r� )r r
�documentrt rK rL r Ztoctree�mapr9 r� rA �info�inline_all_toctrees�envZ get_doctree�addr) �warningr Z
start_of_filer[ �sectionrC rd )
r� r� r� r� r� r� Z toctreenodeZnewnodesr� Z includefileZsubtreeZsofZ sectionnoder! r! r" r� � s4
�
�
r� )�stringr c C sX | � t�}|� t�}t�d|��dd��d�}t�dd� |�
� ��}t �d|�}t |�S )a� Convert `string` into an identifier and return it.
This function is a modified version of ``docutils.nodes.make_id()`` of
docutils-0.16.
Changes:
* Allow to use capital alphabet characters
* Allow to use dots (".") and underscores ("_") for an identifier
without a leading character.
# Author: David Goodger <goodger@python.org>
# Maintainer: docutils-develop@lists.sourceforge.net
# Copyright: This module has been placed in the public domain.
ZNFKD�ascii�ignore�-ra r> )
� translate�_non_id_translate_digraphs�_non_id_translate� unicodedata� normalize�encode�decode�
_non_id_charsrN �joinr� �_non_id_at_endsr9 )r� �idr! r! r" �_make_id� s
r� z[^a-zA-Z0-9._]+z^[-0-9._]+|-+$�o�d�h�i�l�t�b�c�f�k�n�p�y�z�g�j�s�e�q�r)!� i i' i1 iB ig i� i� i� i� i� i� i� i� i� i� i� i� i� i� i% i4 i5 i6 i7 i< i? i@ iG iI iK iM iO ZszZaeZoeZdbZqp)�� �� iS i8 i9 r> r )r� r� �prefixrI r c C s� d}|r|d }n|j jp dd }|rD|rDt|| �}||kr\d}n|r\t|�}|dkr\d}|du sn||jv r~|| �|� }q\|S )z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%sr� z%sr> )ZsettingsZ id_prefixr� ZidsZ new_serialno)r� r� r� rI Znode_idZidformatr! r! r" �make_id s
r� )r% � conditionr c C s0 | D ]&}t |tj�r|�d�|kr| S qdS )zBPick matched pending_xref_condition node up from the pending_xref.r� N)r& r Zpending_xref_conditionr( )r% r� Zsubnoder! r! r" �find_pending_xref_condition% s �
r� )r� � fromdocname� todocnamer� �childrH r c C sl t jdddd�}||kr&|r&||d< n.|rD| �||�d | |d< n| �||�|d< |r`||d< ||7 }|S )z$Shortcut to create a reference node.r> T)ZinternalZrefid�#ZrefuriZreftitle)r
� referenceZget_relative_uri)r� r� r� r� r� rH r% r! r! r" � make_refnode0 s
��
r� )� directiver% r c C s | j �| j�\|_|_d S r )Z
state_machine�get_source_and_line�linenorD rE )r� r% r! r! r" �set_source_infoB s �r� )�inlinerr� r% r c C s | j �|�\|_|_d S r )Zreporterr� rD rE )r� r� r% r! r! r" �set_role_source_infoG s r� )�src�dstr c C s t | �|_t| �|_d S r )rQ rD rj rE )r� r� r! r! r" �copy_source_infoK s
r� c C sN t | j�D ]*}t|t�r dS |�dd�du r
dS q
t| dd�du rJdS dS )z0Check whether the node is smart-quotable or not.FZsupport_smartquotesNT)rh rC r& � NON_SMARTQUOTABLE_PARENT_NODESr( �getattrri r! r! r" �is_smartquotable[ s
r� r )r� �tagsr c C s� | � tj�D ]�}z|�|d �}W nL tyn } z4tjtd�||d� |�|j pVt
� � � W Y d}~q d}~0 0 |r�|�|j p�t
� � � q |�t
� � � q dS )z0Filter ``only`` nodes which do not match *tags*.�exprz8exception while evaluating only directive expression: %sr� N) rL r ZonlyZeval_conditionr) rA r� r Z replace_selfr[ r
Zcomment)r� r� r% �ret�errr! r! r" �process_only_nodesi s �*r� )r r c C s6 | j | jfi | j��}t| tj�r2| j|_| j|_|S )z�monkey-patch Element.copy to copy the rawsource and line
for docutils-0.16 or older versions.
refs: https://sourceforge.net/p/docutils/patches/165/
)r4 r@ Z
attributesr& r
r rD rE )r Znewnoder! r! r" � _new_copy} s
r� )r7 )N)r> N)N)hr1 rM r� �typingr r r r r r r r r
r r Zdocutilsr
Zdocutils.nodesr r Zdocutils.parsers.rstr Zdocutils.parsers.rst.statesr Zdocutils.statemachiner Zsphinxr Z
sphinx.localer Z sphinx.utilr Zsphinx.buildersr Z
sphinx.domainr Zsphinx.environmentr Zsphinx.util.tagsr Z getLoggerr. rA �compile�DOTALLry Zcaption_ref_rer r9 r6 �intr< rS Z InvisiblerP Z
doctest_blockZversionmodifiedrZ r2 rW r] Z
math_blockru rb rG ZIMAGE_TYPE_NODESrV rc rg rQ rj rh rn rp rs rw r{ r� r� r� r� r� r� r� r� r� r� Z pending_xrefr� r� r� r� r� r� ZFixedTextElement�literalZmathZ problematicZnot_smartquotabler� r� r� r� �copyr! r! r! r" �<module> s�
4
4
?� .��� #
� '
� "
�$�
�� � �
� �