| 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 dl Z d dlZd dlmZ d dlmZ d dl mZ d dlmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZ d dlZd dlmZ d dlmZ d d lmZmZm Z d d
l m Z m Z m Z d d l!m"Z" d d l#m$Z$m%Z%m&Z& d d
l'm(Z(m)Z) d dl*m+Z+ d dl,m-Z- d dl.m/Z/m0Z0 d dl1m2Z2 d dl3m4Z4 e2�5e6�Z7e�8d�Z9e
�rpd dl:m;Z; d dl<m=Z= d dl>m?Z? e+�@ejA�jBZCeD� ZEeee eFd< eed d�dd��ZGeHeId �d d �ZJeHee dd �d d!�ZKeHeId �d"d#�ZLeHe4dd$�d%d&�ZMeHdd �d'd(�ZNee eId)�d*d+�ZOee dd)�d,d-�ZPee dd)�d.d/�ZQeed d�d0d1��ZReeeH ed d2�d3d4��ZSedYeeH ed d2�d5d6��ZTG d7d8� d8�ZUG d9d:� d:eV�ZWG d;d<� d<eU�ZXG d=d>� d>�ZYG d?d@� d@e(�ZZG dAdB� dBe(�Z[eId�dCdD�Z\ee$e&ed dE�dFdG��Z]G dHdI� dIe�Z^G dJdK� dKe �Z_G dLdM� dM�Z`G dNdO� dOe`�ZaG dPdQ� dQejb�ZceCdRk �rzdSdT� Zdede_ddaeeejf eFdU< dZeHe ejfdV�dWdX�ZgdS )[� 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�}d V W | t_|t_tt�D ]}t|� t�|� q2n.| t_|t_tt�D ]}t|� t�|� q`0 d S �N) r r � _directivesr �_roles�listr) �unregister_node�discard)r- r. �node� r3 �8/usr/lib/python3.9/site-packages/sphinx/util/docutils.py�docutils_namespace0 s
� r5 )�namer+ c C s
| t jv S r, )r r- �r6 r3 r3 r4 �is_directive_registeredA s r8 )r6 � directiver+ c C s t �| |� d S r, )r �register_directive)r6 r9 r3 r3 r4 r: F s r: c C s
| t jv S r, )r r. r7 r3 r3 r4 �is_role_registeredO s r; )r6 �roler+ c C s t �| |� d S r, )r Zregister_local_role)r6 r< r3 r3 r4 �
register_roleT s r= c C s t j�| d � d S r, )r r. �popr7 r3 r3 r4 �unregister_role] s r? �r2 r+ c C s t tjd| j �S �N�visit_)�hasattrr �GenericNodeVisitor�__name__�r2 r3 r3 r4 �is_node_registeredb s rG c C s. t tjd| j �s*t�| jg� t�| � d S rA )rC r rD rE Z_add_node_class_namesr) �addrF r3 r3 r4 �
register_nodeg s rI c C s^ t tjd| j �rZttjd| j � ttjd| j � ttjd| j � ttjd| j � d S )NrB Zdepart_)rC r rD rE �delattrZSparseNodeVisitorrF r3 r3 r4 r0 r s
r0 c # sN ddl m� dtttd�� fdd�
} z| tj_d V W � tj_n
� tj_0 d S )Nr �� get_language)�
language_code�reporterr+ c s � | �S r, r3 )rM rN rK r3 r4 �patched_get_language� s z2patched_get_language.<locals>.patched_get_language)N)Zdocutils.languagesrL �strr r �docutils� languages)rO r3 rK r4 rO ~ s rO )�confdirr+ c
c s� zVt j�dd �}| r,t�t�| �d�t jd< d V W |d u rLt j�dd � q||t jd< n$|d u rpt j�dd � n
|t jd< 0 d S )NZDOCUTILSCONFIGz
docutils.conf)�os�environ�getr �join�abspathr> )rS Zdocutilsconfigr3 r3 r4 �using_user_docutils_conf� s �rY c c sX t � �> t| �� d V W d � n1 s,0 Y W d � n1 sJ0 Y d S r, )rO rY )rS r3 r3 r4 �patch_docutils� s rZ c @ s� e Zd Zdd�dd�Zdd�dd�Zee eedd�dd �Zdd�d
d �Z dd�d d
�Z
e e e
jeeee ee f d�dd�Ze e eeeeee f d�dd�ZdS )�CustomReSTDispatcherNr* c C s dd� | _ dd� | _d S )Nc W s d g fS r, r3 ��argsr3 r3 r4 �<lambda>� � z/CustomReSTDispatcher.__init__.<locals>.<lambda>c W s d g fS r, r3 r\ r3 r3 r4 r^ � r_ )�directive_funcZ
roles_func��selfr3 r3 r4 �__init__� s
z CustomReSTDispatcher.__init__c C s | � � d S r, )�enablera r3 r3 r4 � __enter__� s z CustomReSTDispatcher.__enter__)�exc_type� exc_value� tracebackr+ c C s | � � d S r, )�disable)rb rf rg rh r3 r3 r4 �__exit__� s z CustomReSTDispatcher.__exit__c C s$ t j| _tj| _| jt _| jt_d S r, )r r9 r` r r< � role_funcra r3 r3 r4 rd � s zCustomReSTDispatcher.enablec C s | j t_| jt_d S r, )r` r r9 rk r r< ra r3 r3 r4 ri � s z CustomReSTDispatcher.disable��directive_name�language_module�documentr+ c C s | � |||�S r, )r` �rb rm rn ro r3 r3 r4 r9 � s z CustomReSTDispatcher.directive�� role_namern �linenorN r+ c C s | � ||||�S r, )rk �rb rr rn rs rN r3 r3 r4 r< � s zCustomReSTDispatcher.role)rE �
__module__� __qualname__rc re r � Exceptionr rj rd ri rP r r ro r r
r r r r9 �intr r% r< r3 r3 r3 r4 r[ � s � �r[ c @ s e Zd ZdS )�ElementLookupErrorN)rE ru rv r3 r3 r3 r4 ry � s ry c s� e Zd Zddd�� fdd� Zeeed�dd�Zeeej e
e e e
ee f d �� fd
d � Zeeeee
eee f d �� fd
d� Z� ZS )�sphinx_domainsr( N)�envr+ c s || _ t� �� d S r, )r{ �superrc )rb r{ �� __class__r3 r4 rc � s zsphinx_domains.__init__)�typer6 r+ c C s� |� � }d|v rl|�dd�\}}|| jjv rX| j�|�}t||�|�}|d urj|g fS q�t�td�||� n4| jj �
d�}|d ur�t||�|�}|d ur�|g fS t| j�d�|�|�}|d ur�|g fS t �d S )N�:� z%unknown directive or role name: %s:%sZdefault_domainZstd) �lower�splitr{ ZdomainsZ
get_domain�getattr�logger�warningr" � temp_datarV ry )rb r r6 Z domain_name�domain�elementZ
def_domainr3 r3 r4 �lookup_domain_element� s$
z$sphinx_domains.lookup_domain_elementrl c s6 z| � d|�W S ty0 t� �|||� Y S 0 d S )Nr9 )r� ry r| r9 rp r} r3 r4 r9 � s zsphinx_domains.directiverq c s8 z| � d|�W S ty2 t� �||||� Y S 0 d S )Nr< )r� ry r| r< rt r} r3 r4 r< s zsphinx_domains.role)rE ru rv rc rP r r� r r ro r r
r r r r r9 rx r r% r< �
__classcell__r3 r3 r} r4 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)rb r� �matchedr� r �level�messager3 r3 r4 �write
s
zWarningStream.write)rE ru rv rP r� r3 r3 r3 r4 r� s r� c sN e Zd Zeed d�dd��Zejejddfee e e
edd�� fdd �
Z � Z S )
�LoggingReporter)rN r+ c C s | |j |j|j|j|j�S r, )�source� report_level�
halt_levelZ
debug_flag�
error_handler)�clsrN r3 r3 r4 �
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| rc )rb r� r� r� r� r� �streamr} r3 r4 rc s �zLoggingReporter.__init__)
rE ru rv � classmethodr r� Z
WARNING_LEVELZ SEVERE_LEVELrP rx �boolrc r� r3 r3 r} r4 r� s ��r� c s" e Zd Zdd�� fdd� Z� ZS )� NullReporterNr* c s t � �ddd� d S )Nr� i� � )r| rc ra r} r3 r4 rc & s zNullReporter.__init__)rE ru rv rc r� r3 r3 r} r4 r� # s r� c C s t dkS )N)r �
r )�__version_info__r3 r3 r3 r4 �is_html5_writer_available* s r� )�state�contentr+ c c sL z:| j jj}tg d �}||_|j| j j_d V W || j j_n || j j_0 d S r, )�memorN �get_source_and_liner Z input_lines)r� r� r� �
state_machiner3 r3 r4 �switch_source_input. s
r� c s8 e Zd Zedd�� fdd� Zeed�� fdd� Z� ZS )�SphinxFileOutputN)�kwargsr+ c s$ |� dd�| _t� jf i |�� d S )N�overwrite_if_changedF)r> r� r| rc )rb r� r} r3 r4 rc 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� rT r �exists�openr� �readr| r� )rb r� �fr} r3 r4 r� G s � � 0zSphinxFileOutput.write)rE ru rv r rc rP r� r� r3 r3 r} r4 r� @ s r� c @ sd e Zd Zedd�dd��Zedd�dd��Zeeef d�dd �Z e
d
d �d d
�Z ed�dd�Z d
S )�SphinxDirectiver( r* c C s | j jjjS r, )r� ro �settingsr{ ra r3 r3 r4 r{ [ s zSphinxDirective.envr' c C s | j jS r, �r{ �configra r3 r3 r4 r� ` s zSphinxDirective.configc C s | j �| j�S r, )r� r� rs ra r3 r3 r4 �get_source_infoe s z SphinxDirective.get_source_infoNr@ c C s | � � \|_|_d S r, �r� r� �line�rb r2 r3 r3 r4 �set_source_infoi s z SphinxDirective.set_source_infoc C s d� dd� | �� D ��S )Nr� c s s | ]}t |�V qd S r, �rP ��.0�sr3 r3 r4 � <genexpr>o r_ z/SphinxDirective.get_location.<locals>.<genexpr>�rW r� ra r3 r3 r4 � get_locationm s z SphinxDirective.get_location)
rE ru rv �propertyr{ r� r rP rx r� r r� r� r3 r3 r3 r4 r� R s r� c @ s� e Zd ZU eed< eed< eed< eed< eed< eed< ee ed< i g feeeeeeee e ee
ee f d�d d
�Z e ee
ee f d �d d
�Z
edd �dd��Zedd �dd��Zd ee eef d�dd�Zd e
edd�dd�Zed �dd �ZdS ) �
SphinxRoler6 �rawtextr� rs �inliner�optionsr� �r6 r� r� rs 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� rs r� r� r� r� r6 r{ r� rV r� r� r! �run)rb r6 r� r� rs r� r� r� r3 r3 r4 �__call__� s
zSphinxRole.__call__r* c C s t �d S r, )�NotImplementedErrorra r3 r3 r4 r� � s zSphinxRole.runr( c C s | j jjjS r, )r� ro r� r{ ra r3 r3 r4 r{ � s zSphinxRole.envr' c C s | j jS r, r� ra r3 r3 r4 r� � s zSphinxRole.configN)rs r+ c C s |d u r| j }| jj�|�S r, )rs r� rN r� )rb rs r3 r3 r4 r� � s zSphinxRole.get_source_info)r2 rs r+ c C s | � |�\|_|_d S r, r� )rb r2 rs r3 r3 r4 r� � s zSphinxRole.set_source_infoc C s d� dd� | �� D ��S )Nr� c s s | ]}t |�V qd S r, r� r� r3 r3 r4 r� � r_ z*SphinxRole.get_location.<locals>.<genexpr>r� ra r3 r3 r4 r� � s zSphinxRole.get_location)N)N)rE ru rv rP �__annotations__rx r r
r r r r r� r� r� r{ r� r� r� r� r3 r3 r3 r4 r� r s(
�
� r� c sz e Zd ZU eed< eed< eed< eed< e�dej�Z i g feeee
e e e
e ee
e e
e f d�� fdd�
Z� ZS ) �
ReferenceRole�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� ) rb r6 r� r� rs r� r� r� r� r} r3 r4 r� � s
zReferenceRole.__call__)rE ru rv r� r� rP �re�compile�DOTALLr� rx r r
r r r r r� r� r3 r3 r} r4 r� � s
�
�r� c s` e Zd Zejddd�� fdd� Zedd�� fdd� Zedd�� fd d
� Zedd�d d �Z � Z
S )
�SphinxTranslatorr& N)ro �builderr+ c s& t � �|� || _|j| _|j| _d S r, )r| rc r� r� r� )rb ro r� r} r3 r4 rc � s zSphinxTranslator.__init__r@ c s@ |j jD ]&}t| d|j d �}|r||� q<qt� �|� d S )Nzvisit_%s)r~ �__mro__r� rE r| �dispatch_visit�rb r2 Z
node_class�methodr} r3 r4 r� � s z SphinxTranslator.dispatch_visitc s@ |j jD ]&}t| d|j d �}|r||� q<qt� �|� d S )Nz depart_%s)r~ r� r� rE r| �dispatch_departurer� r} r3 r4 r� � s z#SphinxTranslator.dispatch_departurec C s t jtd�||d� d S )Nzunknown node type: %rr� )r� r� r# r� r3 r3 r4 �
unknown_visit
s z SphinxTranslator.unknown_visit) rE ru rv r ro rc r r� r� r� r� r3 r3 r} r4 r� � s r� )r � c O s t | j|i |���S r, )�iterZtraverse)rb r] r� r3 r3 r4 �findall s r� �__document_cache__)� source_pathr� r+ c C sT t d u rtj�| �a |d u r&tt j�}ddlm} |j|t j | d�}|�
| d� |S )Nr )�addnodes)r� ���) r� rQ Zutils� new_documentr r� Zsphinxr� ro rN Z note_source)r� r� r� ro r3 r3 r4 r� s
r� )N)N)hrT r� �
contextlibr r r �typesr �typingr r r r r
r r r
r r r r rQ 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 getLoggerrE r� r� r� Zsphinx.buildersr& Z
sphinx.configr' Zsphinx.environmentr( �parse� __version__�releaser� �setr) r� r5 rP r� r8 r: r; r= r? rG rI r0 rO rY rZ r[ rw ry rz r� r� r� r� r� r� r� r� r� Z NodeVisitorr� r� r� ro r� r3 r3 r3 r4 �<module> s~
8
&6 B";