|
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 ddlZddlmZmZmZmZmZmZ ddl Z
ddl Z
ddl
m Z ddl m
Z
ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZmZ erRdd lmZ G d d
� d
e
jj �Z G dd� de
jj j e �Z dddee ef fdd�Z dS )z�
sphinx.parsers
~~~~~~~~~~~~~~
A Base class for additional parsers.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
TYPE_CHECKING�Any�Dict�List�Type�Union)�nodes)�states)�
StringList)� Transform)� SmartQuotes)�RemovedInSphinx50Warning)�
append_epilog�prepend_prolog)�Sphinxc @ s( e Zd ZdZd
dd�Zed dd ��ZdS ) �Parsera�
A base class of source parsers. The additional parsers should inherit this class instead
of ``docutils.parsers.Parser``. Compared with ``docutils.parsers.Parser``, this class
improves accessibility to Sphinx APIs.
The subclasses can access the following objects and functions:
self.app
The application object (:class:`sphinx.application.Sphinx`)
self.config
The config object (:class:`sphinx.config.Config`)
self.env
The environment object (:class:`sphinx.environment.BuildEnvironment`)
self.warn()
Emit a warning. (Same as :meth:`sphinx.application.Sphinx.warn()`)
self.info()
Emit an info message. (Same as :meth:`sphinx.application.Sphinx.info()`)
.. deprecated:: 1.6
``warn()`` and ``info()`` is deprecated. Use :mod:`sphinx.util.logging` instead.
.. deprecated:: 3.0
parser.app is deprecated.
�appr �returnNc C s || _ |j| _|j| _dS )z�set_application will be called from Sphinx to set app and other instance variables
:param sphinx.application.Sphinx app: Sphinx application object
N)�_app�config�env)�selfr � r �0/usr/lib/python3/dist-packages/sphinx/parsers.py�set_application6 s zParser.set_applicationc C s t jdtdd� | jS )Nzparser.app is deprecated.� )�
stacklevel)�warnings�warnr
r )r r r r r ? s z
Parser.app)r r r N)r r )�__name__�
__module__� __qualname__�__doc__r �propertyr r r r r r s
r c s` e Zd ZdZdeee f� fdd� Zdee e
f de j ddfdd �Z
d
e
ddfd d �Z� ZS )
� RSTParserzA reST parser for Sphinx.r c s t � �� }|�t� |S )z�
Sphinx's reST parser replaces a transform class for smart-quotes by its own
refs: sphinx.io.SphinxStandaloneReader
)�super�get_transforms�remover )r �
transforms�� __class__r r r& H s
zRSTParser.get_transforms� inputstring�documentNc C s� | � ||� tj| j| j|jjd�| _t|t �r*t
jj ||j j
dd�}t||j�}n|}| �|� | jj||| jd� | �� dS )z(Parse text and generate a document tree.)�
state_classes�
initial_state�debugT)� tab_width�convert_whitespace)�inlinerN)� setup_parser �RSTStateMachiner- r. �reporter�
debug_flag� statemachine�
isinstance�str�docutils� string2lines�settingsr0 r
�current_source�decorate�runr2 � finish_parse)r r+ r, �lines�
inputlinesr r r �parseR s �
�
zRSTParser.parse�contentc C s t || jj� t|| jj� dS )z'Preprocess reST content before parsing.N)r r �
rst_prologr �
rst_epilog)r rD r r r r> h s zRSTParser.decorate)r r r! r" r r r r& r r9 r
r r, rC r> �
__classcell__r r r) r r$ E s
r$ r r r c C s | � t� dddd�S )N�builtinT)�version�parallel_read_safe�parallel_write_safe)�add_source_parserr$ )r r r r �setupn s
�rM )!r" r �typingr r r r r r �docutils.parsersr: �docutils.parsers.rstr r �docutils.statemachiner
�docutils.transformsr � docutils.transforms.universalr �sphinx.deprecationr
�sphinx.util.rstr r �sphinx.applicationr �parsersr �rstr$ r9 rM r r r r �<module> s"
( )