| 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 dl Z d dlZd dlZd dlmZ d dlmZmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZ d dlmZmZ d dlmZmZ d dlm Z d dl m Z d d l m Z m!Z! d d
l"m#Z# d d l$m%Z% e r�d d l&m'Z' d d
l(m)Z) e �*e+�Z,dZ-e.ej/ej0fZ1e �2d�Z3G dd� de�Z4e
e5d�dd�Z6G dd� d�Z7G dd� d�Z8e9ee# e e9e
f d�dd�Z:d e8dd �d d �Z;d e8dd �d d!�Z<d e8dd �d"d#�Z=d e8dd �d$d%�Z>d e8dd �d&d'�Z?d e8dd �d(d)�Z@d d*ee9 ee9 ee9 ee9 d+�d,d-�ZAd e e9e
f d.�d/d0�ZBdS )1� 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 )NFc 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 @ s6 e Zd Zedd�dd�Zeeeef ed�dd�Z dS )�ENUMN)�
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# r$ r> r r r r& rA r' r' r' r( r: : s r: c 6 @ s> e Zd ZU ddg fddg fddegfdd� degfddg fddg fddg fddegfddegfd gdg fd
degfd d g fd
dg fdd� dg fddidefddg fg dg fddegfddg fddg fd dg fd dg fddegfddg fi dg fg dg fddegfd dg fg dg fg dg fddegfddegfddg fddegfddegfi dg fddg fd dg fg dg fg dg fd dg fddg fi dg fd dg fddegfddg fddg fddg fddegfddg fddg fdgddgd�dg fd�4Zeeef e d < i i feeef eeef dd �d d �Z
e dEeee d d �d!d"��Z
eeed#�d$d%�Zdd&�d'd(�Zdd&�d)d*�Zdd&�d+d,�Zeed-�d.d/�Zeed-�d0d1�Zeedd#�d2d3�Zedd-�d4d5�Zeed-�d6d7�Zeeddf d&�d8d9�Zeeeeef edd:�d;d<�Z eee e f e e d=�d>d?�Z ed&�d@dA�Z eddB�dCdD�Z!dS )F�Config�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( rI m r0 z.rstZrestructuredtextz utf-8-sigT�default�py� ZqDe�jaZman�text)� languagesZbuilders)4�projectZauthorrG � copyright�version�releaseZtodayZ today_fmt�language� locale_dirsZfigure_language_filenameZ gettext_allow_fuzzy_translationsrL �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)rM � 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 rc rB rb �copy�values� _raw_config�getrd r1 r$ �pop�splitre )r= rM rc r' r' r( r> � s
zConfig.__init__)�confdirrc �tagsr* c C s> t �|t�}t �|�s&ttd�| ��t||�}| ||p:i �S )Nz4config directory doesn't contain a conf.py file (%s))r �join�CONFIG_FILENAME�isfiler r �eval_config_file)�clsrm rc rn �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=valuerf z/invalid number %r for config value %r, ignoringzAcannot override config setting %r with unsupported type, ignoring)
r1 r$ rh r r& �typer3 �
ValueErrorr r5 rl �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 d S )N)r` r^ rX rY �%s)rc r �__dict__ri 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�.rP z-unknown config value %r in override, ignoringr� )ri rc r4 rl �
setdefaultrh r� r� r r1 r$ r r{ r� )r= rM Zvalnamer Z realvalnamer9 r~ r r' r' r( � init_values� s(
�
$
zConfig.init_valuesc C s@ | j }|D ]&}|| jvr
|| jv r
|| | j|< q
td | � d S r+ )ri r� rh �check_confval_types)r= rM 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�AttributeErrorrh r r} )r= r rN 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+ )rh r� r' r' r( � __contains__ s zConfig.__contains__c c s0 | j �� D ] \}}t|t| |�|d �V q
d S )NrP )rh r4 r r� r� r' r' r( �__iter__ s zConfig.__iter__)r rN r �typesr* c C s0 || j v r ttd�| ��n|||f| j |< d S )Nz Config value %r already present)rh r r )r= r rN 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 d f|d |< qF|S )Nr rh rP )r� r4 r� r, rh 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# r$ r r rb r r r% r> � classmethodr rv r r� r� r� r� r� r� r� r& r� r r r� r r� r r
r� r� r� r' r' r' r( rB J s�
���>(
)
rB )rt rn 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 )N�__file__rn �rb�execz7There 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�compilerv �encoder r� � SyntaxErrorr r �
SystemExit� Exception� traceback�
format_exc)rt rn ru �f�code�err�msgr~ r' r' r( rr I s( ," Hrr r )�apprM r* c C sr |j }t|t�r t|d i�|_ nNt|ttf�rDtdd� |D ��|_ n*t|t�r\t|j �|_ nt�t d| �� d S )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� rM r[ r' r' r( �convert_source_suffixf s
�r� c C s0 |j }|r,tdd� |�� D ��s,|j|i|_ d S )Nc s s | ]}t |t�V qd S r+ )r1 r3 )r- �vr' r' r( r/ � r0 z,convert_highlight_options.<locals>.<genexpr>)r] r8 rh r\ )r� rM �optionsr' r' r( �convert_highlight_options s r� c C s4 t d�t d�t d�t d�d�}|�|j� ||_d S )Nz
Section %szFig. %szTable %sz
Listing %s)�sectionZfigure�tablez
code-block)r r� ra )r� rM ra r' r' r( �init_numfig_format� s � r� c C sB t d�d ur>dD ],}||v rdtd� }t�||| �||< qd S )N�SOURCE_DATE_EPOCH)rU Zepub_copyrightz\g<1>%sz%Y)r r �copyright_year_re�sub)r� rM �k�replacer' r' r( �correct_copyright_year� s
r� c
C s� |D �]�}|j |j \}}}t|�r,||�}|d u 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|�dk�r,d � d
�|d d � �|d �} n
d �|�} t j
|j |jt
|j�| d
�dd� qtd�}t j
|j |jt
|j�t
|�d�dd� qd S )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- rH r' r' r( r� � r0 z'check_confval_types.<locals>.<listcomp>rw z {}, or {}z, ���z or )r r� � permittedzZThe config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.)r r� rN )rh r r} r r1 r: rA r r r� r� r� r; rz r7 � __bases__�discard�object�lenro )
r� rM ZconfvalrN 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� rM r_ r' r' r( �check_primary_domain� s r� r )r� rD �added�changed�removedr* c C s> | j jdkr:d| jjvr:d| jjv r:t�td�� d| j _|S )NrK �contentszkSince v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.)rM rZ rT Zdocnamesr� r� r )r� rD 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)rV Zparallel_read_safeZparallel_write_safe)Zconnectr� r� r� r� r� r� r� )r� r' r' r( rd � s �rd )C�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� rp rz �
ModuleType� FunctionTyper2 r� r� r r& r, r: rB r$ rr r� r� r� r� r� r� r� rd r' r' r' r( �<module> sH 8
7
�