| 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
�ab�V � @ s d Z ddlZddlZddlmZ ddlmZ ddlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZ ddlmZ ddlmZmZmZ dd lmZ dd
l m Z dd l m Z zdd l m!Z! W n e"y� dd l#m!Z! Y n0 dd
l$m%Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+m,Z,m-Z- ddl.m/Z/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6 ddl7m8Z8 ddl9m:Z: dd l;mZ< ddl=m>Z> ddl?m@Z@ ddlAmBZB ddlCmDZDmEZE e�r�ddlFmGZG ddlHmIZI e@�JeK�ZLd d iZMG d d � d �ZNd e'dd!�d"d#�ZOd e ePe f d$�d%d&�ZQdS )'z�
sphinx.registry
~~~~~~~~~~~~~~~
Sphinx component registry.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
import_module)�
MethodType)
�
TYPE_CHECKING�Any�Callable�Dict�Iterator�List�Optional�Tuple�Type�Union)�nodes)�Input)�Element�Node� TextElement)�Parser)� Directive)� Transform)� entry_points)�Builder)�Config)�RemovedInSphinx60Warning)�Domain�Index�ObjType)�
GenericObject�Target)�BuildEnvironment)�ExtensionError� SphinxError�VersionRequirementError)� Extension)�__)�XRefRole)�logging)�prefixed_warnings)� RoleFunction� TitleGetter)�Sphinx)�
Documenterzsphinxjp.themecorez1.2c @ sr e Zd Zdd�dd�Zdnee edd�dd�Zd edd
�d d �Z d eed
�d
d�Z
doee edd�dd�Z eed�dd�Z
eee d�dd�Zdpeeee edd�dd�Zdqeeeeef edd�d d �Zdreee edd �d d �Zd!ddd!g dfeeeeee eeedd"� d#d$�Z dseeeee eedd%�d&d'�Z dteeedd(�d)d*�Z duee edd+�d,d-�Z eee d.�d/d0�Z!e"eee f d�d1d2�Z#d ee d3�d4d5�Z$ee%ee& d.�d6d7�Z'dveee(j) edd8�d9d:�Z*ee+ e,eef dd;�d<d=�Z-eee(j) d>�d?d@�Z.ee/e(j)dA�dBdC�Z0ee1 ddD�dEdF�Z2eee1 d�dGdH�Z3ee1 ddD�dIdJ�Z4eee1 d�dKdL�Z5eedM ddN�dOdP�Z6eee/ee/ge/f ddQ�dRdS�Z7ee/ddT�dUdV�Z8ee/ddT�dWdX�Z9eedY�dZd[�Z:dweeedd\�d]d^�Z;dxee< ee=edd_�d`da�Z>ee,eef e,eef ddb�dcdd�Z?eedde�dfdg�Z@d eddh�didj�ZAd e"eef dk�dldm�ZBdS )y�SphinxComponentRegistryN)�returnc C s� i | _ i | _i | _g | _i | _i | _i | _i | _i | _i | _ i | _
i | _ d| _ i | _
g | _g | _g | _g | _i | _i | _i | _i | _i | _g | _d S )NZper_page)�autodoc_attrgettrs�builders� documenters� css_files�domains�domain_directives�domain_indices�domain_object_types� domain_roles�enumerable_nodes�html_inline_math_renderers�html_block_math_renderersZhtml_assets_policy� html_themes�js_files�latex_packages� latex_packages_after_hyperref�post_transforms�source_parsers�
source_inputs�
source_suffix� translators�translation_handlers�
transforms��self� rG �3/usr/lib/python3.9/site-packages/sphinx/registry.py�__init__; s0 z SphinxComponentRegistry.__init__F)�builder�overrider- c C sf t �d|� t|d�s&ttd�| ��|j| jv rV|sVttd�|j| j|j jf ��|| j|j< d S )Nz[app] adding builder: %r�namez(Builder class %s has no "name" attributez(Builder %r already exists (in module %s))�logger�debug�hasattrr r$ rL r/ �
__module__)rF rJ rK rG rG rH � add_builder� s
�z#SphinxComponentRegistry.add_builderr* )�apprL r- c
C sv |d u r d S || j vrrtdd�}z || }W n6 tyb } z ttd�| �|�W Y d }~n
d }~0 0 | �||j� d S )Nzsphinx.builders)�groupz?Builder name %s not registered or available through entry point)r/ r �KeyErrorr! r$ �load_extension�module)rF rR rL Zbuilder_entry_pointsZ entry_point�excrG rG rH �preload_builder� s
��z'SphinxComponentRegistry.preload_builderc C s( || j vrttd�| ��| j | |�S )Nz Builder name %s not registered)r/ r! r$ )rF rR rL rG rG rH �create_builder� s
z&SphinxComponentRegistry.create_builder)�domainrK r- c C s> t �d|� |j| jv r.|s.ttd�|j ��|| j|j< d S )Nz[app] adding domain: %rz domain %s already registered)rM rN rL r2 r r$ )rF rZ rK rG rG rH �
add_domain� s z"SphinxComponentRegistry.add_domain)rZ r- c C s
|| j v S �N)r2 )rF rZ rG rG rH �
has_domain� s z"SphinxComponentRegistry.has_domain)�envr- c c s� | j �� D ]�}||�}|j�| j�|ji �� |j�| j�|ji �� |j �
| j �|jg �� | j �|ji ��
� D ]\}}|�||� qr|V q
d S r\ )r2 �values�
directives�updater3 �getrL �rolesr6 �indices�extendr4 r5 �items�add_object_type)rF r^ Z DomainClassrZ rL �objtyperG rG rH �create_domains� s z&SphinxComponentRegistry.create_domains)rZ rL �clsrK r- c C sf t �d|||f� || jvr,ttd�| ��| j�|i �}||v rZ|sZttd�||f ��|||< d S )Nz$[app] adding directive to domain: %r� domain %s not yet registeredz3The %r directive is already registered to domain %s)rM rN r2 r r$ r3 �
setdefault)rF rZ rL rj rK r` rG rG rH �add_directive_to_domain� s
�z/SphinxComponentRegistry.add_directive_to_domain)rZ rL �rolerK r- c C sf t �d|||f� || jvr,ttd�| ��| j�|i �}||v rZ|sZttd�||f ��|||< d S )Nz [app] adding role to domain: %rrk z.The %r role is already registered to domain %s)rM rN r2 r r$ r6 rl )rF rZ rL rn rK rc rG rG rH �add_role_to_domain� s
�z*SphinxComponentRegistry.add_role_to_domain)rZ �indexrK r- c C sh t �d||f� || jvr*ttd�| ��| j�|g �}||v rZ|sZttd�|j|f ��|�|� d S )Nz [app] adding index to domain: %rrk z/The %r index is already registered to domain %s) rM rN r2 r r$ r4 rl rL �append)rF rZ rp rK rd rG rG rH �add_index_to_domain� s
�z+SphinxComponentRegistry.add_index_to_domain� ) �
directivename�rolename�
indextemplate�
parse_node�
ref_nodeclass�objname�doc_field_typesrK r- c
C s� t �d|||||||f� t|ttf|t|�|d��} | �d|| � | �d|t|d�� | j �
di �}
||
v r�|s�t t d�| ��t
|p�||�|
|< d S )Nz [app] adding object type: %r)rv rw rz �std�Zinnernodeclassz(The %r object_type is already registered)rM rN �typer �object� staticmethodrm ro r% r5 rl r r$ r ) rF rt ru rv rw rx ry rz rK � directive� object_typesrG rG rH rg � s( ���� �z'SphinxComponentRegistry.add_object_type)rt ru rv rx ry rK r- c C s� t �d|||||f� t|ttfd|i�}| �d||� | �d|t|d�� | j� di �}||v rv|svt
t d�| ��t |p~||�||< d S )Nz [app] adding crossref type: %rrv r{ r| z*The %r crossref_type is already registered)
rM rN r} r r~ rm ro r% r5 rl r r$ r ) rF rt ru rv rx ry rK r� r� rG rG rH �add_crossref_type� s �� �z)SphinxComponentRegistry.add_crossref_type)�suffix�filetyperK r- c C s< t �d||� || jv r.|s.ttd�| ��n
|| j|< d S )Nz"[app] adding source_suffix: %r, %rz&source_suffix %r is already registered)rM rN rA r r$ )rF r� r� rK rG rG rH �add_source_suffix
s z)SphinxComponentRegistry.add_source_suffix)�parserrK r- c C sF t �d|� |jD ].}|| jv r6|s6ttd�| ��q|| j|< qd S )Nz%[app] adding search source_parser: %rz*source_parser for %r is already registered)rM rN Z supportedr? r r$ )rF r� rK r� rG rG rH �add_source_parser s
�z)SphinxComponentRegistry.add_source_parser)r� r- c
C sH z | j | W S tyB } z ttd�| �|�W Y d }~n
d }~0 0 d S )Nz#Source parser for %s not registered)r? rT r! r$ )rF r� rW rG rG rH �get_source_parser s z)SphinxComponentRegistry.get_source_parserc C s | j S r\ )r? rE rG rG rH �get_source_parsers" s z*SphinxComponentRegistry.get_source_parsers)rR �filenamer- c C s( | � |�}|� }t|t�r$|�|� |S r\ )r� �
isinstance� SphinxParserZset_application)rF rR r� � parser_classr� rG rG rH �create_source_parser% s
z,SphinxComponentRegistry.create_source_parserc C sX t �dt� z | j| W S tyR z| jd W Y S tyL Y Y d S 0 Y n0 d S )Nz9SphinxComponentRegistry.get_source_input() is deprecated.�*)�warnings�warnr r@ rT )rF r� rG rG rH �get_source_input, s � z(SphinxComponentRegistry.get_source_input)rL �
translatorrK r- c C s8 t �d|� || jv r*|s*ttd�| ��|| j|< d S )Nz.[app] Change of translator for the %s builder.z Translator for %r already exists)rM rN rB r r$ )rF rL r� rK rG rG rH �add_translator9 s z&SphinxComponentRegistry.add_translator)�node�kwargsr- c K s� t �d||� |�� D ]l\}}| j�|i �}z|\}}||f||j< W q ty� } z"ttd�||f �|�W Y d }~qd }~0 0 qd S )Nz)[app] adding translation_handlers: %r, %rzEkwargs for add_node() must be a (visit, depart) function tuple: %r=%r) rM rN rf rC rl �__name__�
ValueErrorr r$ ) rF r� r� Z builder_name�handlersrC �visit�departrW rG rG rH �add_translation_handlers@ s ���z0SphinxComponentRegistry.add_translation_handlers)rJ r- c C s | j �|j|j�S r\ )rB rb rL Zdefault_translator_class)rF rJ rG rG rH �get_translator_classN s
�z,SphinxComponentRegistry.get_translator_class)rJ �argsr- c G s� | � |�}||� }| j�|jd �}|d u r:| j�|ji �}|�� D ]<\}\}}t|d| t||�� |rBt|d| t||�� qB|S )NZvisit_Zdepart_)r� rC rb rL �formatrf �setattrr ) rF rJ r� Ztranslator_classr� r� rL r� r� rG rG rH �create_translatorR s
z)SphinxComponentRegistry.create_translator)� transformr- c C s t �d|� | j�|� d S )Nz[app] adding transform: %r)rM rN rD rq �rF r� rG rG rH �
add_transformd s z%SphinxComponentRegistry.add_transformc C s | j S r\ )rD rE rG rG rH �get_transformsh s z&SphinxComponentRegistry.get_transformsc C s t �d|� | j�|� d S )Nz [app] adding post transform: %r)rM rN r> rq r� rG rG rH �add_post_transformk s z*SphinxComponentRegistry.add_post_transformc C s | j S r\ )r> rE rG rG rH �get_post_transformso s z+SphinxComponentRegistry.get_post_transformsr+ )rh �
documenterr- c C s || j |< d S r\ )r0 )rF rh r� rG rG rH �add_documenterr s z&SphinxComponentRegistry.add_documenter)�typ�
attrgetterr- c C s || j |< d S r\ )r. )rF r� r� rG rG rH �add_autodoc_attrgetteru s z.SphinxComponentRegistry.add_autodoc_attrgetter)r� �
attributesr- c K s | j �||f� d S r\ )r1 rq �rF r� r� rG rG rH �
add_css_filesy s z%SphinxComponentRegistry.add_css_filesc K s" t �d||� | j�||f� d S )Nz [app] adding js_file: %r, %r)rM rN r; rq r� rG rG rH � add_js_file| s z#SphinxComponentRegistry.add_js_file)rL r- c s" | j | j }t� fdd�|D ��S )Nc s g | ]}|d � kr|�qS )r rG )�.0�x�rL rG rH �
<listcomp>� � z=SphinxComponentRegistry.has_latex_package.<locals>.<listcomp>)r< r= �bool)rF rL ZpackagesrG r� rH �has_latex_package� s z)SphinxComponentRegistry.has_latex_package)rL �options�after_hyperrefr- c C sN | � |�rt�d| � t�d|� |r:| j�||f� n| j�||f� d S )Nz#latex package '%s' already includedz [app] adding latex package: %r)r� rM r� rN r= rq r< )rF rL r� r� rG rG rH �add_latex_package� s
z)SphinxComponentRegistry.add_latex_package)r� �figtype� title_getterrK r- c C s@ t �d|||� || jv r.|s.ttd�| ��||f| j|< d S )Nz*[app] adding enumerable node: (%r, %r, %r)z%enumerable_node %r already registered)rM rN r7 r r$ )rF r� r� r� rK rG rG rH �add_enumerable_node� s z+SphinxComponentRegistry.add_enumerable_node)rL �inline_renderers�block_renderersr- c C sB t �d|||� || jv r*ttd�| ��|| j|< || j|< d S )Nz+[app] adding html_math_renderer: %s, %r, %rz&math renderer %s is already registered)rM rN r8 r r$ r9 )rF rL r� r� rG rG rH �add_html_math_renderer� s �
z.SphinxComponentRegistry.add_html_math_renderer)rL �
theme_pathr- c C s || j |< d S r\ )r: )rF rL r� rG rG rH �add_html_theme� s z&SphinxComponentRegistry.add_html_theme)rR �extnamer- c C s� ||j v rdS |tv r0t�td�|t| � dS td�| }t|���( z t|�}W nN ty� } z6t�td�t �
� � t td�| |�|�W Y d}~n
d}~0 0 t |dd�}|du r�t�td�|� i }nJz ||�}W n< t
�y } z"t
td�||f �|�W Y d}~n
d}~0 0 |du �r(i }n t|t��sHt�td �|� i }t||fi |��|j |< W d � n1 �sv0 Y dS )
zLoad a Sphinx extension.Nz\the extension %r was already merged with Sphinx since version %s; this extension is ignored.z while setting up extension %s:zOriginal exception:
z Could not import extension %s�setupzMextension %r has no setup() function; is it really a Sphinx extension module?zpThe %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.zuextension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary)�
extensions�EXTENSION_BLACKLISTrM Zwarningr$ r' r � ImportError�verbose� traceback�
format_excr �getattrr" r� �dictr# )rF rR r� �prefix�mod�errr� �metadatarG rG rH rU � sT
� ��
� ���
�z&SphinxComponentRegistry.load_extension�rR r- c C s, ddl m} dd� |j�� D �}||d< |S )Nr )� ENV_VERSIONc S s& i | ] }|j �d �r|j|j d �qS )Z env_version)r� rb rL )r� �extrG rG rH �
<dictcomp>� s �z:SphinxComponentRegistry.get_envversion.<locals>.<dictcomp>Zsphinx)�sphinx.environmentr� r� r_ )rF rR r� Z
envversionrG rG rH �get_envversion� s z&SphinxComponentRegistry.get_envversion)F)F)F)F)F)rs Nrs F)F)F)F)F)NF)Cr� rP � __qualname__rI r r r� rQ �strrX rY r r[ r] r r ri r rm r
r( r% ro r rr r r r rg r� r� r r� r� r r� r� r
r r� r Z NodeVisitorr� r r r� r� r r� r r� r� r� r� r� r� r� r� r� r� r r) r� r� r� rU r� rG rG rG rH r, : s� M �
�
� �
�
� �� �� � � � � �
�
� .r, r* )rR �configr- c C s\ | j j�� D ]>\}}|| jjvr.|| jj|< q | jj| du r || jj|< q | jj| j _dS )zDMerge any user-specified source_suffix with any added by extensions.N)�registryrA rf r� )rR r� r� r� rG rG rH �merge_source_suffix� s r� r� c C s | j dtdd� dddd�S )Nz
config-initedi )�priorityZbuiltinT)�versionZparallel_read_safeZparallel_write_safe)Zconnectr� )rR rG rG rH r� � s
�r� )R�__doc__r� r� � importlibr �typesr �typingr r r r r r r
r r r
Zdocutilsr Z docutils.ior Zdocutils.nodesr r r Zdocutils.parsersr Zdocutils.parsers.rstr Zdocutils.transformsr Zimportlib_metadatar r� �importlib.metadataZsphinx.buildersr Z
sphinx.configr Zsphinx.deprecationr Zsphinx.domainsr r r Zsphinx.domains.stdr r r� r Z
sphinx.errorsr r! r" Zsphinx.extensionr# Z
sphinx.localer$ Zsphinx.parsersr� Z sphinx.rolesr% Z sphinx.utilr& Zsphinx.util.loggingr' Zsphinx.util.typingr( r) Zsphinx.applicationr* Zsphinx.ext.autodocr+ Z getLoggerr� rM r� r, r� r� r� rG rG rG rH �<module> sR
0
� "