Remove unused publisher creation functions (#13680)

Author: AA-Turner

sphinx/io.py

@@ -4,8 +4,7 @@
 
 from typing import TYPE_CHECKING
 
-from docutils.core import Publisher
-from docutils.io import FileInput, NullOutput
+from docutils.io import FileInput
 from docutils.readers import standalone
 from docutils.transforms.references import DanglingReferences
 from docutils.writers import UnfilteredWriter
@@ -110,22 +109,3 @@ class SphinxFileInput(FileInput):
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         kwargs['error_handler'] = 'sphinx'
         super().__init__(*args, **kwargs)
-
-
-def _create_publisher(
-    *, env: BuildEnvironment, parser: Parser, transforms: list[type[Transform]]
-) -> Publisher:
-    reader = SphinxStandaloneReader()
-    reader._setup_transforms(transforms)
-    pub = Publisher(
-        reader=reader,
-        parser=parser,
-        writer=SphinxDummyWriter(),
-        source_class=SphinxFileInput,
-        destination=NullOutput(),
-    )
-    # Propagate exceptions by default when used programmatically:
-    defaults = {'traceback': True, **env.settings}
-    # Set default settings
-    pub.get_settings(**defaults)
-    return pub

sphinx/registry.py

@@ -12,7 +12,6 @@
 from sphinx.domains.std import GenericObject, Target
 from sphinx.errors import ExtensionError, SphinxError, VersionRequirementError
 from sphinx.extension import Extension
-from sphinx.io import _create_publisher
 from sphinx.locale import __
 from sphinx.parsers import Parser as SphinxParser
 from sphinx.roles import XRefRole
@@ -26,7 +25,6 @@
     from typing import Any, TypeAlias
 
     from docutils import nodes
-    from docutils.core import Publisher
     from docutils.nodes import Element, Node, TextElement
     from docutils.parsers import Parser
     from docutils.parsers.rst import Directive
@@ -153,9 +151,6 @@ def __init__(self) -> None:
         #: additional transforms; list of transforms
         self.transforms: list[type[Transform]] = []
 
-        # private cache of Docutils Publishers (file type -> publisher object)
-        self.publishers: dict[str, Publisher] = {}
-
     @property
     def autodoc_attrgettrs(self) -> dict[type, Callable[[Any, str, Any], Any]]:
         return self.autodoc_attrgetters
@@ -596,19 +591,6 @@ def get_envversion(self, app: Sphinx) -> Mapping[str, int]:
 
         return _get_env_version(app.extensions)
 
-    def _get_publisher(
-        self, filetype: str, *, config: Config, env: BuildEnvironment
-    ) -> Publisher:
-        try:
-            return self.publishers[filetype]
-        except KeyError:
-            pass
-        parser = self.create_source_parser(filetype, config=config, env=env)
-        transforms = self.get_transforms()
-        publisher = _create_publisher(env=env, parser=parser, transforms=transforms)
-        self.publishers[filetype] = publisher
-        return publisher
-
 
 def merge_source_suffix(app: Sphinx, config: Config) -> None:
     """Merge any user-specified source_suffix with any added by extensions."""