|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/sphinx/__pycache__/ |
Upload File : |
o
�$�a� � @ s� d Z ddlZddlmZmZmZmZ ddlmZ ddl m
Z
ddl m Z ddl
mZmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lm Z dd
l m Z ddl m Z ddl!m"Z"m#Z#m$Z$m%Z% ddl&m'Z'm(Z(m)Z) ddl*m+Z+ ddl,m-Z-m.Z.m/Z/ ddl0m1Z1 ddl2m3Z3 er�ddl4m5Z5 e/�6e7�Z8G dd� dej9�Z:G dd� de:�Z;G dd� de:�Z<G d d � d e �Z=d ed ed ed!efd"d#�Z>G d$d%� d%e�Z?d&d'd(e d)e@d!ejAfd*d+�ZBdS ),z�
sphinx.io
~~~~~~~~~
Input/Output files
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
TYPE_CHECKING�Any�List�Type)�nodes)� Publisher)�Values)� FileInput�Input�
NullOutput)�Parser)�
standalone)� Transform)�DanglingReferences)�UnfilteredWriter)�addnodes)�BuildEnvironment)�AutoIndexUpgrader�DoctreeReadEvent�
FigureAligner�SphinxTransformer)�Locale� PreserveTranslatableMessages�RemoveTranslatableInline)�
SphinxDomains)�UnicodeDecodeErrorHandler� get_filetype�logging)�LoggingReporter)� UIDTransform��Sphinxc s| e Zd ZU dZg Zeee ed< de de ddf� fdd� Z
dd d �Z deee f� fd
d� Z de
jf� fdd� Z� ZS )�SphinxBaseReaderzm
A base class of readers for Sphinx.
This replaces reporter by Sphinx's on generating document.
�
transforms�args�kwargs�returnNc s\ ddl m} t|�dkr#t|d |�r#|d | _| jj| _|dd � }t� j|i |�� d S )Nr r � ) �sphinx.applicationr! �len�
isinstance�_app�env�_env�super�__init__)�selfr$ r% r! �� __class__� �+/usr/lib/python3/dist-packages/sphinx/io.pyr/ 3 s
zSphinxBaseReader.__init__�appr! c C s || _ |j| _d S �N)r+ r, r- �r0 r5 r3 r3 r4 �setup< s zSphinxBaseReader.setupc s6 t � �� | j }tg}|D ] }||v r|�|� q
|S r6 )r. �get_transformsr# r �remove)r0 r# �unused� transformr1 r3 r4 r9 @ s
�z SphinxBaseReader.get_transformsc sB t � �� }tj|_t|�|_|j�| jj � |j
}t � |�|_
|S )zm
Creates a new document object which has a special reporter object good
for logging.
)
r. � new_documentr �documentr2 r � transformer�set_environment�settingsr, �reporterr �
from_reporter)r0 r> rB r1 r3 r4 r= K s
z SphinxBaseReader.new_document�r5 r! r& N)�__name__�
__module__� __qualname__�__doc__r# r r r �__annotations__r r/ r8 r9 r r> r= �
__classcell__r3 r3 r1 r4 r" * s
r" c sP e Zd ZdZd� fdd� Zded ed
edej fd d �Z
d
e de fdd�Z
� ZS )�SphinxStandaloneReaderz-
A basic document reader for Sphinx.
r5 r! r& Nc s" | j |j�� | _ t� �|� d S r6 )r# �registryr9 r. r8 r7 r1 r3 r4 r8 c s z SphinxStandaloneReader.setup�source�parserrA c C s4 || _ | js || _|| _| �|j�| _| �� | jS r6 )rM rN rA � read_sourcer, �input�parser> )r0 rM rN rA r3 r3 r4 �readg s zSphinxStandaloneReader.readr, c C s* | j �� }|g}|j�d|j|� |d S )z-Read content from source and do post-process.z source-readr )rM rR �events�emit�docname)r0 r, �content�argr3 r3 r4 rO p s
z"SphinxStandaloneReader.read_sourcerD )rE rF rG rH r8 r
r r r r> rR r �strrO rJ r3 r3 r1 r4 rK ^ s
rK c s" e Zd ZdZd� fdd� Z� ZS ) �SphinxI18nReadera
A document reader for i18n.
This returns the source line number of original text as current source line number
to let users know where the error happened.
Because the translated texts are partial and they don't have correct line numbers.
r5 r! r& Nc sV t � �|� | j|j�� | _ttttt t
t t g}|D ]
}|| jv r(| j�
|� qd S r6 )r. r8 r# rL r9 r r r r r r r r r: )r0 r5 r; r< r1 r3 r4 r8 � s �
��zSphinxI18nReader.setuprD )rE rF rG rH r8 rJ r3 r3 r1 r4 rY z s rY c @ s e Zd ZdZdZddd�ZdS )�SphinxDummyWriterz0Dummy writer module used for generating doctree.)�htmlr& Nc C s d S r6 r3 )r0 r3 r3 r4 � translate� s zSphinxDummyWriter.translate)r& N)rE rF rG rH � supportedr\ r3 r3 r3 r4 rZ � s rZ rM r$ r% r& c O s | S )z.Bypass source object as is to cheat Publisher.r3 )rM r$ r% r3 r3 r4 �SphinxDummySourceClass� s r^ c s. e Zd ZdZdededdf� fdd� Z� ZS )�SphinxFileInputz A basic FileInput for Sphinx.r$ r% r& Nc s d|d< t � j|i |�� d S )N�sphinx�
error_handler)r. r/ )r0 r$ r% r1 r3 r4 r/ � s zSphinxFileInput.__init__)rE rF rG rH r r/ rJ r3 r3 r1 r4 r_ � s "r_ r5 r! r, �filenamec C s� t |j�}t�d|� t� }|�| � t| jj|�}| j �
| |�}|j j dkr0|j
dkr0tj
|_
t||t� tt� d�}|�d|jd� |j|d� |�� |jS )z(Parse a document and convert to doctree.r` �CommonMarkParserr3 )�readerrN �writer� source_class� destinationN)� source_path)r rU �codecs�register_errorrK r8 r �config�
source_suffixrL �create_source_parserr2 rE �
settings_spec� RSTParserr rZ r_ r � process_programmatic_settingsrA �
set_source�publishr> )r5 r, rb ra rd �filetyperN �pubr3 r3 r4 �read_doc� s$
� ru )CrH ri �typingr r r r �docutilsr �
docutils.corer �docutils.frontendr � docutils.ior r
r �docutils.parsersr �docutils.parsers.rstro �docutils.readersr
�docutils.transformsr � docutils.transforms.referencesr �docutils.writersr r` r �sphinx.environmentr �sphinx.transformsr r r r �sphinx.transforms.i18nr r r � sphinx.transforms.referencesr � sphinx.utilr r r �sphinx.util.docutilsr �sphinx.versioningr r( r! � getLoggerrE �logger�Readerr" rK rY rZ r^ r_ rX r> ru r3 r3 r3 r4 �<module> s>
4