| 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$O � @ s� U d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZ ddlZddlmZ dd lmZ dd
lmZm Z m Z dd l m Z m Z m!Z! dd l"m#Z# dd
l$m%Z%m&Z&m'Z' ddl(m)Z)m*Z* ddl+m,Z, ddl-m.Z. ddl/m0Z0m1Z1 ddl2m3Z3 ddl4m5Z5 e3�6e7�Z8e�9d�Z:e �rtddl;m<Z< ddl=m>Z> ddl?m@Z@ e,�AejB�jCZDeE� ZFeee eGd< eed d�dd ��ZHeIeJd �d d �ZKeIee dd �d!d"�ZLeIeJd �d#d$�ZMeIe5dd%�d&d'�ZNeIdd �d(d)�ZOee eJd*�d+d,�ZPee dd*�d-d.�ZQee dd*�d/d0�ZReed d�d1d2��ZSeeeI ed d3�d4d5��ZTedZeeI ed d3�d6d7��ZUG d8d9� d9�ZVG d:d;� d;eW�ZXG d<d=� d=eV�ZYG d>d?� d?�ZZG d@dA� dAe)�Z[G dBdC� dCe)�Z\eJd�dDdE�Z]ee%e'ed dF�dGdH��Z^G dIdJ� dJe�Z_G dKdL� dLe �Z`G dMdN� dN�ZaG dOdP� dPea�ZbG dQdR� dRejc�ZdeDdSk �r~dTdU� Zeeee _edafeejg eGdV< d[eIe ejgdW�dXdY�ZhdS )\z�
sphinx.util.docutils
~~~~~~~~~~~~~~~~~~~~
Utility functions for docutils.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�contextmanager)�copy)�path)�
ModuleType) �IO�
TYPE_CHECKING�Any�Callable�Dict� Generator�List�Optional�Set�Tuple�Type�cast)�nodes)�
FileOutput)�Element�Node�system_message)� Directive�
directives�roles)�Inliner)�State� StateMachine�
StringList)�Reporter�unescape)�version)� SphinxError)�_�__)�logging)� RoleFunctionz>^(.+?:(?:\d+)?): \((DEBUG|INFO|WARNING|ERROR|SEVERE)/(\d+)?\) )�Builder)�Config)�BuildEnvironment�additional_nodes)NNN��returnc
c s~ zJt tj�} t tj�}dV W | t_|t_tt�D ]}t|� t�|� q2n.| t_|t_tt�D ]}t|� t�|� q`0 dS )z"Create namespace for reST parsers.N) r r � _directivesr �_roles�listr) �unregister_node�discard)r, r- �node� r2 �8/usr/lib/python3.9/site-packages/sphinx/util/docutils.py�docutils_namespace0 s
� r4 )�namer+ c C s
| t jv S )z1Check the *name* directive is already registered.)r r, �r5 r2 r2 r3 �is_directive_registeredA s r7 )r5 � directiver+ c C s t �| |� dS )z�Register a directive to docutils.
This modifies global state of docutils. So it is better to use this
inside ``docutils_namespace()`` to prevent side-effects.
N)r �register_directive)r5 r8 r2 r2 r3 r9 F s r9 c C s
| t jv S )z,Check the *name* role is already registered.)r r- r6 r2 r2 r3 �is_role_registeredO s r: )r5 �roler+ c C s t �| |� dS )z�Register a role to docutils.
This modifies global state of docutils. So it is better to use this
inside ``docutils_namespace()`` to prevent side-effects.
N)r Zregister_local_role)r5 r; r2 r2 r3 �
register_roleT s r< c C s t j�| d� dS )z Unregister a role from docutils.N)r r- �popr6 r2 r2 r3 �unregister_role] s r> �r1 r+ c C s t tjd| j �S )z'Check the *node* is already registered.�visit_)�hasattrr �GenericNodeVisitor�__name__�r1 r2 r2 r3 �is_node_registeredb s rE c C s. t tjd| j �s*t�| jg� t�| � dS )z�Register a node to docutils.
This modifies global state of some visitors. So it is better to use this
inside ``docutils_namespace()`` to prevent side-effects.
r@ N)rA r rB rC Z_add_node_class_namesr) �addrD r2 r2 r3 �
register_nodeg s rG c C s^ t tjd| j �rZttjd| j � ttjd| j � ttjd| j � ttjd| j � dS )zaUnregister a node from docutils.
This is inverse of ``nodes._add_nodes_class_names()``.
r@ Zdepart_N)rA r rB rC �delattrZSparseNodeVisitorrD r2 r2 r3 r/ r s
r/ c # sN ddl m� dtttd�� fdd�
} z| tj_dV W � tj_n
� tj_0 dS )z�Patch docutils.languages.get_language() temporarily.
This ignores the second argument ``reporter`` to suppress warnings.
refs: https://github.com/sphinx-doc/sphinx/issues/3788
r �� get_languageN)�
language_code�reporterr+ c s � | �S �Nr2 )rK rL rI r2 r3 �patched_get_language� s z2patched_get_language.<locals>.patched_get_language)N)Zdocutils.languagesrJ �strr r �docutils� languages)rN r2 rI r3 rN ~ s rN )�confdirr+ c
c s� zVt j�dd�}| r,t�t�| �d�t jd< dV W |du rLt j�dd� q||t jd< n$|du rpt j�dd� n
|t jd< 0 dS )z?Let docutils know the location of ``docutils.conf`` for Sphinx.ZDOCUTILSCONFIGNz
docutils.conf)�os�environ�getr �join�abspathr= )rR Zdocutilsconfigr2 r2 r3 �using_user_docutils_conf� s �rX c c sX t � �> t| �� dV W d � n1 s,0 Y W d � n1 sJ0 Y dS )z Patch to docutils temporarily.N)rN rX )rR r2 r2 r3 �patch_docutils� s rY c @ s� e Zd ZdZdd�dd�Zdd�dd�Zee eedd�d d
�Z dd�d d �Z
dd�d
d�Z e e
ejeeee ee f d�dd�Ze e
eeeeee f d�dd�ZdS )�CustomReSTDispatcherz�Custom reST's mark-up dispatcher.
This replaces docutils's directives and roles dispatch mechanism for reST parser
by original one temporarily.
Nr* c C s dd� | _ dd� | _d S )Nc W s d g fS rM r2 ��argsr2 r2 r3 �<lambda>� � z/CustomReSTDispatcher.__init__.<locals>.<lambda>c W s d g fS rM r2 r[ r2 r2 r3 r] � r^ )�directive_funcZ
roles_func��selfr2 r2 r3 �__init__� s
z CustomReSTDispatcher.__init__c C s | � � d S rM )�enabler` r2 r2 r3 � __enter__� s z CustomReSTDispatcher.__enter__)�exc_type� exc_value� tracebackr+ c C s | � � d S rM )�disable)ra re rf rg r2 r2 r3 �__exit__� s z CustomReSTDispatcher.__exit__c C s$ t j| _tj| _| jt _| jt_d S rM )r r8 r_ r r; � role_funcr` r2 r2 r3 rc � s zCustomReSTDispatcher.enablec C s | j t_| jt_d S rM )r_ r r8 rj r r; r` r2 r2 r3 rh � s z CustomReSTDispatcher.disable��directive_name�language_module�documentr+ c C s | � |||�S rM )r_ �ra rl rm rn r2 r2 r3 r8 � s z CustomReSTDispatcher.directive�� role_namerm �linenorL r+ c C s | � ||||�S rM )rj �ra rq rm rr rL r2 r2 r3 r; � s zCustomReSTDispatcher.role)rC �
__module__� __qualname__�__doc__rb rd r � Exceptionr ri rc rh rO r r rn r r
r r r r8 �intr r% r; r2 r2 r2 r3 rZ � s � �rZ c @ s e Zd ZdS )�ElementLookupErrorN)rC rt ru r2 r2 r2 r3 ry � s ry c s� e Zd ZdZddd�� fdd� Zeeed�dd �Zeee j
e e e
e ee f d
�� fd d � Zeeeee eee f d
�� fdd� Z� ZS )�sphinx_domainszcMonkey-patch directive and role dispatch, so that domain-specific
markup takes precedence.
r( N)�envr+ c s || _ t� �� d S rM )r{ �superrb )ra r{ �� __class__r2 r3 rb � s zsphinx_domains.__init__)�typer5 r+ c C s� |� � }d|v rl|�dd�\}}|| jjv rX| j�|�}t||�|�}|durj|g fS q�t�td�||� n4| jj �
d�}|dur�t||�|�}|dur�|g fS t| j�d�|�|�}|dur�|g fS t �dS )ztLookup a markup element (directive or role), given its name which can
be a full name (with domain).
�:� Nz%unknown directive or role name: %s:%sZdefault_domainZstd) �lower�splitr{ ZdomainsZ
get_domain�getattr�logger�warningr" � temp_datarU ry )ra r r5 Z domain_name�domain�elementZ
def_domainr2 r2 r3 �lookup_domain_element� s$
z$sphinx_domains.lookup_domain_elementrk c s6 z| � d|�W S ty0 t� �|||� Y S 0 d S )Nr8 )r� ry r| r8 ro r} r2 r3 r8 � s zsphinx_domains.directiverp c s8 z| � d|�W S ty2 t� �||||� Y S 0 d S )Nr; )r� ry r| r; rs r} r2 r3 r; s zsphinx_domains.role)rC rt ru rv rb rO r r� r r rn r r
r r r r r8 rx r r% r; �
__classcell__r2 r2 r} r3 rz � s ��rz c @ s e Zd Zedd�dd�ZdS )�
WarningStreamN)�textr+ c C sR t �|�}|s t�|�d�� n.|�� \}}}t �d|��� }tj|||d� d S )Nz
� ��location)� report_re�searchr� r� �rstrip�groups�sub�log)ra r� �matchedr� r �level�messager2 r2 r3 �write
s
zWarningStream.write)rC rt ru rO r� r2 r2 r2 r3 r� s r� c sN e Zd Zeed d�dd��Zejejddfee e e
edd�� fdd �
Z � Z S )
�LoggingReporter)rL r+ c C s | |j |j|j|j|j�S )zACreate an instance of LoggingReporter from other reporter object.)�source� report_level�
halt_levelZ
debug_flag�
error_handler)�clsrL r2 r2 r3 �
from_reporter s �z LoggingReporter.from_reporterF�backslashreplaceN)r� r� r� �debugr� r+ c s( t tt� �}t� j||||||d� d S )N)r� )r r r� r| rb )ra r� r� r� r� r� �streamr} r2 r3 rb s �zLoggingReporter.__init__)
rC rt ru � classmethodr r� Z
WARNING_LEVELZ SEVERE_LEVELrO rx �boolrb r� r2 r2 r} r3 r� s ��r� c s& e Zd ZdZdd�� fdd� Z� ZS )� NullReporterz A dummy reporter; write nothing.Nr* c s t � �ddd� d S )Nr� i� � )r| rb r` r} r2 r3 rb & s zNullReporter.__init__)rC rt ru rv rb r� r2 r2 r} r3 r� # s r� c C s t dkS )N)r �
r )�__version_info__r2 r2 r2 r3 �is_html5_writer_available* s r� )�state�contentr+ c c sL z:| j jj}tg d�}||_|j| j j_dV W || j j_n || j j_0 dS )z1Switch current source input of state temporarily.N)�memorL �get_source_and_liner Z input_lines)r� r� r� �
state_machiner2 r2 r3 �switch_source_input. s
r� c s< e Zd ZdZedd�� fdd� Zeed�� fdd� Z� ZS ) �SphinxFileOutputz#Better FileOutput class for Sphinx.N)�kwargsr+ c s$ |� dd�| _t� jf i |�� d S )N�overwrite_if_changedF)r= r� r| rb )ra r� r} r2 r3 rb C s zSphinxFileOutput.__init__)�datar+ c s� | j rx| jrxd| jvrx| jrxtj�| j �rxt| j | jd��.}|� � |krZ|W d � S W d � n1 sn0 Y t
� � |�S )N�b)�encoding) Zdestination_pathZ autoclose�moder� rS r �exists�openr� �readr| r� )ra r� �fr} r2 r3 r� G s � � 0zSphinxFileOutput.write) rC rt ru rv r rb rO r� r� r2 r2 r} r3 r� @ s r� c @ sh e Zd ZdZedd�dd��Zedd�dd��Zeee f d�d d
�Z
e d d �d
d�Z ed�dd�Z
d S )�SphinxDirectivez�A base class for Sphinx directives.
This class provides helper methods for Sphinx directives.
.. note:: The subclasses of this class might not work with docutils.
This class is strongly coupled with Sphinx.
r( r* c C s | j jjjS �z3Reference to the :class:`.BuildEnvironment` object.)r� rn �settingsr{ r` r2 r2 r3 r{ [ s zSphinxDirective.envr' c C s | j jS �z)Reference to the :class:`.Config` object.�r{ �configr` r2 r2 r3 r� ` s zSphinxDirective.configc C s | j �| j�S )zGet source and line number.)r� r� rr r` r2 r2 r3 �get_source_infoe s z SphinxDirective.get_source_infoNr? c C s | � � \|_|_dS )z'Set source and line number to the node.N�r� r� �line�ra r1 r2 r2 r3 �set_source_infoi s z SphinxDirective.set_source_infoc C s d� dd� | �� D ��S )�&Get current location info for logging.r� c s s | ]}t |�V qd S rM �rO ��.0�sr2 r2 r3 � <genexpr>o r^ z/SphinxDirective.get_location.<locals>.<genexpr>�rV r� r` r2 r2 r3 � get_locationm s z SphinxDirective.get_location)rC rt ru rv �propertyr{ r� r rO rx r� r r� r� r2 r2 r2 r3 r� R s r� c @ s e Zd ZU dZeed< eed< eed< eed< eed< eed< e e ed< i g feeeeeee e e
e e e e f d �d
d �Z
e
e e e e f d �d
d�Zedd �dd��Zedd �dd��Zd ee
eef d�dd�Zd e edd�dd�Zed �d d �ZdS ) �
SphinxRolez�A base class for Sphinx roles.
This class provides helper methods for Sphinx roles.
.. note:: The subclasses of this class might not work with docutils.
This class is strongly coupled with Sphinx.
r5 �rawtextr� rr �inliner�optionsr� �r5 r� r� rr r� r� r� r+ c C sr || _ t|�| _|| _|| _|| _|| _|r8|�� | _n2| j j
� dd�| _| js\| j j j
| _| jsjtd��| �� S )N� default_roler� z cannot determine default role!)r� r r� rr r� r� r� r� r5 r{ r� rU r� r� r! �run)ra r5 r� r� rr r� r� r� r2 r2 r3 �__call__� s
zSphinxRole.__call__r* c C s t �d S rM )�NotImplementedErrorr` r2 r2 r3 r� � s zSphinxRole.runr( c C s | j jjjS r� )r� rn r� r{ r` r2 r2 r3 r{ � s zSphinxRole.envr' c C s | j jS r� r� r` r2 r2 r3 r� � s zSphinxRole.configN)rr r+ c C s |d u r| j }| jj�|�S rM )rr r� rL r� )ra rr r2 r2 r3 r� � s zSphinxRole.get_source_info)r1 rr r+ c C s | � |�\|_|_d S rM r� )ra r1 rr r2 r2 r3 r� � s zSphinxRole.set_source_infoc C s d� dd� | �� D ��S )r� r� c s s | ]}t |�V qd S rM r� r� r2 r2 r3 r� � r^ z*SphinxRole.get_location.<locals>.<genexpr>r� r` r2 r2 r3 r� � s zSphinxRole.get_location)N)N)rC rt ru rv rO �__annotations__rx r r
r r r r r� r� r� r{ r� r� r� r� r2 r2 r2 r3 r� r s*
�
� r� c s~ e Zd ZU dZeed< eed< eed< eed< e�dej �Z
i g feeee e e
ee eee ee f d�� fdd �
Z� ZS )
�
ReferenceRolez�A base class for reference roles.
The reference roles can accept ``link title <target>`` style as a text for
the role. The parsed result; link title and target will be stored to
``self.title`` and ``self.target``.
�has_explicit_title�disabled�title�targetz^(.+?)\s*(?<!\x00)<(.*?)>$r� c sv |� d�| _| j�|�}|rDd| _t|�d��| _t|�d��| _nd| _t|�| _t|�| _t � �
|||||||�S )N�!Tr� � F) �
startswithr� �explicit_title_re�matchr� r �groupr� r� r| r� ) ra r5 r� r� rr r� r� r� r� r} r2 r3 r� � s
zReferenceRole.__call__)rC rt ru rv r� r� rO �re�compile�DOTALLr� rx r r
r r r r r� r� r2 r2 r} r3 r� � s
�
�r� c sd e Zd ZdZejddd�� fdd� Zedd�� fdd � Zedd�� fd
d � Z edd�d d
�Z
� Z S )�SphinxTranslatorax A base class for Sphinx translators.
This class adds a support for visitor/departure method for super node class
if visitor/departure method for node class is not found.
It also provides helper methods for Sphinx translators.
.. note:: The subclasses of this class might not work with docutils.
This class is strongly coupled with Sphinx.
r& N)rn �builderr+ c s& t � �|� || _|j| _|j| _d S rM )r| rb r� r� r� )ra rn r� r} r2 r3 rb � s zSphinxTranslator.__init__r? c s@ |j jD ]&}t| d|j d�}|r||� q<qt� �|� dS )z�
Dispatch node to appropriate visitor method.
The priority of visitor method is:
1. ``self.visit_{node_class}()``
2. ``self.visit_{super_node_class}()``
3. ``self.unknown_visit()``
zvisit_%sN)r~ �__mro__r� rC r| �dispatch_visit�ra r1 Z
node_class�methodr} r2 r3 r� � s z SphinxTranslator.dispatch_visitc s@ |j jD ]&}t| d|j d�}|r||� q<qt� �|� dS )z�
Dispatch node to appropriate departure method.
The priority of departure method is:
1. ``self.depart_{node_class}()``
2. ``self.depart_{super_node_class}()``
3. ``self.unknown_departure()``
z depart_%sN)r~ r� r� rC r| �dispatch_departurer� r} r2 r3 r� � s z#SphinxTranslator.dispatch_departurec C s t jtd�||d� d S )Nzunknown node type: %rr� )r� r� r# r� r2 r2 r3 �
unknown_visit
s z SphinxTranslator.unknown_visit) rC rt ru rv r rn rb r r� r� r� r� r2 r2 r} r3 r� � s
r� )r � c O s t | j|i |���S rM )�iterZtraverse)ra r\ r� r2 r2 r3 �findall s r� �__document_cache__)� source_pathr� r+ c C sT t du rtj�| �a |du r&tt j�}ddlm} |j|t j | d�}|�
| d� |S )a& Return a new empty document object. This is an alternative of docutils'.
This is a simple wrapper for ``docutils.utils.new_document()``. It
caches the result of docutils' and use it on second call for instantiation.
This makes an instantiation of document nodes much faster.
Nr )�addnodes)r� ���) r� rP Zutils� new_documentr r� Zsphinxr� rn rL Z note_source)r� r� r� rn r2 r2 r3 r� s
r� )N)N)irv rS r� �
contextlibr r r �typesr �typingr r r r r
r r r
r r r r rP r Z docutils.ior Zdocutils.nodesr r r Zdocutils.parsers.rstr r r Zdocutils.parsers.rst.statesr Zdocutils.statemachiner r r Zdocutils.utilsr r Z packagingr Z
sphinx.errorsr! Z
sphinx.localer" r# Z sphinx.utilr$ Zsphinx.util.typingr% Z getLoggerrC r� r� r� Zsphinx.buildersr& Z
sphinx.configr' Zsphinx.environmentr( �parse� __version__�releaser� �setr) r� r4 rO r� r7 r9 r: r< r> rE rG r/ rN rX rY rZ rw ry rz r� r� r� r� r� r� r� r� r� Z NodeVisitorr� r� r� rn r� r2 r2 r2 r3 �<module> s~
8
&6 B";