| 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%Q � @ s d Z ddlZddlZddlZddlmZ ddlmZmZ ddl m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZ ddlmZmZ ddlmZmZ ddl m Z dd l m Z dd
l m!Z!m"Z" dd l#m$Z$ dd l%m&Z& e
r�dd
l'm(Z( ddl)m*Z* e �+e,�Z-dZ.e/ej0ej1fZ2e�3d�Z4G dd� de�Z5e e6d�dd�Z7G dd� d�Z8G dd� d�Z9e:ee$ e
e:e f d�dd �Z;d e9dd �d d �Z<d e9dd �d!d"�Z=d e9dd �d#d$�Z>d e9dd �d%d&�Z?d e9dd �d'd(�Z@d e9dd �d)d*�ZAd d+ee: ee: ee: ee: d,�d-d.�ZBd e
e:e f d/�d0d1�ZCdS )2z�
sphinx.config
~~~~~~~~~~~~~
Build configuration file handling.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)� OrderedDict)�getenv�path) �
TYPE_CHECKING�Any�Callable�Dict� Generator�Iterator�List�
NamedTuple�Optional�Set�Tuple�Union)� ConfigError�ExtensionError)�_�__)�logging)� format_date)�cd� fs_encoding)�Tags)�NoneType)�Sphinx)�BuildEnvironmentzconf.pyz^((\d{4}-)?)(\d{4})(?=[ ,])c @ s. e Zd ZU eed< eed< eeef ed< dS )� ConfigValue�name�value�rebuildN)�__name__�
__module__� __qualname__�str�__annotations__r r �bool� r' r' �1/usr/lib/python3.9/site-packages/sphinx/config.pyr & s
r )�obj�returnc C sh t | t�rdS t | t�rB| �� D ] \}}t|�r8t|�s dS q n"t | tttf�rdtdd� | D ��S dS )z'Check if object is serializable or not.Fc s s | ]}t |�V qd S �N)�is_serializable)�.0�ir' r' r( � <genexpr>5 � z"is_serializable.<locals>.<genexpr>T) �
isinstance�UNSERIALIZABLE_TYPES�dict�itemsr, �list�tuple�set�all)r) �keyr r' r' r( r, , s
r, c @ s: e Zd ZdZedd�dd�Zeeeef e d�dd�Z
dS ) �ENUMz�Represents the candidates which a config value should be one of.
Example:
app.add_config_value('latex_show_urls', 'no', None, ENUM('no', 'footnote', 'inline'))
N)�
candidatesr* c G s
|| _ d S r+ �r; )�selfr; r' r' r( �__init__@ s z
ENUM.__init__)r r* c s2 t |ttf�r$t� fdd�|D ��S |� jv S d S )Nc 3 s | ]}|� j v V qd S r+ r< )r- �item�r= r' r( r/ E r0 z ENUM.match.<locals>.<genexpr>)r1 r5 r6 r8 r; )r= r r' r@ r( �matchC s z
ENUM.match) r! r" r# �__doc__r$ r> r r r r& rA r' r' r' r( r: : s r: c 6 @ sB e Zd ZU dZddg fddg fddegfdd� degfddg fddg fddg fd degfd degfd
gdg fd degfd d
g fddg fdd� dg fddidefddg fg dg fd degfddg fddg fd dg fd dg fd degfddg fi dg fg dg fd degfd dg fg dg fg dg fd degfd degfddg fddegfd d egfi d g fd dg fd d g fg d g fg d g fd dg fddg fi dg fd dg fd degfddg fddg fd dg fd degfddg fddg fdgddgd�dg fd �4Zeee f e
d < i i feeef eeef d d �d d �Z e dFeee
d d!�d"d#��Zeeed$�d%d&�Zd d'�d(d)�Zd d'�d*d+�Zd d'�d,d-�Zeed.�d/d0�Zeed.�d1d2�Zeed d$�d3d4�Zed d.�d5d6�Zeed.�d7d8�Zeed d f d'�d9d:�Zeee eef ed d;�d<d=�Z e ee e f e e d>�d?d@�Z ed'�dAdB�Z!ed dC�dDdE�Z"d S )G�Configa� Configuration file abstraction.
The config object makes the values of all config values available as
attributes.
It is exposed via the :py:attr:`sphinx.application.Application.config` and
:py:attr:`sphinx.environment.Environment.config` attributes. For example,
to get the value of :confval:`language`, use either ``app.config.language``
or ``env.config.language``.
�Python�env�unknown� Zhtmlc C s | j S r+ )�project_copyright)�cr' r' r( �<lambda>` r0 zConfig.<lambda>NZlocalesz{root}.{language}{ext}F�gettext�indexc C s | j S r+ )�
master_doc)�configr' r' r( rJ m r0 z.rstZrestructuredtextz utf-8-sigT�default�py� ZqDe�jaZman�text)� languagesZbuilders)4�projectZauthorrH � copyright�version�releaseZtodayZ today_fmt�language� locale_dirsZfigure_language_filenameZ gettext_allow_fuzzy_translationsrM �root_doc�
source_suffixZsource_encodingZexclude_patternsZ default_roleZadd_function_parenthesesZadd_module_namesZ trim_footnote_reference_spaceZ show_authorsZpygments_style�highlight_language�highlight_optionsZtemplates_pathZtemplate_bridgeZ
keep_warnings�suppress_warningsZmodindex_common_prefixZ
rst_epilogZ
rst_prologZtrim_doctest_flags�primary_domain� needs_sphinxZneeds_extensionsZ manpages_urlZnitpickyZnitpick_ignoreZnitpick_ignore_regexZnumfigZnumfig_secnum_depth�
numfig_formatZmath_number_allZmath_eqref_formatZ math_numfigZ
tls_verifyZ tls_cacertsZ
user_agentZ smartquotesZsmartquotes_actionZsmartquotes_excludes�
config_values)rN � overridesr* c C s~ t |�| _tj�� | _|| _|�dd �| _d| jv rlt | jd t
�r\| j� d�� d�|d< n| j� d�|d< |�dg �| _
d S )N�setup�
extensions�,)r3 rd rC rc �copy�values� _raw_config�getre r1 r$ �pop�splitrf )r= rN rd r' r' r( r> � s
zConfig.__init__)�confdirrd �tagsr* c C s> t �|t�}t �|�s&ttd�| ��t||�}| ||p:i �S )z/Create a Config object from configuration file.z4config directory doesn't contain a conf.py file (%s))r �join�CONFIG_FILENAME�isfiler r �eval_config_file)�clsrn rd ro �filename� namespacer' r' r( �read� s
�
z Config.read)r r r* c
C sj t |t�s|S | j| d }| j| d tkr2|S | j| d tthkrh|dkrTdS |dkr`dS |S � n�t|�tu s�| j| d tgkr�|dkr�dS t|�S n�t |t�r�ttd�||d f ��n�t |t �r�|�
d �S t |t ��r,z
t |�W S t�y( } z"ttd
�||f �|�W Y d }~n
d }~0 0 n:t |��r:|S |d u�rbt |t��sbttd �| ��n|S d S ) Nr � �0F�1TzZcannot override dictionary config setting %r, ignoring (use %r to set individual elements)z
.key=valuerg z/invalid number %r for config value %r, ignoringzAcannot override config setting %r with unsupported type, ignoring)
r1 r$ ri r r& �typer3 �
ValueErrorr r5 rm �int�callable)r= r r Zdefvalue�excr' r' r( �convert_overrides� sJ
�
��
�zConfig.convert_overrides)r* c C s� g d�}|D ]x}zB|| j v r6| �|| j | �| j|< n|| jv rP| j| | j|< W q ty� } zt�d|� W Y d}~q d}~0 0 q dS )zs
Initialize some limited config variables before initializing i18n and loading
extensions.
)ra r_ rY rZ �%sN)rd r� �__dict__rj r| �logger�warning)r= Z variablesr r r' r' r( �pre_init_values� s
zConfig.pre_init_valuesc C s� | j }| j�� D ]�\}}ztd|v rH|�dd�\}}||�|i �|< W qn || jvrft�td�|� W qt |t
�r�| � ||�||< n|||< W q t y� } zt�d|� W Y d }~qd }~0 0 q|D ] }|| jv r�|| | j
|< q�d S )N�.rQ z-unknown config value %r in override, ignoringr� )rj rd r4 rm �
setdefaultri r� r� r r1 r$ r� r| r� )r= rN Zvalnamer Z realvalnamer9 r r r' r' r( � init_values� s(
�
$
zConfig.init_valuesc C s@ | j }|D ]&}|| jvr
|| jv r
|| | j|< q
td| � dS )zc
Initialize additional config variables that are added after init_values() called.
N)rj r� ri �check_confval_types)r= rN r r' r' r( �post_init_values� s
zConfig.post_init_values)r r* c C sN |� d�rt|��|| jvr,ttd�| ��| j| d }t|�rJ|| �S |S )Nr zNo such config value: %sr )�
startswith�AttributeErrorri r r~ )r= r rO r' r' r( � __getattr__ s
zConfig.__getattr__c C s
t | |�S r+ )�getattr�r= r r' r' r( � __getitem__ s zConfig.__getitem__c C s t | ||� d S r+ )�setattr�r= r r r' r' r( � __setitem__ s zConfig.__setitem__c C s t | |� d S r+ )�delattrr� r' r' r( � __delitem__ s zConfig.__delitem__c C s
|| j v S r+ )ri r� r' r' r( � __contains__ s zConfig.__contains__c c s0 | j �� D ] \}}t|t| |�|d �V q
d S )NrQ )ri r4 r r� r� r' r' r( �__iter__ s zConfig.__iter__)r rO r �typesr* c C s0 || j v r ttd�| ��n|||f| j |< d S )Nz Config value %r already present)ri r r )r= r rO r r� r' r' r( �add# s
z
Config.add)r r* c s" t � t�r� g� � fdd�| D �S )Nc 3 s | ]}|j � v r|V qd S r+ �r )r- r r� r' r( r/ , r0 z Config.filter.<locals>.<genexpr>)r1 r$ )r= r r' r� r( �filter) s
z
Config.filterc C s� i }| j �� D ]$\}}|�d�s2t|�s*q|||< qi |d< | j�� D ]4\}}t| |�}t|�sdd}||d df|d |< qF|S )z'Obtains serializable data for pickling.r ri NrQ )r� r4 r� r, ri r� )r= r� r9 r Z
real_valuer' r' r( � __getstate__. s
zConfig.__getstate__)�stater* c C s | j �|� d S r+ )r� �update)r= r� r' r' r( � __setstate__E s zConfig.__setstate__)NN)#r! r" r# rB r$ r r rc r r r% r> � classmethodr rw r� r� r� r� r� r� r� r� r& r� r r r� r r� r r
r� r� r� r' r' r' r( rC J s�
���>(
)
rC )ru ro r* c C sX i }| |d< ||d< t t�| ���� zNt| d��0}t|�� | �t�d�}t||� W d � n1 sh0 Y W n� t y� } z"t
d�}t || �|�W Y d}~n�d}~0 t y� } z t
d�}t |�|�W Y d}~nZd}~0 t y� � Y n@ t
�y2 } z&t
d�}t |t�� �|�W Y d}~n
d}~0 0 W d � n1 �sJ0 Y |S ) zEvaluate a config file.�__file__ro �rb�execNz7There is a syntax error in your configuration file: %s
zKThe configuration file (or one of the modules it imports) called sys.exit()z=There is a programmable error in your configuration file:
%s)r r �dirname�open�compilerw �encoder r� � SyntaxErrorr r �
SystemExit� Exception� traceback�
format_exc)ru ro rv �f�code�err�msgr r' r' r( rs I s( ," Hrs r )�apprN r* c C sr |j }t|t�r t|di�|_ nNt|ttf�rDtdd� |D ��|_ n*t|t�r\t|j �|_ nt�t d| �� dS )z�Convert old styled source_suffix to new styled one.
* old style: str or list
* new style: a dict which maps from fileext to filetype
Nc S s g | ] }|d f�qS r+ r' )r- �sr' r' r( �
<listcomp>u r0 z)convert_source_suffix.<locals>.<listcomp>zeThe config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.)
r\ r1 r$ r r5 r6 r3 r� r� r )r� rN r\ r' r' r( �convert_source_suffixf s
�r� c C s0 |j }|r,tdd� |�� D ��s,|j|i|_ dS )z�Convert old styled highlight_options to new styled one.
* old style: options
* new style: a dict which maps from language name to options
c s s | ]}t |t�V qd S r+ )r1 r3 )r- �vr' r' r( r/ � r0 z,convert_highlight_options.<locals>.<genexpr>N)r^ r8 ri r] )r� rN �optionsr' r' r( �convert_highlight_options s r� c C s4 t d�t d�t d�t d�d�}|�|j� ||_dS )z$Initialize :confval:`numfig_format`.z
Section %szFig. %szTable %sz
Listing %s)�sectionZfigure�tablez
code-blockN)r r� rb )r� rN rb r' r' r( �init_numfig_format� s � r� c C sB t d�dur>dD ],}||v rdtd� }t�||| �||< qdS )z�Correct values of copyright year that are not coherent with
the SOURCE_DATE_EPOCH environment variable (if set)
See https://reproducible-builds.org/specs/source-date-epoch/
�SOURCE_DATE_EPOCHN)rV Zepub_copyrightz\g<1>%sz%Y)r r �copyright_year_re�sub)r� rN �k�replacer' r' r( �correct_copyright_year� s
r� c
C s� |D �]�}|j |j \}}}t|�r,||�}|du r:|s:q|tu rDqt|t�r�|�|j�s�td�}t j
|j |j|j|j d�dd� qt
|j�t
|�u r�qt
|j�|v r�qtt
|j�jt
|j�f �tt
|�j�@ }|�t� |r�q|�rZtd�}dd� |D �}t|�d k�r,d
� d �|dd � �|d �} n
d
�|�} t j
|j |jt
|j�| d�dd� qtd�}t j
|j |jt
|j�t
|�d�dd� qdS )z�Check all values for deviation from the default value's type, since
that can result in TypeErrors all over the place NB.
NzTThe config value `{name}` has to be a one of {candidates}, but `{current}` is given.)r �currentr; T)�oncezNThe config value `{name}' has type `{current.__name__}'; expected {permitted}.c S s g | ]}d � |j��qS )z`{}')�formatr! )r- rI r' r' r( r� � r0 z'check_confval_types.<locals>.<listcomp>rx z {}, or {}z, ���z or )r r� � permittedzZThe config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.)r r� rO )ri r r~ r r1 r: rA r r r� r� r� r; r{ r7 � __bases__�discard�object�lenrp )
r� rN ZconfvalrO r � annotationsr� Z common_basesZwrapped_annotationsr� r' r' r( r� � sb
�� �
�
�� ��r� c C s0 |j }|r,| j�|�s,t�td�|� d |_ d S )Nz%primary_domain %r not found, ignored.)r` �registryZ
has_domainr� r� r )r� rN r` r' r' r( �check_primary_domain� s r� r )r� rE �added�changed�removedr* c C s> | j jdkr:d| jjvr:d| jjv r:t�td�� d| j _|S )zjAdjust root_doc to 'contents' to support an old project which does not have
any root_doc setting.
rL �contentszkSince v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.)rN r[ rU Zdocnamesr� r� r )r� rE r� r� r� r' r' r( �check_root_doc� s
�
�r� )r� r* c C sx | j dtdd� | j dtdd� | j dtdd� | j dtdd� | j dtdd� | j dtdd� | � dt� dddd�S )Nz
config-initedi )�priorityzenv-get-outdatedZbuiltinT)rW Zparallel_read_safeZparallel_write_safe)Zconnectr� r� r� r� r� r� r� )r� r' r' r( re � s �re )DrB �rer� r� � collectionsr �osr r �typingr r r r r r
r r r
r r r Z
sphinx.errorsr r Z
sphinx.localer r Z sphinx.utilr Zsphinx.util.i18nr Zsphinx.util.osutilr r Zsphinx.util.tagsr Zsphinx.util.typingr Zsphinx.applicationr Zsphinx.environmentr Z getLoggerr! r� rq r{ �
ModuleType� FunctionTyper2 r� r� r r& r, r: rC r$ rs r� r� r� r� r� r� r� re r' r' r' r( �<module> sJ
8
7
�