| 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
�abUF � @ s� d Z ddlmZmZmZmZmZ ddlmZ ddl m
Z
erHddl m Z zddl m
Z W n$ ey| ddlmZ ej
ZY n0 G dd � d ej�ZG d
d � d ej�ZG d d
� d
�ZG dd� dejej
e�ZG dd� dej
e�ZG dd� dejej
�ZG dd� deejej ej �Z G dd� dejej ej �Z G dd� dejej
�Z!G dd� deej ej �Z"G d d � d eejej ej �Z#G d d � d eejej ej �Z$e$Z%G d d!� d!ejej ej �Z&G d"d#� d#e&�Z'G d$d%� d%ejej ej �Z(G d&d'� d'ejej ej �Z)G d(d)� d)ejej ej �Z*G d*d+� d+ejej ej �Z+G d,d-� d-ej,e�Z-G d.d/� d/e-�Z.G d0d1� d1e-�Z/G d2d3� d3e-�Z0G d4d5� d5e-�Z1G d6d7� d7e-�Z2G d8d9� d9e-�Z3G d:d;� d;e-�Z4G d<d=� d=e-�Z5G d>d?� d?e-�Z6e.e/e0e1e2e3e4e5e6g Z7G d@dA� dAejej �Z8G dBdC� dCejej
�Z9G dDdE� dEejej
�Z:G dFdG� dGejej ej �Z;G dHdI� dIej<ej ej �Z=G dJdK� dKejej �Z>G dLdM� dMej
�Z?G dNdO� dOej
�Z@G dPdQ� dQej
�ZAG dRdS� dSejB�ZCG dTdU� dUej
�ZDG dVdW� dWej
�ZEG dXdY� dYej
�ZFG dZd[� d[ej
�ZGG d\d]� d]ej
�ZHG d^d_� d_ejIejJej
�Z
G d`da� daej ej
�ZKG dbdc� dcej ej �ZLG ddde� deejM�ZNG dfdg� dgejM�ZOG dhdi� diejPe�ZQG djdk� dkejRe�ZSG dldm� dmej ej �ZTdneeUef do�dpdq�ZVdrS )sz�
sphinx.addnodes
~~~~~~~~~~~~~~~
Additional docutils nodes.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�
TYPE_CHECKING�Any�Dict�List�Sequence)�nodes)�Element)�Sphinx)�meta)�MetaBodyc s. e Zd ZdZdeeeed�� fdd�
Z� ZS )�documentaj The document root element patched by Sphinx.
This fixes that document.set_id() does not support a node having multiple node Ids.
see https://sourceforge.net/p/docutils/patches/167/
.. important:: This is only for Sphinx internal use. Please don't use this
in your extensions. It will be removed without deprecation period.
N� )�node�msgnode�suggested_prefix�returnc sf ddl m} |jdkr(t� �|||�}nt� �||�}|jdk rb|d D ]}|| jvrH|| j|< qH|S )Nr ��docutils)r � )r � �ids)� sphinx.utilr �__version_info__�super�set_idr )�selfr r r r �retZnode_id�� __class__� �3/usr/lib/python3.9/site-packages/sphinx/addnodes.pyr % s
zdocument.set_id)Nr
)�__name__�
__module__� __qualname__�__doc__r �strr �
__classcell__r r r r r s ��r c @ sB e Zd ZdZdd�dd�Zeedd�dd�Zee d�d d
�ZdS ) � translatablea� Node which supports translation.
The translation goes forward with following steps:
1. Preserve original translatable messages
2. Apply translated messages from message catalog
3. Extract preserved messages (for gettext builder)
The translatable nodes MUST preserve original messages.
And these messages should not be overridden at applying step.
Because they are used at final step; extraction.
N�r c C s t �dS )z(Preserve original translatable messages.N��NotImplementedError�r r r r �preserve_original_messagesD s z'translatable.preserve_original_messages��original_message�translated_messager c C s t �dS )zApply translated message.Nr) )r r. r/ r r r �apply_translated_messageH s z%translatable.apply_translated_messagec C s t �dS )zjExtract translation messages.
:returns: list of extracted messages or messages generator
Nr) r+ r r r �extract_original_messagesL s z&translatable.extract_original_messages) r! r" r# r$ r, r% r0 r r1 r r r r r' 6 s
r' c @ s e Zd ZdZdZdS )�not_smartquotablez+A node which does not support smart-quotes.FN)r! r" r# r$ Zsupport_smartquotesr r r r r2 T s r2 c @ sB e Zd ZdZdd�dd�Zeedd�dd�Zee d�d d
�ZdS ) �toctreez Node for inserting a "TOC tree".Nr( c C sF | � dg �}| d D ]\}}|r|�|� q| �d�rB| d | d< d S )N�
rawentries�entries�caption�
rawcaption)�
setdefault�append�get)r r4 �titleZ_docnamer r r r, \ s
z"toctree.preserve_original_messagesr- c C sL t | d �D ]$\}\}}||kr ||f| d |< q | �d�|krH|| d< d S )Nr5 r7 r6 )� enumerater: )r r. r/ �ir; Zdocnamer r r r0 g s
z toctree.apply_translated_messagec C s0 g }|� | �dg �� d| v r,|�| d � |S )Nr4 r7 )�extendr: r9 )r �messagesr r r r1 q s
z!toctree.extract_original_messages) r! r" r# r$ r, r% r0 r r1 r r r r r3 Y s
r3 c s< e Zd ZU dZg Zee ed< eedd�� fdd� Z � Z
S )�_desc_classes_injectorz_Helper base class for injecting a fixes list of classes.
Use as the first base class.
�classesN)�args�kwargsr c s& t � j|i |�� | d �| j� d S �NrA �r �__init__r> rA )r rB rC r r r rF � s z _desc_classes_injector.__init__) r! r" r# r$ rA r r% �__annotations__r rF r& r r r r r@ � s
r@ c @ s e Zd ZdZdS )�descam Node for a list of object signatures and a common description of them.
Contains one or more :py:class:`desc_signature` nodes
and then a single :py:class:`desc_content` node.
This node always has two classes:
- The name of the domain it belongs to, e.g., ``py`` or ``cpp``.
- The name of the object type in the domain, e.g., ``function``.
N�r! r" r# r$ r r r r rH � s rH c s, e Zd ZdZddgZe� fdd��Z� ZS )�desc_signatureaS Node for a single object signature.
As default the signature is a single-line signature.
Set ``is_multiline = True`` to describe a multi-line signature.
In that case all child nodes must be :py:class:`desc_signature_line` nodes.
This node always has the classes ``sig``, ``sig-object``, and the domain it belongs to.
�sigz
sig-objectc s | � d�rdS t� jS d S )NZ is_multiline� )r: r �child_text_separatorr+ r r r rM � s
z#desc_signature.child_text_separator)r! r" r# r$ rA �propertyrM r& r r r r rJ � s rJ c @ s e Zd ZdZdZdS )�desc_signature_linez�Node for a line in a multi-line object signature.
It should only be used as a child of a :py:class:`desc_signature`
with ``is_multiline`` set to ``True``.
Set ``add_permalink = True`` for the line that should get the permalink.
r
N)r! r" r# r$ Zsphinx_line_typer r r r rO � s rO c @ s e Zd ZdZdS )� desc_contentzfNode for object description content.
Must be the last child node in a :py:class:`desc` node.
NrI r r r r rP � s rP c s4 e Zd ZdZddgZeeedd�� fdd� Z� ZS )� desc_inlinez�Node for a signature fragment in inline text.
This is for example used for roles like :rst:role:`cpp:expr`.
This node always has the classes ``sig``, ``sig-inline``,
and the name of the domain it belongs to.
rK z
sig-inlineN)�domainrB rC r c s$ t � j|i |�� | d �|� d S rD )r rF r9 )r rR rB rC r r r rF � s zdesc_inline.__init__) r! r" r# r$ rA r% r rF r& r r r r rQ � s rQ c @ s e Zd ZdZddgZdS )� desc_namez�Node for the main object name.
For example, in the declaration of a Python class ``MyModule.MyClass``,
the main name is ``MyClass``.
This node always has the class ``sig-name``.
zsig-nameZdescnameN�r! r" r# r$ rA r r r r rS � s rS c @ s e Zd ZdZddgZdS )� desc_addnamez�Node for additional name parts for an object.
For example, in the declaration of a Python class ``MyModule.MyClass``,
the additional name part is ``MyModule.``.
This node always has the class ``sig-prename``.
z sig-prenameZ
descclassnameNrT r r r r rU � s rU c @ s e Zd ZdZdS )� desc_typez+Node for return types or object type names.NrI r r r r rV � s rV c s& e Zd ZdZed�� fdd� Z� ZS )� desc_returnsz4Node for a "returns" annotation (a la -> in Python).r( c s dt � �� S )Nz -> �r �astextr+ r r r rY � s zdesc_returns.astext)r! r" r# r$ r% rY r& r r r r rW � s rW c s$ e Zd ZdZdZ� fdd�Z� ZS )�desc_parameterlistz"Node for a general parameter list.�, c s d� t� �� �S )Nz({}))�formatr rY r+ r r r rY s zdesc_parameterlist.astext)r! r" r# r$ rM rY r& r r r r rZ s rZ c @ s e Zd ZdZdS )�desc_parameterz Node for a single parameter.NrI r r r r r] s r] c s* e Zd ZdZdZed�� fdd� Z� ZS )�
desc_optionalz6Node for marking optional parts of the parameter list.r[ r( c s dt � �� d S )N�[�]rX r+ r r r rY s zdesc_optional.astext)r! r" r# r$ rM r% rY r& r r r r r^ s r^ c @ s e Zd ZdZdS )�desc_annotationz@Node for signature annotations (not Python 3-style annotations).NrI r r r r ra s ra c sB e Zd ZU dZg Zee ed< deeee dd�� fdd�
Z
� Z S ) �desc_sig_elementz<Common parent class of nodes for inline text of a signature.rA r
N�� rawsource�text�children�
attributesr c s0 t � j||g|�R i |�� | d �| j� d S rD rE �r rd re rf rg r r r rF # s zdesc_sig_element.__init__)r
r
) r! r" r# r$ rA r r% rG r r rF r& r r r r rb s
�rb c s6 e Zd ZdZdgZd eeeedd�� fdd�
Z� Z S )
�desc_sig_spacez Node for a space in a signature.�wr
rL Nrc c s t � j||g|�R i |�� d S )N)r rF rh r r r rF 0 s zdesc_sig_space.__init__)r
rL )
r! r" r# r$ rA r% r r rF r& r r r r ri , s
�ri c @ s e Zd ZdZdgZdS )�
desc_sig_namez&Node for an identifier in a signature.�nNrT r r r r rk 5 s rk c @ s e Zd ZdZdgZdS )�desc_sig_operatorz$Node for an operator in a signature.�oNrT r r r r rm : s rm c @ s e Zd ZdZdgZdS )�desc_sig_punctuationz$Node for punctuation in a signature.�pNrT r r r r ro ? s ro c @ s e Zd ZdZdgZdS )�desc_sig_keywordz*Node for a general keyword in a signature.�kNrT r r r r rq D s rq c @ s e Zd ZdZdgZdS )�desc_sig_keyword_typez;Node for a keyword which is a built-in type in a signature.ZktNrT r r r r rs I s rs c @ s e Zd ZdZdgZdS )�desc_sig_literal_numberz*Node for a numeric literal in a signature.�mNrT r r r r rt N s rt c @ s e Zd ZdZdgZdS )�desc_sig_literal_stringz)Node for a string literal in a signature.�sNrT r r r r rv S s rv c @ s e Zd ZdZdgZdS )�desc_sig_literal_charz,Node for a character literal in a signature.ZscNrT r r r r rx X s rx c @ s e Zd ZdZdS )�versionmodifiedzNode for version change entries.
Currently used for "versionadded", "versionchanged" and "deprecated"
directives.
NrI r r r r ry h s ry c @ s e Zd ZdZdS )�seealsoz Custom "see also" admonition.NrI r r r r rz p s rz c @ s e Zd ZdZdS )�productionlistzKNode for grammar production lists.
Contains ``production`` nodes.
NrI r r r r r{ t s r{ c @ s e Zd ZdZdS )�
productionz*Node for a single grammar production rule.NrI r r r r r| { s r| c @ s e Zd ZdZdS )�indexa� Node for index entries.
This node is created by the ``index`` directive and has one attribute,
``entries``. Its value is a list of 5-tuples of ``(entrytype, entryname,
target, ignored, key)``.
*entrytype* is one of "single", "pair", "double", "triple".
*key* is categorization characters (usually a single character) for
general index page. For the details of this, please see also:
:rst:dir:`glossary` and issue #2320.
NrI r r r r r} � s r} c @ s e Zd ZdZdS )�centeredz Deprecated.NrI r r r r r~ � s r~ c @ s e Zd ZdZdS )�acksz Special node for "acks" lists.NrI r r r r r � s r c @ s e Zd ZdZdS )�hlistzjNode for "horizontal lists", i.e. lists that should be compressed to
take up less vertical space.
NrI r r r r r� � s r� c @ s e Zd ZdZdS )�hlistcolz)Node for one column in a horizontal list.NrI r r r r r� � s r� c @ s e Zd ZdZdS )�compact_paragraphz<Node for a compact paragraph (which never makes a <p> node).NrI r r r r r� � s r� c @ s e Zd ZdZdS )�glossaryzNode to insert a glossary.NrI r r r r r� � s r� c @ s e Zd ZdZdS )�onlyzANode for "only" directives (conditional inclusion based on tags).NrI r r r r r� � s r� c @ s e Zd ZdZdS )�
start_of_filezANode to mark start of a new file, used in the LaTeX builder only.NrI r r r r r� � s r� c @ s e Zd ZdZdS )�
highlightlangzcInserted to set the highlight language and line number options for
subsequent code blocks.
NrI r r r r r� � s r� c @ s e Zd ZdZdS )�tabular_col_specz;Node for specifying tabular columns, used for LaTeX output.NrI r r r r r� � s r� c @ s e Zd ZdZdZdS )r
zYNode for meta directive -- same as docutils' standard meta node,
but pickleable.
N)r! r" r# r$ Z
rawcontentr r r r r
� s r
c @ s e Zd ZdZdZdS )� pending_xrefz�Node for cross-references that cannot be resolved without complete
information about all documents.
These nodes are resolved before writing output, in
BuildEnvironment.resolve_references.
r
N)r! r" r# r$ rM r r r r r� � s r� c @ s e Zd ZdZdS )�pending_xref_conditiona} Node for cross-references that are used to choose appropriate
content of the reference by conditions on the resolving phase.
When the :py:class:`pending_xref` node contains one or more
**pending_xref_condition** nodes, the cross-reference resolver
should choose the content of the reference using defined conditions
in ``condition`` attribute of each pending_xref_condition nodes::
<pending_xref refdomain="py" reftarget="io.StringIO ...>
<pending_xref_condition condition="resolved">
<literal>
StringIO
<pending_xref_condition condition="*">
<literal>
io.StringIO
After the processing of cross-reference resolver, one of the content node
under pending_xref_condition node is chosen by its condition and to be
removed all of pending_xref_condition nodes::
# When resolved the cross-reference successfully
<reference>
<literal>
StringIO
# When resolution is failed
<reference>
<literal>
io.StringIO
.. note:: This node is only allowed to be placed under pending_xref node.
It is not allows to place it under other nodes. In addition,
pending_xref node must contain only pending_xref_condition
nodes if it contains one or more pending_xref_condition nodes.
The pending_xref_condition node should have **condition** attribute.
Domains can be store their individual conditions into the attribute to
filter contents on resolving phase. As a reserved condition name,
``condition="*"`` is used for the fallback of resolution failure.
Additionally, as a recommended condition name, ``condition="resolved"``
is used for the representation of resolstion success in the intersphinx
module.
.. versionadded:: 4.0
NrI r r r r r� � s r� c @ s e Zd ZdZdS )�number_referencez4Node for number references, similar to pending_xref.NrI r r r r r� s r� c @ s e Zd ZdZdS )�download_referencez6Node for download references, similar to pending_xref.NrI r r r r r� s r� c @ s e Zd ZdZdS )�literal_emphasisz{Node that behaves like `emphasis`, but further text processors are not
applied (e.g. smartypants for HTML output).
NrI r r r r r� s r� c @ s e Zd ZdZdS )�literal_strongzyNode that behaves like `strong`, but further text processors are not
applied (e.g. smartypants for HTML output).
NrI r r r r r� s r� c @ s e Zd ZdZdS )�manpagez Node for references to manpages.NrI r r r r r� s r� r )�appr c C s� ddl m} | �t� | �t� | �t� | �t� | �t� | �t� | �t � | �t
� | �t � | �t � | �t
� | �t� | �t� | �t� tD ]}| �|� q�| �t� | �t� | �t� | �t� | �t� | �t� | �t� | �t� | �t� | �t� | �t � | �t � | �t � | �t � | �t � | �t!� | �t"� | �t#� | �t$� | �t%� | �t&� |j'dk �r�| �t(� dddd�S )Nr r )r � ZbuiltinT)�versionZparallel_read_safeZparallel_write_safe))r r Zadd_noder3 rH rJ rO rP rQ rS rU rV rW rZ r] r^ ra � SIG_ELEMENTSry rz r{ r| r} r~ r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r
)r� r rl r r r �setup sX
�r� N)Wr$ �typingr r r r r r r Zdocutils.nodesr Zsphinx.applicationr r
Z
docutils_meta� ImportErrorZ$docutils.parsers.rst.directives.htmlr r ZNoder' r2 ZGeneralr3 r@ Z
AdmonitionrH ZPartZInlineZ TextElementrJ ZFixedTextElementrO rP rQ rS rU Zdesc_classnamerV rW rZ r] r^ ra Zinlinerb ri rk rm ro rq rs rt rv rx r� ry rz r{ r| Z Invisibler} r~ r r� r� Z paragraphr� r� r� r� r� r� �SpecialZPreBibliographicr� r� Z referencer� r� Zemphasisr� Zstrongr� r� r% r� r r r r �<module> s�
(
�
0