Sphinx 8.1.3__py3-none-any.whl → 8.2.0__py3-none-any.whl

sphinx/writers/texinfo.py

@@ -2,16 +2,14 @@
 
 from __future__ import annotations
 
+import os.path
 import re
 import textwrap
-from collections.abc import Iterable, Iterator
-from os import path
-from typing import TYPE_CHECKING, Any, ClassVar, cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
 
 from sphinx import __display_version__, addnodes
-from sphinx.errors import ExtensionError
 from sphinx.locale import _, __, admonitionlabels
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -19,6 +17,9 @@ from sphinx.util.i18n import format_date
 from sphinx.writers.latex import collected_footnote
 
 if TYPE_CHECKING:
+    from collections.abc import Iterable, Iterator
+    from typing import Any, ClassVar
+
     from docutils.nodes import Element, Node, Text
 
     from sphinx.builders.texinfo import TexinfoBuilder
@@ -133,7 +134,7 @@ class TexinfoWriter(writers.Writer):  # type: ignore[type-arg]
     def translate(self) -> None:
         assert isinstance(self.document, nodes.document)
         visitor = self.builder.create_translator(self.document, self.builder)
-        self.visitor = cast(TexinfoTranslator, visitor)
+        self.visitor = cast('TexinfoTranslator', visitor)
         self.document.walkabout(visitor)
         self.visitor.finish()
         for attr in self.visitor_attributes:
@@ -188,6 +189,7 @@ class TexinfoTranslator(SphinxTranslator):
         self.escape_hyphens = 0
         self.curfilestack: list[str] = []
         self.footnotestack: list[dict[str, list[collected_footnote | bool]]] = []
+        self.in_production_list = False
         self.in_footnote = 0
         self.in_samp = 0
         self.handled_abbrs: set[str] = set()
@@ -240,7 +242,7 @@ class TexinfoTranslator(SphinxTranslator):
         # filename
         if not elements['filename']:
             elements['filename'] = self.document.get('source') or 'untitled'
-            if elements['filename'][-4:] in ('.txt', '.rst'):  # type: ignore[index]
+            if elements['filename'][-4:] in {'.txt', '.rst'}:  # type: ignore[index]
                 elements['filename'] = elements['filename'][:-4]  # type: ignore[index]
             elements['filename'] += '.info'  # type: ignore[operator]
         # direntry
@@ -250,9 +252,10 @@ class TexinfoTranslator(SphinxTranslator):
                 '(%s)' % elements['filename'],
                 self.escape_arg(self.settings.texinfo_dir_description),
             )
-            elements['direntry'] = (
-                '@dircategory %s\n' '@direntry\n' '%s' '@end direntry\n'
-            ) % (self.escape_id(self.settings.texinfo_dir_category), entry)
+            elements['direntry'] = '@dircategory %s\n@direntry\n%s@end direntry\n' % (
+                self.escape_id(self.settings.texinfo_dir_category),
+                entry,
+            )
         elements['copying'] = COPYING % elements
         # allow the user to override them all
         elements.update(self.settings.texinfo_elements)
@@ -287,7 +290,7 @@ class TexinfoTranslator(SphinxTranslator):
         ]
         # each section is also a node
         for section in self.document.findall(nodes.section):
-            title = cast(nodes.TextElement, section.next_node(nodes.Titular))  # type: ignore[type-var]
+            title = cast('nodes.TextElement', section.next_node(nodes.Titular))  # type: ignore[type-var]
             name = title.astext() if title else '<untitled>'
             section['node_name'] = add_node_name(name)
 
@@ -448,10 +451,10 @@ class TexinfoTranslator(SphinxTranslator):
             for subentry in entries:
                 _add_detailed_menu(subentry)
 
-        self.body.append('\n@detailmenu\n' ' --- The Detailed Node Listing ---\n')
+        self.body.append('\n@detailmenu\n --- The Detailed Node Listing ---\n')
         for entry in entries:
             _add_detailed_menu(entry)
-        self.body.append('\n@end detailmenu\n' '@end menu\n')
+        self.body.append('\n@end detailmenu\n@end menu\n')
 
     def tex_image_length(self, width_str: str) -> str:
         match = re.match(r'(\d*\.?\d*)\s*(\S*)', width_str)
@@ -491,7 +494,7 @@ class TexinfoTranslator(SphinxTranslator):
                 indices_config = frozenset(indices_config)
             else:
                 check_names = False
-            for domain in self.builder.env.domains.sorted():
+            for domain in self._domains.sorted():
                 for index_cls in domain.indices:
                     index_name = f'{domain.name}-{index_cls.name}'
                     if check_names and index_name not in indices_config:
@@ -505,7 +508,7 @@ class TexinfoTranslator(SphinxTranslator):
                             generate(content, collapsed),
                         ))
         # only add the main Index if it's not empty
-        domain = self.builder.env.domains.index_domain
+        domain = self._domains.index_domain
         for docname in self.builder.docnames:
             if domain.entries[docname]:
                 self.indices.append((_('Index'), '\n@printindex ge\n'))
@@ -529,7 +532,7 @@ class TexinfoTranslator(SphinxTranslator):
 
         fnotes: dict[str, list[collected_footnote | bool]] = {}
         for fn in footnotes_under(node):
-            label = cast(nodes.label, fn[0])
+            label = cast('nodes.label', fn[0])
             num = label.astext().strip()
             fnotes[num] = [collected_footnote('', *fn.children), False]
         return fnotes
@@ -608,7 +611,7 @@ class TexinfoTranslator(SphinxTranslator):
             self.add_anchor(id, node)
 
         self.next_section_ids.clear()
-        self.previous_section = cast(nodes.section, node)
+        self.previous_section = cast('nodes.section', node)
         self.section_level += 1
 
     def depart_section(self, node: Element) -> None:
@@ -657,7 +660,7 @@ class TexinfoTranslator(SphinxTranslator):
         self.body.append('\n\n')
 
     def visit_rubric(self, node: Element) -> None:
-        if len(node) == 1 and node.astext() in ('Footnotes', _('Footnotes')):
+        if len(node) == 1 and node.astext() in {'Footnotes', _('Footnotes')}:
             raise nodes.SkipNode
         try:
             rubric = self.rubrics[self.section_level]
@@ -1109,7 +1112,7 @@ class TexinfoTranslator(SphinxTranslator):
 
     def visit_admonition(self, node: Element, name: str = '') -> None:
         if not name:
-            title = cast(nodes.title, node[0])
+            title = cast('nodes.title', node[0])
             name = self.escape(title.astext())
         self.body.append('\n@cartouche\n@quotation %s ' % name)
 
@@ -1119,7 +1122,7 @@ class TexinfoTranslator(SphinxTranslator):
 
     def depart_admonition(self, node: Element) -> None:
         self.ensure_eol()
-        self.body.append('@end quotation\n' '@end cartouche\n')
+        self.body.append('@end quotation\n@end cartouche\n')
 
     visit_attention = _visit_named_admonition
     depart_attention = depart_admonition
@@ -1170,9 +1173,9 @@ class TexinfoTranslator(SphinxTranslator):
 
     def visit_topic(self, node: Element) -> None:
         # ignore TOC's since we have to have a "menu" anyway
-        if 'contents' in node.get('classes', []):
+        if 'contents' in node.get('classes', ()):
             raise nodes.SkipNode
-        title = cast(nodes.title, node[0])
+        title = cast('nodes.title', node[0])
         self.visit_rubric(title)
         self.body.append('%s\n' % self.escape(title.astext()))
         self.depart_rubric(title)
@@ -1231,12 +1234,12 @@ class TexinfoTranslator(SphinxTranslator):
         if uri.find('://') != -1:
             # ignore remote images
             return
-        name, ext = path.splitext(uri)
+        name, ext = os.path.splitext(uri)
         # width and height ignored in non-tex output
         width = self.tex_image_length(node.get('width', ''))
         height = self.tex_image_length(node.get('height', ''))
         alt = self.escape_arg(node.get('alt', ''))
-        filename = f"{self.elements['filename'][:-5]}-figures/{name}"  # type: ignore[index]
+        filename = f'{self.elements["filename"][:-5]}-figures/{name}'  # type: ignore[index]
         self.body.append(f'\n@image{{{filename},{width},{height},{alt},{ext[1:]}}}\n')
 
     def depart_image(self, node: Element) -> None:
@@ -1280,7 +1283,7 @@ class TexinfoTranslator(SphinxTranslator):
 
     def visit_system_message(self, node: Element) -> None:
         self.body.append(
-            '\n@verbatim\n' '<SYSTEM MESSAGE: %s>\n' '@end verbatim\n' % node.astext()
+            '\n@verbatim\n<SYSTEM MESSAGE: %s>\n@end verbatim\n' % node.astext()
         )
         raise nodes.SkipNode
 
@@ -1306,21 +1309,11 @@ class TexinfoTranslator(SphinxTranslator):
 
     def visit_productionlist(self, node: Element) -> None:
         self.visit_literal_block(None)
-        productionlist = cast(Iterable[addnodes.production], node)
-        names = (production['tokenname'] for production in productionlist)
-        maxlen = max(len(name) for name in names)
-
-        for production in productionlist:
-            if production['tokenname']:
-                for id in production.get('ids'):
-                    self.add_anchor(id, production)
-                s = production['tokenname'].ljust(maxlen) + ' ::='
-            else:
-                s = '%s    ' % (' ' * maxlen)
-            self.body.append(self.escape(s))
-            self.body.append(self.escape(production.astext() + '\n'))
+        self.in_production_list = True
+
+    def depart_productionlist(self, node: Element) -> None:
+        self.in_production_list = False
         self.depart_literal_block(None)
-        raise nodes.SkipNode
 
     def visit_production(self, node: Element) -> None:
         pass
@@ -1335,9 +1328,15 @@ class TexinfoTranslator(SphinxTranslator):
         self.body.append('}')
 
     def visit_literal_strong(self, node: Element) -> None:
+        if self.in_production_list:
+            for id_ in node['ids']:
+                self.add_anchor(id_, node)
+            return
         self.body.append('@code{')
 
     def depart_literal_strong(self, node: Element) -> None:
+        if self.in_production_list:
+            return
         self.body.append('}')
 
     def visit_index(self, node: Element) -> None:
@@ -1387,8 +1386,8 @@ class TexinfoTranslator(SphinxTranslator):
         pass
 
     def visit_acks(self, node: Element) -> None:
-        bullet_list = cast(nodes.bullet_list, node[0])
-        list_items = cast(Iterable[nodes.list_item], bullet_list)
+        bullet_list = cast('nodes.bullet_list', node[0])
+        list_items = cast('Iterable[nodes.list_item]', bullet_list)
         self.body.append('\n\n')
         self.body.append(', '.join(n.astext() for n in list_items) + '.')
         self.body.append('\n\n')
@@ -1418,11 +1417,11 @@ class TexinfoTranslator(SphinxTranslator):
                 self.add_anchor(id, node)
         # use the full name of the objtype for the category
         try:
-            domain = self.builder.env.get_domain(node.parent['domain'])
+            domain = self._domains[node.parent['domain']]
             name = domain.get_type_name(
                 domain.object_types[objtype], self.config.primary_domain == domain.name
             )
-        except (KeyError, ExtensionError):
+        except KeyError:
             name = objtype
         # by convention, the deffn category should be capitalized like a title
         category = self.escape_arg(smart_capwords(name))
@@ -1501,7 +1500,7 @@ class TexinfoTranslator(SphinxTranslator):
             self.first_param = 0
         text = self.escape(node.astext())
         # replace no-break spaces with normal ones
-        text = text.replace(' ', '@w{ }')
+        text = text.replace('\N{NO-BREAK SPACE}', '@w{ }')
         self.body.append(text)
         raise nodes.SkipNode
 
@@ -1538,10 +1537,11 @@ class TexinfoTranslator(SphinxTranslator):
         pass
 
     def visit_abbreviation(self, node: Element) -> None:
+        explanation = node.get('explanation', '')
         abbr = node.astext()
         self.body.append('@abbr{')
-        if node.hasattr('explanation') and abbr not in self.handled_abbrs:
-            self.context.append(',%s}' % self.escape_arg(node['explanation']))
+        if explanation and abbr not in self.handled_abbrs:
+            self.context.append(',%s}' % self.escape_arg(explanation))
             self.handled_abbrs.add(abbr)
         else:
             self.context.append('}')
@@ -1579,11 +1579,11 @@ class TexinfoTranslator(SphinxTranslator):
     def depart_pending_xref(self, node: Element) -> None:
         pass
 
-    def visit_math(self, node: Element) -> None:
+    def visit_math(self, node: nodes.math) -> None:
         self.body.append('@math{' + self.escape_arg(node.astext()) + '}')
         raise nodes.SkipNode
 
-    def visit_math_block(self, node: Element) -> None:
+    def visit_math_block(self, node: nodes.math_block) -> None:
         if node.get('label'):
             self.add_anchor(node['label'], node)
         self.body.append(

sphinx/writers/text.py

@@ -6,9 +6,8 @@ import math
 import os
 import re
 import textwrap
-from collections.abc import Iterable, Iterator, Sequence
 from itertools import chain, groupby, pairwise
-from typing import TYPE_CHECKING, Any, ClassVar, cast
+from typing import TYPE_CHECKING, cast
 
 from docutils import nodes, writers
 from docutils.utils import column_width
@@ -18,6 +17,9 @@ from sphinx.locale import _, admonitionlabels
 from sphinx.util.docutils import SphinxTranslator
 
 if TYPE_CHECKING:
+    from collections.abc import Iterable, Iterator, Sequence
+    from typing import Any, ClassVar
+
     from docutils.nodes import Element, Text
 
     from sphinx.builders.text import TextBuilder
@@ -45,7 +47,7 @@ class Cell:
         return hash((self.col, self.row))
 
     def __bool__(self) -> bool:
-        return self.text != '' and self.col is not None and self.row is not None
+        return bool(self.text) and self.col is not None and self.row is not None
 
     def wrap(self, width: int) -> None:
         self.wrapped = my_wrap(self.text, width)
@@ -292,7 +294,7 @@ class TextWrapper(textwrap.TextWrapper):
 
             width = self.width - column_width(indent)
 
-            if self.drop_whitespace and chunks[-1].strip() == '' and lines:
+            if self.drop_whitespace and not chunks[-1].strip() and lines:
                 del chunks[-1]
 
             while chunks:
@@ -308,7 +310,7 @@ class TextWrapper(textwrap.TextWrapper):
             if chunks and column_width(chunks[-1]) > width:
                 self._handle_long_word(chunks, cur_line, cur_len, width)
 
-            if self.drop_whitespace and cur_line and cur_line[-1].strip() == '':
+            if self.drop_whitespace and cur_line and not cur_line[-1].strip():
                 del cur_line[-1]
 
             if cur_line:
@@ -381,7 +383,7 @@ class TextWriter(writers.Writer):  # type: ignore[type-arg]
         assert isinstance(self.document, nodes.document)
         visitor = self.builder.create_translator(self.document, self.builder)
         self.document.walkabout(visitor)
-        self.output = cast(TextTranslator, visitor).body
+        self.output = cast('TextTranslator', visitor).body
 
 
 class TextTranslator(SphinxTranslator):
@@ -406,6 +408,7 @@ class TextTranslator(SphinxTranslator):
         self.sectionlevel = 0
         self.lineblocklevel = 0
         self.table: Table
+        self.in_production_list = False
 
         self.context: list[str] = []
         """Heterogeneous stack.
@@ -646,6 +649,7 @@ class TextTranslator(SphinxTranslator):
         self.required_params_left = sum(self.list_is_required_param)
         self.param_separator = ', '
         self.multi_line_parameter_list = node.get('multi_line_parameter_list', False)
+        self.trailing_comma = node.get('multi_line_trailing_comma', False)
         if self.multi_line_parameter_list:
             self.param_separator = self.param_separator.rstrip()
         self.context.append(sig_close_paren)
@@ -697,7 +701,8 @@ class TextTranslator(SphinxTranslator):
                 or is_required
                 and (is_last_group or next_is_required)
             ):
-                self.add_text(self.param_separator)
+                if not is_last_group or opt_param_left_at_level or self.trailing_comma:
+                    self.add_text(self.param_separator)
                 self.end_state(wrap=False, end=None)
 
         elif self.required_params_left:
@@ -738,20 +743,27 @@ class TextTranslator(SphinxTranslator):
 
     def depart_desc_optional(self, node: Element) -> None:
         self.optional_param_level -= 1
+        level = self.optional_param_level
         if self.multi_line_parameter_list:
+            max_level = self.max_optional_param_level
+            len_lirp = len(self.list_is_required_param)
+            is_last_group = self.param_group_index + 1 == len_lirp
             # If it's the first time we go down one level, add the separator before the
-            # bracket.
-            if self.optional_param_level == self.max_optional_param_level - 1:
+            # bracket, except if this is the last parameter and the parameter list
+            # should not feature a trailing comma.
+            if level == max_level - 1 and (
+                not is_last_group or level > 0 or self.trailing_comma
+            ):
                 self.add_text(self.param_separator)
             self.add_text(']')
             # End the line if we have just closed the last bracket of this group of
             # optional parameters.
-            if self.optional_param_level == 0:
+            if level == 0:
                 self.end_state(wrap=False, end=None)
 
         else:
             self.add_text(']')
-        if self.optional_param_level == 0:
+        if level == 0:
             self.param_group_index += 1
 
     def visit_desc_annotation(self, node: Element) -> None:
@@ -776,22 +788,20 @@ class TextTranslator(SphinxTranslator):
 
     def visit_productionlist(self, node: Element) -> None:
         self.new_state()
-        productionlist = cast(Iterable[addnodes.production], node)
-        names = (production['tokenname'] for production in productionlist)
-        maxlen = max(len(name) for name in names)
-        lastname = None
-        for production in productionlist:
-            if production['tokenname']:
-                self.add_text(production['tokenname'].ljust(maxlen) + ' ::=')
-                lastname = production['tokenname']
-            elif lastname is not None:
-                self.add_text('%s    ' % (' ' * len(lastname)))
-            self.add_text(production.astext() + self.nl)
+        self.in_production_list = True
+
+    def depart_productionlist(self, node: Element) -> None:
+        self.in_production_list = False
         self.end_state(wrap=False)
-        raise nodes.SkipNode
+
+    def visit_production(self, node: Element) -> None:
+        pass
+
+    def depart_production(self, node: Element) -> None:
+        pass
 
     def visit_footnote(self, node: Element) -> None:
-        label = cast(nodes.label, node[0])
+        label = cast('nodes.label', node[0])
         self._footnote = label.astext().strip()
         self.new_state(len(self._footnote) + 3)
 
@@ -923,8 +933,8 @@ class TextTranslator(SphinxTranslator):
         self.end_state(wrap=False)
 
     def visit_acks(self, node: Element) -> None:
-        bullet_list = cast(nodes.bullet_list, node[0])
-        list_items = cast(Iterable[nodes.list_item], bullet_list)
+        bullet_list = cast('nodes.bullet_list', node[0])
+        list_items = cast('Iterable[nodes.list_item]', bullet_list)
         self.new_state(0)
         self.add_text(', '.join(n.astext() for n in list_items) + '.')
         self.end_state()
@@ -1214,17 +1224,21 @@ class TextTranslator(SphinxTranslator):
         self.add_text('**')
 
     def visit_literal_strong(self, node: Element) -> None:
+        if self.in_production_list:
+            return
         self.add_text('**')
 
     def depart_literal_strong(self, node: Element) -> None:
+        if self.in_production_list:
+            return
         self.add_text('**')
 
     def visit_abbreviation(self, node: Element) -> None:
         self.add_text('')
 
     def depart_abbreviation(self, node: Element) -> None:
-        if node.hasattr('explanation'):
-            self.add_text(' (%s)' % node['explanation'])
+        if explanation := node.get('explanation', ''):
+            self.add_text(f' ({explanation})')
 
     def visit_manpage(self, node: Element) -> None:
         return self.visit_literal_emphasis(node)
@@ -1239,9 +1253,13 @@ class TextTranslator(SphinxTranslator):
         self.add_text('*')
 
     def visit_literal(self, node: Element) -> None:
+        if self.in_production_list:
+            return
         self.add_text('"')
 
     def depart_literal(self, node: Element) -> None:
+        if self.in_production_list:
+            return
         self.add_text('"')
 
     def visit_subscript(self, node: Element) -> None:
@@ -1316,14 +1334,14 @@ class TextTranslator(SphinxTranslator):
             self.end_state(wrap=False)
         raise nodes.SkipNode
 
-    def visit_math(self, node: Element) -> None:
+    def visit_math(self, node: nodes.math) -> None:
         pass
 
-    def depart_math(self, node: Element) -> None:
+    def depart_math(self, node: nodes.math) -> None:
         pass
 
-    def visit_math_block(self, node: Element) -> None:
+    def visit_math_block(self, node: nodes.math_block) -> None:
         self.new_state()
 
-    def depart_math_block(self, node: Element) -> None:
+    def depart_math_block(self, node: nodes.math_block) -> None:
         self.end_state()

sphinx/writers/xml.py

@@ -2,11 +2,13 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 from docutils.writers.docutils_xml import Writer as BaseXMLWriter
 
 if TYPE_CHECKING:
+    from typing import Any
+
     from sphinx.builders import Builder
 
 
@@ -16,19 +18,20 @@ class XMLWriter(BaseXMLWriter):  # type: ignore[misc]
     def __init__(self, builder: Builder) -> None:
         super().__init__()
         self.builder = builder
-
-        # A lambda function to generate translator lazily
-        self.translator_class = lambda document: self.builder.create_translator(
-            document
-        )
+        self._config = builder.config
 
     def translate(self, *args: Any, **kwargs: Any) -> None:
         self.document.settings.newlines = self.document.settings.indents = (
-            self.builder.env.config.xml_pretty
+            self._config.xml_pretty
         )
         self.document.settings.xml_declaration = True
         self.document.settings.doctype_declaration = True
-        return super().translate()
+
+        # copied from docutils.writers.docutils_xml.Writer.translate()
+        # so that we can override the translator class
+        self.visitor = visitor = self.builder.create_translator(self.document)
+        self.document.walkabout(visitor)
+        self.output = ''.join(visitor.output)  # type: ignore[attr-defined]
 
 
 class PseudoXMLWriter(BaseXMLWriter):  # type: ignore[misc]

{sphinx-8.1.3.dist-info → sphinx-8.2.0.dist-info}/LICENSE.rst

@@ -4,7 +4,7 @@ License for Sphinx
 Unless otherwise indicated, all code in the Sphinx project is licenced under the
 two clause BSD licence below.
 
-Copyright (c) 2007-2024 by the Sphinx team (see AUTHORS file).
+Copyright (c) 2007-2025 by the Sphinx team (see AUTHORS file).
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

{sphinx-8.1.3.dist-info → sphinx-8.2.0.dist-info}/METADATA

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: Sphinx
-Version: 8.1.3
+Version: 8.2.0
 Summary: Python documentation generator
-Author-email: Georg Brandl <georg@python.org>
-Requires-Python: >=3.10
+Author-email: Adam Turner <aa-turner@users.noreply.github.com>, Georg Brandl <georg@python.org>
+Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -11,6 +11,8 @@ Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Other Audience
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: BSD License
@@ -18,10 +20,10 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Framework :: Sphinx
@@ -30,17 +32,24 @@ Classifier: Framework :: Sphinx :: Extension
 Classifier: Framework :: Sphinx :: Theme
 Classifier: Topic :: Documentation
 Classifier: Topic :: Documentation :: Sphinx
+Classifier: Topic :: Education
 Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
 Classifier: Topic :: Printing
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Editors :: Documentation
 Classifier: Topic :: Text Processing
 Classifier: Topic :: Text Processing :: General
 Classifier: Topic :: Text Processing :: Indexing
 Classifier: Topic :: Text Processing :: Markup
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Text Processing :: Markup :: reStructuredText
+Classifier: Topic :: Text Processing :: Markup :: XML
 Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
 Requires-Dist: sphinxcontrib-applehelp>=1.0.7
 Requires-Dist: sphinxcontrib-devhelp>=1.0.6
 Requires-Dist: sphinxcontrib-htmlhelp>=2.0.6
@@ -55,25 +64,26 @@ Requires-Dist: babel>=2.13
 Requires-Dist: alabaster>=0.7.14
 Requires-Dist: imagesize>=1.3
 Requires-Dist: requests>=2.30.0
+Requires-Dist: roman-numerals-py>=1.0.0
 Requires-Dist: packaging>=23.0
-Requires-Dist: tomli>=2; python_version < '3.11'
 Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
 Requires-Dist: sphinxcontrib-websupport ; extra == "docs"
-Requires-Dist: flake8>=6.0 ; extra == "lint"
-Requires-Dist: ruff==0.6.9 ; extra == "lint"
-Requires-Dist: mypy==1.11.1 ; extra == "lint"
+Requires-Dist: ruff==0.9.6 ; extra == "lint"
+Requires-Dist: mypy==1.15.0 ; extra == "lint"
 Requires-Dist: sphinx-lint>=0.9 ; extra == "lint"
 Requires-Dist: types-colorama==0.4.15.20240311 ; extra == "lint"
 Requires-Dist: types-defusedxml==0.7.0.20240218 ; extra == "lint"
-Requires-Dist: types-docutils==0.21.0.20241005 ; extra == "lint"
+Requires-Dist: types-docutils==0.21.0.20241128 ; extra == "lint"
 Requires-Dist: types-Pillow==10.2.0.20240822 ; extra == "lint"
-Requires-Dist: types-Pygments==2.18.0.20240506 ; extra == "lint"
-Requires-Dist: types-requests==2.32.0.20240914 ; extra == "lint"
+Requires-Dist: types-Pygments==2.19.0.20250107 ; extra == "lint"
+Requires-Dist: types-requests==2.32.0.20241016 ; extra == "lint"
 Requires-Dist: types-urllib3==1.26.25.14 ; extra == "lint"
-Requires-Dist: tomli>=2 ; extra == "lint"
-Requires-Dist: pyright==1.1.384 ; extra == "lint"
-Requires-Dist: pytest>=6.0 ; extra == "lint"
+Requires-Dist: pyright==1.1.394 ; extra == "lint"
+Requires-Dist: pytest>=8.0 ; extra == "lint"
+Requires-Dist: pypi-attestations==0.0.21 ; extra == "lint"
+Requires-Dist: betterproto==2.0.0b6 ; extra == "lint"
 Requires-Dist: pytest>=8.0 ; extra == "test"
+Requires-Dist: pytest-xdist[psutil]>=3.4 ; extra == "test"
 Requires-Dist: defusedxml>=0.7.1 ; extra == "test"
 Requires-Dist: cython>=3.0 ; extra == "test"
 Requires-Dist: setuptools>=70.0 ; extra == "test"