Sphinx 8.1.1__py3-none-any.whl → 8.1.2__py3-none-any.whl

sphinx/__init__.py

@@ -1,6 +1,6 @@
 """The Sphinx documentation toolchain."""
 
-__version__ = '8.1.1'
+__version__ = '8.1.2'
 __display_version__ = __version__  # used for command line version
 
 # Keep this file executable as-is in Python 3!
@@ -30,7 +30,7 @@ warnings.filterwarnings(
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (8, 1, 1, 'final', 0)
+version_info = (8, 1, 2, 'final', 0)
 
 package_dir = os.path.abspath(os.path.dirname(__file__))
 

sphinx/builders/__init__.py

@@ -59,14 +59,20 @@ class Builder:
     Builds target formats from the reST sources.
     """
 
-    #: The builder's name, for the -b command line option.
-    name = ''
+    #: The builder's name.
+    #: This is the value used to select builders on the command line.
+    name: str = ''
     #: The builder's output format, or '' if no document output is produced.
-    format = ''
-    #: The message emitted upon successful build completion. This can be a
-    #: printf-style template string with the following keys: ``outdir``,
-    #: ``project``
-    epilog = ''
+    #: This is commonly the file extension, e.g. "html",
+    #: though any string value is accepted.
+    #: The builder's format string can be used by various components
+    #: such as :class:`.SphinxPostTransform` or extensions to determine
+    #: their compatibility with the builder.
+    format: str = ''
+    #: The message emitted upon successful build completion.
+    #: This can be a printf-style template string
+    #: with the following keys: ``outdir``, ``project``
+    epilog: str = ''
 
     #: default translator class for the builder.  This can be overridden by
     #: :py:meth:`~sphinx.application.Sphinx.set_translator`.
@@ -74,8 +80,8 @@ class Builder:
     # doctree versioning method
     versioning_method = 'none'
     versioning_compare = False
-    #: allow parallel write_doc() calls
-    allow_parallel = False
+    #: Whether it is safe to make parallel :meth:`~.Builder.write_doc()` calls.
+    allow_parallel: bool = False
     # support translation
     use_message_catalog = True
 
@@ -83,9 +89,9 @@ class Builder:
     #: Image files are searched in the order in which they appear here.
     supported_image_types: list[str] = []
     #: The builder can produce output documents that may fetch external images when opened.
-    supported_remote_images = False
+    supported_remote_images: bool = False
     #: The file format produced by the builder allows images to be embedded using data-URIs.
-    supported_data_uri_images = False
+    supported_data_uri_images: bool = False
 
     def __init__(self, app: Sphinx, env: BuildEnvironment) -> None:
         self.srcdir = app.srcdir
@@ -159,7 +165,7 @@ class Builder:
     def get_relative_uri(self, from_: str, to: str, typ: str | None = None) -> str:
         """Return a relative URI between two source filenames.
 
-        May raise environment.NoUri if there's no way to return a sensible URI.
+        :raises: :exc:`!NoUri` if there's no way to return a sensible URI.
         """
         return relative_uri(
             self.get_target_uri(from_),
@@ -789,7 +795,16 @@ class Builder:
         pass
 
     def write_doc(self, docname: str, doctree: nodes.document) -> None:
-        """Where you actually write something to the filesystem."""
+        """
+        Write the output file for the document
+
+        :param docname: the :term:`docname <document name>`.
+        :param doctree: defines the content to be written.
+
+        The output filename must be determined within this method,
+        typically by calling :meth:`~.Builder.get_target_uri`
+        or :meth:`~.Builder.get_relative_uri`.
+        """
         raise NotImplementedError
 
     def write_doc_serialized(self, docname: str, doctree: nodes.document) -> None:

sphinx/util/__init__.py

@@ -8,6 +8,7 @@ import posixpath
 import re
 from typing import Any
 
+from sphinx.errors import ExtensionError as _ExtensionError
 from sphinx.errors import FiletypeNotFoundError
 from sphinx.util import _files, _importer, logging
 from sphinx.util import index_entries as _index_entries
@@ -86,6 +87,7 @@ _DEPRECATED_OBJECTS: dict[str, tuple[Any, str, tuple[int, int]]] = {
         'sphinx.util.index_entries.split_into',
         (9, 0),
     ),
+    'ExtensionError': (_ExtensionError, 'sphinx.errors.ExtensionError', (9, 0)),
     'md5': (_md5, '', (9, 0)),
     'sha1': (_sha1, '', (9, 0)),
     'import_object': (_importer.import_object, '', (10, 0)),

{sphinx-8.1.1.dist-info → sphinx-8.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Sphinx
-Version: 8.1.1
+Version: 8.1.2
 Summary: Python documentation generator
 Author-email: Georg Brandl <georg@python.org>
 Requires-Python: >=3.10
@@ -80,6 +80,7 @@ Requires-Dist: setuptools>=70.0 ; extra == "test"
 Requires-Dist: typing_extensions>=4.9 ; extra == "test"
 Project-URL: Changelog, https://www.sphinx-doc.org/en/master/changes.html
 Project-URL: Code, https://github.com/sphinx-doc/sphinx
+Project-URL: Documentation, https://www.sphinx-doc.org/
 Project-URL: Download, https://pypi.org/project/Sphinx/
 Project-URL: Homepage, https://www.sphinx-doc.org/
 Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues

{sphinx-8.1.1.dist-info → sphinx-8.1.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sphinx/__init__.py,sha256=gv74Ri64G9lpcAck-AfWi5n5qoQljTm4j2PZzGL0XmE,1703
+sphinx/__init__.py,sha256=-2svNZt_Ib-y3gkKkZ3ti6x3Qn-WSHESCMrFZgyxPhA,1703
 sphinx/__main__.py,sha256=wIifwXlZHdi4gtQmkJ6KF0BsflvD9o0Wd5nARTdJc8A,127
 sphinx/addnodes.py,sha256=EQTIi9Zta6DaNa-2WGE3l9AVjdp7WzwwrfwRnax8vXE,18707
 sphinx/application.py,sha256=j1EjhSnXce7HcgHeRGfDrhOuMCs2Ha-0TRfVMmq9SQ8,65788
@@ -22,7 +22,7 @@ sphinx/_cli/__init__.py,sha256=AWTELmWU_5J7uiuNQYi1mQfH483Z0ZYeYonNdmb5O9A,9982
 sphinx/_cli/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sphinx/_cli/util/colour.py,sha256=M04FGs_3Dpet0SmIyRg8I7gKbta8mfAGMObocgZX5N8,2997
 sphinx/_cli/util/errors.py,sha256=_3YWZbr0vItrMcZ0zsLr2IqaCEEkJf4lmNhKO7AH5UI,4852
-sphinx/builders/__init__.py,sha256=ePfyqt-laqx10df6upr6w9J9Jkpg2EV2dVQD2HkO7mM,31848
+sphinx/builders/__init__.py,sha256=0lDANXVqejGXYL0dF1BPy0IzJ_FUHPUWEMt7dwhMpvs,32542
 sphinx/builders/_epub_base.py,sha256=-FGIGZ-4Cu3KWqeb2QfprBKl6x7REt5i4uJvBEwZVeE,29848
 sphinx/builders/changes.py,sha256=Izkn2P-EZnMtEn3LXes8ho2SvY7XrUaPBdJVjaUGejk,6958
 sphinx/builders/dirhtml.py,sha256=knJB8YAxmOj4mOx5AWpqbDxs-QVPJpZpsjuEvRzAdqg,1552
@@ -545,7 +545,7 @@ sphinx/transforms/references.py,sha256=AyYHJcv4mPfrCdD7kKn-2oLSP8oxh6GJ8rjgahVYB
 sphinx/transforms/post_transforms/__init__.py,sha256=zIroXaSf1wQb31I71TqaaQIZjW7ZbMicNuU0RC0WvBg,13086
 sphinx/transforms/post_transforms/code.py,sha256=1jUfLRdmoHJkMFbAvyY4XD5CBghZUTAouQydA_ttCk0,4496
 sphinx/transforms/post_transforms/images.py,sha256=qpUVLkjlSKzb_IzKoRXTc_Xxn6OnwizJrg45QmEb4QU,10790
-sphinx/util/__init__.py,sha256=sIasAvJMElWYQs3XkV45Wsi9mvHS4S8f9truPnSAAbU,3192
+sphinx/util/__init__.py,sha256=nTGTyMcQhKYmu2kRLZNr23UwrYjKR7Fkef71jx0Wt9c,3333
 sphinx/util/_files.py,sha256=iKEaNsz9mxspOX_F1XLmsVdBssSlCxcizTsNVdmVgaQ,2666
 sphinx/util/_importer.py,sha256=qqQWn2TAGY6FS0WJ8aDjFnUdhadDX7hVavJYEs_CAZo,885
 sphinx/util/_io.py,sha256=-KaagsRCwlKg8lpHJBf3KqCc_GD8r8BDS_veph3VTrA,894
@@ -591,8 +591,8 @@ sphinx/writers/manpage.py,sha256=R0S02xJ0YdDZ3IPh-8po5qHOPWy5bciiOpesGF9-yC8,163
 sphinx/writers/texinfo.py,sha256=-b5PgRRuoGF51OS8Gbz3hV-iA-swjT2T552tb5Bkg_4,53082
 sphinx/writers/text.py,sha256=jXEXXXCyFFLXGKatrdxipgX3cJP9Wc4-X01SQFmJAYo,43426
 sphinx/writers/xml.py,sha256=5HXyJd1sRRzY3p3sE-_esSYlQjhtW9TU6yrRPv2Uoy0,1563
-sphinx-8.1.1.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
-sphinx-8.1.1.dist-info/LICENSE.rst,sha256=uL2etL9JJaDLeIqs1Hm7ZNqo4AsoMO_3WiFzvc2zuu0,1476
-sphinx-8.1.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-sphinx-8.1.1.dist-info/METADATA,sha256=4RxAh6p0Rxqh34EiYp04xXnTTq8nAPd_fqHwX-31X6E,6351
-sphinx-8.1.1.dist-info/RECORD,,
+sphinx-8.1.2.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
+sphinx-8.1.2.dist-info/LICENSE.rst,sha256=uL2etL9JJaDLeIqs1Hm7ZNqo4AsoMO_3WiFzvc2zuu0,1476
+sphinx-8.1.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+sphinx-8.1.2.dist-info/METADATA,sha256=6ugdNy7jnGR7NieWOrHSorAi9wvBaZwwwoZrl31OQfk,6407
+sphinx-8.1.2.dist-info/RECORD,,