B \ @sndZddlZddlZddlmZddlmZddlmZGdddej j Z Gdd d ej j j Z d d Z dS) z sphinx.parsers ~~~~~~~~~~~~~~ A Base class for additional parsers. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. N)states) StringList) SmartQuotesc@seZdZdZddZdS)ParseraV 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 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 a informational message. (Same as :meth:`sphinx.application.Sphinx.info()`) .. deprecated:: 1.6 ``warn()`` and ``info()`` is deprecated. Use :mod:`sphinx.util.logging` instead. cCs*||_|j|_|j|_|j|_|j|_dS)zset_application will be called from Sphinx to set app and other instance variables :param sphinx.application.Sphinx app: Sphinx application object N)appZconfigenvwarninfo)selfrr -lib/python3.7/site-packages/sphinx/parsers.pyset_application1s zParser.set_applicationN)__name__ __module__ __qualname____doc__r r r r r rsrc@s eZdZdZddZddZdS) RSTParserzA reST parser for Sphinx.cCstjjj|}|t|S)zySphinx's reST parser replaces a transform class for smart-quotes by own's refs: sphinx.io.SphinxStandaloneReader)docutilsparsersrstrget_transformsremover)r Z transformsr r r rAs zRSTParser.get_transformscCsft|trN|||tj|j|j|jjd|_ |j j |||j d| nt jjj|||dS)zParse text and generate a document tree. This accepts StringList as an inputstring parameter. It enables to handle mixed contents (cf. :confval:`rst_prolog`) correctly. ) state_classes initial_statedebug)inlinerN) isinstancerZ setup_parserZRSTStateMachinerrZreporterZ debug_flagZ statemachinerunrZ finish_parserrrrparse)r Z inputstringZdocumentr r r rJs   zRSTParser.parseN)rrrrrrr r r r r>s rcCs|tddddS)NZbuiltinT)versionZparallel_read_safeZparallel_write_safe)Zadd_source_parserr)rr r r setup_s r )rZdocutils.parsersrZdocutils.parsers.rstrZdocutils.statemachinerZdocutils.transforms.universalrrrrrr r r r r  s   $!