| 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�� � @ sT d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dl mZ d dl m
Z
m Z m Z m
Z
mZmZmZmZmZmZ d dlmZ d dlmZmZ d dlmZ d d lm Z m Z d d
l m Z d d l m!Z! d dl"Z"d d l"m#Z#m$Z$ d d
l%m&Z& d dl'm(Z( d dl)m*Z*m+Z+ d dl,m-Z- d dl.m/Z/ d dl0m1Z1m2Z2m3Z3 d dl4m5Z5 d dl6m7Z7 d dl8m9Z9 d dl:m;Z; d dl<m=Z= d dl>m?Z? d dl@mAZA d dlBmCZC d dlDmZmEZEmFZF d d lGmHZH d d lImJZJ d d lKmLZL d d lMmNZN d d lOmPZPmQZQmRZR d d!lSmTZT d d"lUmVZVmWZW e �r"d d#lmXZX d d$lYmZZZ d%Z[d&Z\eE�]e^�Z_G d'd(� d(�Z`G d)d*� d*�ZadS )+� N)�deque)�StringIO)�path)
�IO�
TYPE_CHECKING�Any�Callable�Dict�List�Optional�Tuple�Type�Union)�nodes)�Element� TextElement)�Parser)� Directive�roles)� Transform)�Lexer)�locale� package_dir)�Config)�RemovedInSphinx60Warning)�Domain�Index)�BuildEnvironment)�EnvironmentCollector)�ApplicationError� ConfigError�VersionRequirementError)� EventManager)� Extension)�
lexer_classes)�__)�Project)�SphinxComponentRegistry)�XRefRole)�Theme)�docutils�logging�progress_message)�
BuildPhase)�bold)�CatalogRepository)�prefixed_warnings)�abspath� ensuredir�relpath)�Tags)� RoleFunction� TitleGetter)�Node)�Builder)5zsphinx.addnodeszsphinx.builders.changeszsphinx.builders.epub3zsphinx.builders.dirhtmlzsphinx.builders.dummyzsphinx.builders.gettextzsphinx.builders.htmlzsphinx.builders.latexzsphinx.builders.linkcheckzsphinx.builders.manpagezsphinx.builders.singlehtmlzsphinx.builders.texinfozsphinx.builders.textzsphinx.builders.xmlz
sphinx.configzsphinx.domains.czsphinx.domains.changesetzsphinx.domains.citationzsphinx.domains.cppzsphinx.domains.indexzsphinx.domains.javascriptzsphinx.domains.mathzsphinx.domains.pythonzsphinx.domains.rstzsphinx.domains.stdzsphinx.directiveszsphinx.directives.codezsphinx.directives.otherzsphinx.directives.patcheszsphinx.extensionzsphinx.parserszsphinx.registryz sphinx.roleszsphinx.transformsz%sphinx.transforms.compact_bullet_listzsphinx.transforms.i18nz sphinx.transforms.referencesz!sphinx.transforms.post_transformsz&sphinx.transforms.post_transforms.codez(sphinx.transforms.post_transforms.imageszsphinx.util.compatzsphinx.versioningz*sphinx.environment.collectors.dependenciesz#sphinx.environment.collectors.assetz&sphinx.environment.collectors.metadataz#sphinx.environment.collectors.titlez%sphinx.environment.collectors.toctreezsphinxcontrib.applehelpzsphinxcontrib.devhelpzsphinxcontrib.htmlhelpz sphinxcontrib.serializinghtmlzsphinxcontrib.qthelpZ alabasterzenvironment.picklec @ s� e Zd ZU eed< eed< dejejddddddf e e
e e e e e e e eee
e eeedd�dd�Zdd �d
d �Zedd �d
d�Ze dd�dd�Ze dd�dd�Zdd �dd�Zd�ee
e dd�dd�Ze dd�dd �Ze dd �d d �Zd�e eeed!�d"d#�Zedd$�d%d&�Zd'd(�e eee e d)f e
d*�d+d,�Z d'd(�e eee e d)f ed*�d-d.�Z d�e d edd/�d0d1�Z d�e ee!ee f edd2�d3d4�Z"e dd�d5d6�Z#d�e e e$j% edd7�d8d9�Z&d�e e' eeee
e f dd:�d;d<�Z(d�e e' e e)eeeef dd=�d>d?�Z*d�e e e+ edd@�dAdB�Z,d�e eeddC�dDdE�Z-d�e eeddF�dGdH�Z.d�e e/ eddI�dJdK�Z0d�e e e e+ eddL�dMdN�Z1d�e e e!e2e3f eddO�dPdQ�Z4d�e e e5 eddR�dSdT�Z6dUdddUg dfe e e ee e7 e e
eddV� dWdX�Z8d�e e e e e7 e eddY�dZd[�Z9e e: dd\�d]d^�Z;e e: dd\�d_d`�Z<d�e ee
e edda�dbdc�Z=d�e eeddd�dedf�Z>d�e ee ddg�dhdi�Z?d�e e eddj�dkdl�Z@e e eA ddm�dndo�ZBd�eeddp�dqdr�ZCe eee egef dds�dtdu�ZDeddv�dwdx�ZEd�e e eddy�dzd{�ZFd�e eG edd|�d}d~�ZHe eI dd�d�d��ZJe e dd��d�d��ZKd�e eeef eeef dd��d�d��ZLe e dd��d�d��ZMe ed��d�d��ZNd�d�� ZOePe e e f d �d�d���ZQdS )��Sphinx�warningiserror�
_warncountNFr )�srcdir�confdir�outdir�
doctreedir� buildername�
confoverrides�status�warning�freshenvr: �tags� verbosity�parallel�
keep_going�returnc C s t j| _| | _i | _d | _d | _d | _t� | _ t
|�| _ t
|�| _ t
|�| _
t�| j �sjttd�| j ��t�| j �r�t�| j �s�ttd�| j ��| j | j kr�ttd���|
| _|d u r�t� | _d| _n || _d| _|d u r�t� | _n|| _d| _|
o�|| _| j�rd| _n|
| _t� | | j| j� t | �| _ t dd�| _ t!�"t#td �t$j% �� d| _&t'| �| _(|d u �r�| j | _)t*i |�p�i �| _+n$t
|�| _)t*�,| j)|�p�i | j(�| _+| j+�-� | �.� | j+j/�r�| j+j/t$j%k�r�t0td
�| j+j/ ��t1D ]}| �2|� �q�| j+jD ]}| �2|� �q | �3|� t�|��sjt4td ��� t5|� W d � n1 �s`0 Y | j+j �r�td �d
}t6|��8 t7| j+j ��r�| j+� | � n t8td���W d � n1 �s�0 Y | j+�9� | j �:d| j+� t;| j | j+j<�| _| �=|�| _| �>| � | �?� d S )Nz!Cannot find source directory (%s)z(Output directory (%s) is not a directoryz>Source directory and destination directory cannot be identicalTFr �
)�maxlenzRunning Sphinx v%szWThis project needs at least Sphinx v%s and therefore cannot be built with this version.zmaking output directoryz while setting up extension %s:zconf.pyz�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.z
config-inited)@r- ZINITIALIZATION�phaserF �
extensions�builder�env�projectr' �registryr1 r< r> r? r �isdirr r% �existsrG r Z_status�quietZ_warningr; rH r: r+ �setupr" �eventsr Z
messagelog�logger�infor. �sphinx�__display_version__�
statuscoder4 rE r= r �config�readZpre_init_values�
_init_i18nZ needs_sphinxr! �builtin_extensions�setup_extension�preload_builderr, r2 r0 �callabler Z init_values�emitr& Z
source_suffix�create_builder� _init_env�
_init_builder)�selfr< r= r> r? r@ rA rB rC rD r: rE rF rG rH � extension�prefix� rj �6/usr/lib/python3.9/site-packages/sphinx/application.py�__init__� s�
��
��
(
�$
zSphinx.__init__�rI c C s� | j jd u r t�g d �\| _}n�tjttd�| j j �dd� t | j
| j j | j j| j j �}|j
D ]*}|jdkr`|�� r`|�| j j| j j� q`t|j �}|d g7 }|t�td�g7 }t�|| j j�\| _}|s�| j jdkr�t�td�� nt�td�� d S ) Nz loading translations [%s]... T)ZnonlrY r �enZdonez#not available for built-in messages)r\ �languager �initZ
translatorrW rX r. r% r/ r< � locale_dirsZsource_encodingZcatalogs�domainZ is_outdatedZwrite_moZ gettext_allow_fuzzy_translations�listr �joinr )rg Zhas_translationZrepo�catalogrq rj rj rk r^ s( � �
�
zSphinx._init_i18n)rD rI c
C s� t �| jt�}|s tj �|�s<t| �| _| j�| j | j
� n�zrt t d���R t
|d��(}t�|�| _| j�| � W d � n1 s�0 Y W d � n1 s�0 Y W n@ ty� } z(t�t d�|� | jdd� W Y d }~n
d }~0 0 d S )Nzloading pickled environment�rbz
failed: %sT)rD )r rt r? �ENV_PICKLE_FILENAME�osrS r rO Z
find_filesr\ rN r, r% �open�pickle�loadrU � ExceptionrW rX re )rg rD �filename�f�errrj rj rk re & s
LzSphinx._init_env)�namerI c C s | j �| |� d S �N)rQ ra �rg r� rj rj rk ra 5 s zSphinx.preload_builderr8 c C s( |d u rt �td�� d}| j�| |�S )Nz(No builder selected, using default: htmlZhtml)rW rX r% rQ rd r� rj rj rk rd 8 s zSphinx.create_builderc C s( | j �| j� | j �� | j�d� d S )Nzbuilder-inited)rN Zset_environmentrO rp rV rc �rg rj rj rk rf ? s
zSphinx._init_builder)� force_all� filenamesrI c
C s� t j| _�z4|r&| j�� | j�� n2|rD| j�|� | j�|� n| j�� | j� � | j
rj| j rjd| _ | j dkr|t
d�nt
d�}| j
r�| jr�| j
dkr�t
d�}q�t
d�}n | j
dkr�t
d�}nt
d�}t�t||| j
f �� nt�tt
d �| �� | j dk�r<| jj�r<t�d
� t�| jjt| j�| jjd � � W nZ t�y� } z@t�| jt�}t� |��rtt � |� | j � d |� � W Y d }~nd }~0 0 | j � d d � | j�!� d S )
N� r Z succeededzfinished with problemsz7build %s, %s warning (with warnings treated as errors).z8build %s, %s warnings (with warnings treated as errors).zbuild %s, %s warning.zbuild %s, %s warnings.z build %s.� )r> rP zbuild-finished)"r- ZREADINGrL rN Zcompile_all_catalogsZ build_allZcompile_specific_catalogsZbuild_specificZcompile_update_catalogsZ build_updater; rH r[ r% r: rW rX r. �epilogr3 r> r\ rP r| r rt r? rw �isfilerx �unlinkrV rc Zcleanup)rg r� r� rB �msgr Zenvfilerj rj rk �buildF sN
�
�
z Sphinx.build)�extnamerI c C s t �d|� | j�| |� d S )Nz [app] setting up extension: %r)rW �debugrQ Zload_extension)rg r� rj rj rk r` { s zSphinx.setup_extension)�versionrI c C s |t jd d� krt|��d S )N� )rY rZ r! )rg r� rj rj rk �require_sphinx� s
zSphinx.require_sphinx�� )�event�callback�priorityrI c C s& | j �|||�}t�d||||� |S )Nz*[app] connecting event %r (%d): %r [id=%s])rV �connectrW r� )rg r� r� r� � listener_idrj rj rk r� � s
�zSphinx.connect)r� rI c C s t �d|� | j�|� d S )Nz"[app] disconnecting event: [id=%s])rW r� rV �
disconnect)rg r� rj rj rk r� � s zSphinx.disconnectrj )�allowed_exceptions.)r� �argsr� rI c G s | j j|g|�R d|i�S �Nr� )rV rc �rg r� r� r� rj rj rk rc � s z Sphinx.emitc G s | j j|g|�R d|i�S r� )rV �emit_firstresultr� rj rj rk r� � s �zSphinx.emit_firstresult)rN �overriderI c C s | j j||d� d S �N�r� )rQ � add_builder)rg rN r� rj rj rk r� � s
zSphinx.add_builder)r� �default�rebuild�typesrI c C s> t �d||||f� |dv r(|r$dnd}| j�||||� d S )Nz [app] adding config value: %r)FTrO r� )rW r� r\ �add)rg r� r� r� r� rj rj rk �add_config_value� s " zSphinx.add_config_valuec C s t �d|� | j�|� d S )Nz[app] adding event: %r)rW r� rV r� r� rj rj rk � add_event s zSphinx.add_event)r� �translator_classr� rI c C s | j j|||d� d S r� )rQ Zadd_translator)rg r� r� r� rj rj rk �set_translator s zSphinx.set_translator)�noder� �kwargsrI c K sX t �d||f� |s6t�|�r6t jtd�|jddd� t�|� | jj |fi |�� d S )Nz[app] adding node: %rzDnode class %r is already registered, its visitors will be overridden�app�add_node��typeZsubtype)
rW r� r* Zis_node_registeredrC r% �__name__Z
register_noderQ Zadd_translation_handlers)rg r� r� r� rj rj rk r� & s $
�
zSphinx.add_node)r� �figtype� title_getterr� r� rI c K s. | j j||||d� | j|fd|i|�� d S )Nr� r� )rQ �add_enumerable_noder� )rg r� r� r� r� r� rj rj rk r� R s zSphinx.add_enumerable_node)r� �clsr� rI c C sD t �d||f� |s4t�|�r4t jtd�|ddd� t�||� d S )Nz[app] adding directive: %rz9directive %r is already registered, it will be overriddenr� �
add_directiver� )rW r� r* Zis_directive_registeredrC r% Zregister_directive)rg r� r� r� rj rj rk r� o s )
�zSphinx.add_directive)r� �roler� rI c C sD t �d||f� |s4t�|�r4t jtd�|ddd� t�||� d S )Nz[app] adding role: %r�4role %r is already registered, it will be overriddenr� �add_roler� )rW r� r* �is_role_registeredrC r% �
register_role)rg r� r� r� rj rj rk r� � s
�zSphinx.add_role)r� � nodeclassr� rI c C sP t �d||f� |s4t�|�r4t jtd�|ddd� t�||�}t�||� d S )Nz [app] adding generic role: %rr� r� �add_generic_roler� ) rW r� r* r� rC r% r Z GenericRoler� )rg r� r� r� r� rj rj rk r� � s
� zSphinx.add_generic_role)rr r� rI c C s | j j||d� d S r� )rQ �
add_domain)rg rr r� rj rj rk r� � s zSphinx.add_domain)rr r� r� r� rI c C s | j j||||d� d S r� )rQ �add_directive_to_domain)rg rr r� r� r� rj rj rk r� � s z Sphinx.add_directive_to_domain)rr r� r� r� rI c C s | j j||||d� d S r� )rQ �add_role_to_domain)rg rr r� r� r� rj rj rk r� � s zSphinx.add_role_to_domain)rr �indexr� rI c C s | j �||� d S r� )rQ �add_index_to_domain)rg rr r� r� rj rj rk r� � s zSphinx.add_index_to_domainr� ) �
directivename�rolename�
indextemplate�
parse_node�
ref_nodeclass�objname�doc_field_typesr� rI c
C s | j j||||||||d� d S r� )rQ �add_object_type) rg r� r� r� r� r� r� r� r� rj rj rk r�
s ?�zSphinx.add_object_type)r� r� r� r� r� r� rI c C s | j j||||||d� d S r� )rQ �add_crossref_type)rg r� r� r� r� r� r� rj rj rk r� P s #
�zSphinx.add_crossref_type)� transformrI c C s | j �|� d S r� )rQ �
add_transform�rg r� rj rj rk r� w s !zSphinx.add_transformc C s | j �|� d S r� )rQ �add_post_transformr� rj rj rk r� � s zSphinx.add_post_transform)r} r� �loading_methodr� rI c K sb |dkrd|d< n|dkr"d|d< | j j|fd|i|�� t| jd�r^| jj|fd|i|�� d S )N�asyncZdeferr� � add_js_file)rQ r� �hasattrrN )rg r} r� r� r� rj rj rk r� � s 9
zSphinx.add_js_file)r} r� r� rI c K sL t �d|� | jj|fd|i|�� t| jd�rH| jj|fd|i|�� d S )Nz[app] adding stylesheet: %rr� � add_css_file)rW r� rQ Z
add_css_filesr� rN r� )rg r} r� r� rj rj rk r� � s 8 zSphinx.add_css_file)r} � alternate�titlerI c C sF t �d� i }|r d|d< nd|d< |r0||d< | j|fi |�� d S )NzNThe app.add_stylesheet() is deprecated. Please use app.add_css_file() instead.zalternate stylesheet�relZ
stylesheetr� )rW rC r� )rg r} r� r� Z
attributesrj rj rk �add_stylesheet$ s
zSphinx.add_stylesheet)� packagename�options�after_hyperrefrI c C s | j �|||� d S r� )rQ �add_latex_package)rg r� r� r� rj rj rk r� 8 s zSphinx.add_latex_package)�alias�lexerrI c C s t �d||f� |t|< d S )Nz[app] adding lexer: %r)rW r� r$ )rg r� r� rj rj rk � add_lexerO s
zSphinx.add_lexer)r� r� rI c C sB t �d|� ddlm} | j�|j|� | jd|j ||d� d S )Nz [app] adding autodocumenter: %rr )�AutodocDirective�autor� )rW r� Z sphinx.ext.autodoc.directiver� rQ Zadd_documenterZobjtyper� )rg r� r� r� rj rj rk �add_autodocumenter\ s zSphinx.add_autodocumenter)�typ�getterrI c C s" t �d||f� | j�||� d S )Nz#[app] adding autodoc attrgetter: %r)rW r� rQ �add_autodoc_attrgetter)rg r� r� rj rj rk r� s s z Sphinx.add_autodoc_attrgetter)r� rI c C s* t �d|� ddlm}m} |||j< d S )Nz [app] adding search language: %rr )�SearchLanguage� languages)rW r� Z
sphinx.searchr� r� �lang)rg r� r� r� rj rj rk �add_search_language� s zSphinx.add_search_language)�suffix�filetyper� rI c C s | j j|||d� d S r� )rQ �add_source_suffix)rg r� r� r� rj rj rk r� � s zSphinx.add_source_suffix)�parserr� rI c C s | j j||d� d S r� )rQ �add_source_parser)rg r� r� rj rj rk r� � s
zSphinx.add_source_parser)� collectorrI c C s t �d|� |� �| � d S )Nz&[app] adding environment collector: %r)rW r� Zenable)rg r� rj rj rk �add_env_collector� s zSphinx.add_env_collector)r� �
theme_pathrI c C s t �d||� | j�||� d S )Nz [app] adding HTML theme: %r, %r)rW r� rQ �add_html_theme)rg r� r� rj rj rk r� � s zSphinx.add_html_theme)r� �inline_renderers�block_renderersrI c C s | j �|||� d S r� )rQ �add_html_math_renderer)rg r� r� r� rj rj rk r� � s z Sphinx.add_html_math_renderer)ru �
locale_dirrI c C s$ t �|g| jj|� t �||� d S r� )r rp r\ ro Z init_console)rg ru r� rj rj rk �add_message_catalog� s
zSphinx.add_message_catalog)r� rI c C s� |dkr d}t d�}t d�}n*|dkr<d}t d�}t d�}n td | ��| j�� D ]d}t||d �}|d u r�t�||j� t�t d
�|� d S |sRt�||j� t�t d
�|� d S qRd S )
Nr] Zparallel_read_safez�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicitz1the %s extension is not safe for parallel reading�writeZparallel_write_safez�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicitz1the %s extension is not safe for parallel writingz!parallel type %s is not supportedzdoing serial %sFT)r% �
ValueErrorrM �values�getattrrW rC r� )rg r� �attrnameZmessage_not_declaredZmessage_not_safe�ext�allowedrj rj rk �is_parallel_allowed� s(
zSphinx.is_parallel_allowedc C s |dvrt d| ��|| j_d S )N)�alwaysZper_pagezpolicy %s is not supported)r� rQ Zhtml_assets_policy)rg Zpolicyrj rj rk �set_html_assets_policy s z Sphinx.set_html_assets_policyc C s t �dt� | jjS )Nz app.html_themes is deprecated.)�warnings�warnr rQ � html_themesr� rj rj rk r s �zSphinx.html_themes)FN)r� )F)rj )F)F)NF)F)F)F)F)F)F)F)r� Nr� F)r� N)r� )FN)NF)F)F)F)NN)Rr� �
__module__� __qualname__�bool�__annotations__�int�sys�stdout�stderr�strr r r r
rl r^ re ra rd rf r� r` r� r r� r� r r r
r| rc r� r� r r� r� r Z NodeVisitorr� r r� r6 r� r r� r� r� r r� r� r5 r( r� r r� r r� r� r r� r� r� r� r� r� r r� r� r� r� r� r r� r r� r� r� r� r� r �propertyr rj rj rj rk r9 } s�
�
� 5
�� �� �� ' � �
� - �
� 0 �
� �� � �� C �� '# �
� B=� ��
�
�
� # r9 c @ sX e Zd Zddeee dd�dd�Zed�dd�Zee dd �d
d �Z
ee ed �d d
�Z dS )�TemplateBridgeNr8 )rN �theme�dirsrI c C s t d��d S �Nz!must be implemented in subclasses��NotImplementedError)rg rN r r rj rj rk rp s zTemplateBridge.initrm c C s dS )Nr rj r� rj rj rk �newest_template_mtime( s z$TemplateBridge.newest_template_mtime)�template�contextrI c C s t d��d S r r �rg r r rj rj rk �render/ s zTemplateBridge.renderc C s t d��d S r r r rj rj rk �
render_string5 s z TemplateBridge.render_string)NN) r� r r r) r
r rp �floatr r r r rj rj rj rk r s r )brx rz r r � collectionsr �ior r �typingr r r r r r
r r r
r r* r Zdocutils.nodesr r Zdocutils.parsersr Zdocutils.parsers.rstr r Zdocutils.transformsr Zpygments.lexerr rY r r Z
sphinx.configr Zsphinx.deprecationr Zsphinx.domainsr r Zsphinx.environmentr Z sphinx.environment.collectorsr Z
sphinx.errorsr r r! Z
sphinx.eventsr" Zsphinx.extensionr# Zsphinx.highlightingr$ Z
sphinx.localer% Zsphinx.projectr& Zsphinx.registryr' Z sphinx.rolesr( Zsphinx.themingr) Z sphinx.utilr+ r, Zsphinx.util.build_phaser- Zsphinx.util.consoler. Zsphinx.util.i18nr/ Zsphinx.util.loggingr0 Zsphinx.util.osutilr1 r2 r3 Zsphinx.util.tagsr4 Zsphinx.util.typingr5 r6 r7 Zsphinx.buildersr8 r_ rw Z getLoggerr� rW r9 r rj rj rj rk �<module>
sl 0 <
#