| 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/transforms/__pycache__/ |
Upload File : |
a
�abD< � @ s� d Z ddlZddlZddlZddlmZmZmZmZm Z m
Z
m Z m Z ddl
mZ ddlmZmZmZ ddlmZmZ ddlmZ ddlmZ dd lmZ dd
l m Z dd l m Z dd l m!Z! dd
l"m#Z# ddl$m%Z%m&Z& ddl'm
Z
m(Z( ddl)m*Z* ddl+m,Z, ddl-m.Z.m/Z/m0Z0 e�r>ddl1m2Z2 ddl3m4Z4 ddl5m6Z6 e(�7e8�Z9h d�Z:G dd� de�Z;G dd� de�Z<G dd � d e;�Z=G d d � d e;�Z>G d d � d e;�Z?G d!d"� d"e;�Z@G d#d$� d$e;�ZAejBejCejDe jEejFd%�ZGG d&d'� d'e;�ZHG d(d)� d)e;�ZIG d*d+� d+e;�ZJG d,d-� d-e;�ZKG d.d/� d/e;�ZLG d0d1� d1e;�ZMG d2d3� d3e;�ZNG d4d5� d5e�ZOG d6d7� d7ee;�ZPG d8d9� d9e;�ZQG d:d;� d;e;�ZRG d<d=� d=e;�ZSd>eeTef d?�d@dA�ZUdS )Bz�
sphinx.transforms
~~~~~~~~~~~~~~~~~
Docutils transforms used by Sphinx when reading documents.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
TYPE_CHECKING�Any�Dict� Generator�List�Optional�Tuple�cast)�nodes)�Element�Node�Text)� Transform� Transformer)�ContentsFilter)� SmartQuotes)�normalize_language_tag)�
smartchars)�addnodes)�Config)�RemovedInSphinx60Warning)�_�__)�docutils�logging)� new_document)� format_date)� NodeMatcher�apply_source_workaround�is_smartquotable)�Sphinx)�StandardDomain)�BuildEnvironment> �release�today�versionc @ sF e Zd ZdZedd�dd��Zedd�dd��Zeed�d d
��Zd S ) �SphinxTransformz�A base class of Transforms.
Compared with ``docutils.transforms.Transform``, this class improves accessibility to
Sphinx APIs.
r ��returnc C s | j jS )z)Reference to the :class:`.Sphinx` object.)�env�app��self� r- �>/usr/lib/python3.9/site-packages/sphinx/transforms/__init__.pyr* 7 s zSphinxTransform.appr" c C s
| j jjS )z3Reference to the :class:`.BuildEnvironment` object.)�document�settingsr) r+ r- r- r. r) < s zSphinxTransform.envc C s | j jS )z)Reference to the :class:`.Config` object.)r) �configr+ r- r- r. r1 A s zSphinxTransform.configN) �__name__�
__module__� __qualname__�__doc__�propertyr* r) r r1 r- r- r- r. r& 0 s r& c sR e Zd ZU dZejed< dZed ed< ddd�dd�Z dd �� fd
d � Z
� Z S ) �SphinxTransformerz#
A transformer for Sphinx.
r/ Nr" r) )r) r( c C s
|| _ d S �N)r) )r, r) r- r- r. �set_environmentO s z!SphinxTransformer.set_environmentr' c s� t | jtj�r:t| jjd�s.| jr.| j| jj_t� �� nRzBtd�}| jrT| j|j_|| j7 }|| _t� �� W | jd | _n| jd | _0 d S )Nr) � r ) �
isinstancer/ r
�hasattrr0 r) �super�apply_transformsr )r, r/ �� __class__r- r. r> R s
z"SphinxTransformer.apply_transforms) r2 r3 r4 r5 r
r/ �__annotations__r) r r9 r> �
__classcell__r- r- r? r. r7 G s
r7 c @ s$ e Zd ZdZdZedd�dd�ZdS )�DefaultSubstitutionszL
Replace some substitutions if they aren't defined in the document.
�� N��kwargsr( c K s| t t| jj� }| j�tj�D ]X}|d }||v r | j| }|dkrd|sdt| jj pXt
d�| jj d�}|� t�
||�� q d S )N�refnamer$ z %b %d, %Y)�language)�default_substitutions�setr/ Zsubstitution_defs�findallr
Zsubstitution_referencer1 r Z today_fmtr rH � replace_selfr
)r, rF Z to_handle�refrG �textr- r- r. �applyl s
�zDefaultSubstitutions.apply�r2 r3 r4 r5 �default_priorityr rO r- r- r- r. rC e s rC c @ s$ e Zd ZdZdZedd�dd�ZdS )�MoveModuleTargetszv
Move module targets that are the first thing in a section to the section
title.
XXX Python specific
rD NrE c K sn t | j�tj��D ]V}|d s qd|v r|jjtju r|j�|�dkr|d |jd dd�< |j� |� qd S )N�idsZismod� r )
�listr/ rK r
�target�parentr@ �section�index�remove�r, rF �noder- r- r. rO � s ��zMoveModuleTargets.applyrP r- r- r- r. rR z s rR c @ s$ e Zd ZdZdZedd�dd�ZdS )�HandleCodeBlocksz5
Several code block related transformations.
rD NrE c K s8 | j �tj�D ]$}tdd� |jD ��r|�|j� qd S )Nc s s | ]}t |tj�V qd S r8 )r; r
�
doctest_block)�.0�childr- r- r. � <genexpr>� � z)HandleCodeBlocks.apply.<locals>.<genexpr>)r/ rK r
Z block_quote�all�childrenrL r[ r- r- r. rO � s
�zHandleCodeBlocks.applyrP r- r- r- r. r] � s r] c @ s$ e Zd ZdZdZedd�dd�ZdS )�
AutoNumberingzO
Register IDs of tables, figures and literal_blocks to assign numbers.
rD NrE c K sT | j �d�}| j�tj�D ]4}|�|�r|�|�d ur|d g kr| j�|� qd S )NZstdrS ) r) Z
get_domainr/ rK r
r Zis_enumerable_nodeZget_numfig_titleZnote_implicit_target)r, rF �domainr\ r- r- r. rO � s
�
�zAutoNumbering.applyrP r- r- r- r. re � s re c @ s$ e Zd ZdZdZedd�dd�ZdS )�SortIdszA
Sort section IDs so that the "id[0-9]+" one comes last.
i NrE c K s\ | j �tj�D ]H}t|d �dkr|d d �d�r|d dd � |d d g |d< qd S )NrS rT r �id)r/ rK r
rX �len�
startswithr[ r- r- r. rO � s "z
SortIds.applyrP r- r- r- r. rg � s rg )z
literal-blockz
doctest-block�rawrY �imagec @ s$ e Zd ZdZdZedd�dd�ZdS )�ApplySourceWorkaroundz0
Update source and rawsource attributes
�
NrE c K s2 | j �� D ]"}t|tjtjtjf�r
t|� q
d S r8 )r/ rK r; r
Z TextElementrl Ztopicr r[ r- r- r. rO � s zApplySourceWorkaround.applyrP r- r- r- r. rm � s rm c @ s$ e Zd ZdZdZedd�dd�ZdS )�AutoIndexUpgraderz[
Detect old style (4 column based indices) and automatically upgrade to new style.
rD NrE c K s� | j �tj�D ]r}d|v rtdd� |d D ��rtd�|d }tj||d� t|d �D ]$\}}t |�dkrZ|d |d |< qZqd S )N�entriesc s s | ]}t |�d kV qdS )� N)ri )r_ �entryr- r- r. ra � rb z*AutoIndexUpgrader.apply.<locals>.<genexpr>zG4 column based index found. It might be a bug of extensions you use: %r)�locationrq r8 )
r/ rK r rY �anyr �logger�warning� enumerateri )r, rF r\ �msg�irr r- r- r. rO � s � zAutoIndexUpgrader.applyrP r- r- r- r. ro � s ro c @ s$ e Zd ZdZdZedd�dd�ZdS )�ExtraTranslatableNodesz!
Make nodes translatable
rn NrE c sX | j j��fdd�t�� D �� � s&d S ttd�� fdd� }| j�|�D ] }d|d< qFd S )Nc s g | ]\}}|� v r|�qS r- r- )r_ �k�v)�targetsr- r. �
<listcomp>� rb z0ExtraTranslatableNodes.apply.<locals>.<listcomp>�r\ r( c s t | t� ��S r8 )r; �tuple�r\ )� target_nodesr- r. �is_translatable_node� s z:ExtraTranslatableNodes.apply.<locals>.is_translatable_nodeTZ translatable)r1 Zgettext_additional_targets�TRANSLATABLE_NODES�itemsr �boolr/ rK )r, rF r� r\ r- )r� r} r. rO � s z ExtraTranslatableNodes.applyrP r- r- r- r. rz � s rz c @ s$ e Zd ZdZdZedd�dd�ZdS )� UnreferencedFootnotesDetectorz9
Detect unreferenced footnotes and emit warnings
�� NrE c s� | j jD ]F� � d g krq� d d | j jvrtjtd�� d d dd� d� q| j jD ]4� t� fdd�| j jD ��sXtjtd �dd� d� qXd S )
N�namesr z Footnote [%s] is not referenced.rM Zfootnote)�typeZsubtypers c 3 s | ]}|d � d kV qdS )�autoNr- )r_ rM r� r- r. ra
rb z6UnreferencedFootnotesDetector.apply.<locals>.<genexpr>z Footnote [#] is not referenced.) r/ Z footnotesZ
footnote_refsru rv r Z
autofootnotesrt Zautofootnote_refs�r, rF r- r� r. rO s �
�z#UnreferencedFootnotesDetector.applyrP r- r- r- r. r� � s r� c @ s$ e Zd ZdZdZedd�dd�ZdS )�DoctestTransformz.Set "doctest" style to each doctest_block node�� NrE c K s& | j �tj�D ]}|d �d� qd S )N�classesZdoctest)r/ rK r
r^ �appendr[ r- r- r. rO s zDoctestTransform.applyrP r- r- r- r. r� s r� c s> e Zd ZdZdZeedd�� fdd� Zedd�dd �Z� ZS )
�
FigureAlignerz-
Align figures to center by default.
i� N)�argsrF r( c s" t �dt� t� j|i |�� d S )Nz FigureAilgner is deprecated.)�warnings�warnr r= �__init__)r, r� rF r? r- r. r� " s �zFigureAligner.__init__rE c K s0 t tjtj�}| j�|�D ]}|�dd� qd S )NZalign�default)r r
�tableZfigurer/ rK �
setdefault)r, rF Zmatcherr\ r- r- r. rO ' s zFigureAligner.apply) r2 r3 r4 r5 rQ r r� rO rB r- r- r? r. r� s r� c @ s$ e Zd ZdZdZedd�dd�ZdS )�FilterSystemMessagesz&Filter system messages from a doctree.�� NrE c K sT | j jr dnd}t| j�tj��D ],}|d |k r"t�d|� � � |j
� |� q"d S )N� � �levelz %s [filtered system message]) r1 Z
keep_warningsrU r/ rK r
Zsystem_messageru �debug�astextrW rZ )r, rF Z filterlevelr\ r- r- r. rO 1 s
zFilterSystemMessages.applyrP r- r- r- r. r� - s r� c @ s( e Zd ZdZejZejdd�dd�Z dS )�SphinxContentsFilterzx
Used with BuildEnvironment.add_toc_from() to discard cross-file links
within table-of-contents link nodes.
Nr c C s
t j�d S r8 )r
ZSkipNode)r, r\ r- r- r. � visit_image@ s z SphinxContentsFilter.visit_image)
r2 r3 r4 r5 r Z ignore_node_but_process_childrenZvisit_pending_xrefr
rl r� r- r- r- r. r� 9 s r� c s` e Zd ZdZdZedd�� fdd� Zed�dd �Ze e
e e e
e
f ddf d
�d d �Z� ZS )
�SphinxSmartQuoteszr
Customized SmartQuotes to avoid transform for some extra node types.
refs: sphinx.parsers.RSTParser
i� NrE c s$ | � � s d S | jj| _t� �� d S r8 )� is_availabler1 Zsmartquotes_actionr= rO r� r? r- r. rO L s
zSphinxSmartQuotes.applyr' c C s� | j j�dg �}| j j�dg �}| jjjdu r2dS | j jdu rBdS | jjj |v rTdS | j j
|v rddS | j jd }t |�D ]}|t
jv rx dS qxdS )N�builders� languagesFZ
language_codeT)r1 Zsmartquotes_excludes�getr/ r0 Z smart_quotesZ smartquotesr* Zbuilder�namerH r) r r Zquotes)r, r� r� rH �tagr- r- r. r� U s
z SphinxSmartQuotes.is_available)�txtnodesr( c c sV |D ]L}t |�rBtjdkr.t�ddt|��}n|�� }d|fV qd|�� fV qd S )N)r � z(?<=\x00)([-\\\'".`])z\\\1Zplain�literal)r r Z__version_info__�re�sub�strr� )r, r� ZtxtnoderN r- r- r. �
get_tokensn s
z SphinxSmartQuotes.get_tokens)r2 r3 r4 r5 rQ r rO r� r� r r
r r r� r� rB r- r- r? r. r� D s
r� c @ s$ e Zd ZdZdZedd�dd�ZdS )�DoctreeReadEventz!Emit :event:`doctree-read` event.ip NrE c K s | j �d| j� d S )Nz doctree-read)r* �emitr/ r� r- r- r. rO � s zDoctreeReadEvent.applyrP r- r- r- r. r� s r� c @ s$ e Zd ZdZdZedd�dd�ZdS )� ManpageLinkz&Find manpage section numbers and namesr� NrE c K sb | j �tj�D ]N}d�dd� |jD ��}d}||dd�}t�||�}|rP|�� }|j �
|� qd S )N� c S s g | ]}t |tj�rt|��qS r- )r; r
r
r� )r_ �xr- r- r. r~ � s �z%ManpageLink.apply.<locals>.<listcomp>z7^(?P<path>(?P<page>.+)[\(\.](?P<section>[1-9]\w*)?\)?)$r: )�pathZpagerX ) r/ rK r �manpage�joinrd r� �match� groupdictZ
attributes�update)r, rF r\ r� �pattern�info�rr- r- r. rO � s � zManpageLink.applyrP r- r- r- r. r� � s r� c @ s$ e Zd ZdZdZedd�dd�ZdS )�GlossarySorterz.Sort glossaries that have the ``sorted`` flag.r� NrE c K sH | j �tj�D ]4}|d rttj|d �}t|dd� d�|d d �< qd S )N�sortedr c S s t �dttj| �d �� �� �S )NZNFDr )� unicodedata� normalizer r
Ztermr� �lower)�itemr- r- r. �<lambda>� s �z&GlossarySorter.apply.<locals>.<lambda>)�key)r/ rK r �glossaryr r
�definition_listr� )r, rF r� r� r- r- r. rO � s �zGlossarySorter.applyrP r- r- r- r. r� � s r� r )r* r( c C s� | � t� | � t� | � t� | � t� | � t� | � t� | � t� | � t� | � t � | � t
� | � t � | � t � | � t
� | � t� | � t� dddd�S )NZbuiltinT)r% Zparallel_read_safeZparallel_write_safe)Z
add_transformrm rz rC rR r] rg r� re ro r� r� r� r� r� r� )r* r- r- r. �setup� s&
�r� )Vr5 r� r� r� �typingr r r r r r r r r r
Zdocutils.nodesr r r
Zdocutils.transformsr r Zdocutils.transforms.partsr Z docutils.transforms.universalr Zdocutils.utilsr Zdocutils.utils.smartquotesr Zsphinxr Z
sphinx.configr Zsphinx.deprecationr Z
sphinx.localer r Z sphinx.utilr Zsphinx.util.docutilsr Zsphinx.util.i18nr Zsphinx.util.nodesr r r Zsphinx.applicationr Zsphinx.domain.stdr! Zsphinx.environmentr" Z getLoggerr2 ru rI r& r7 rC rR r] re rg Z
literal_blockr^ rk rY rl r� rm ro rz r� r� r� r� r� r� r� r� r� r� r� r- r- r- r. �<module> sf
(
� ;