Skip to content

Commit 0d7b27e

Browse files
chore(deps): update dependency sphinx to v9 (#601)
This PR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---| | [sphinx](https://redirect.github.com/sphinx-doc/sphinx) ([changelog](https://www.sphinx-doc.org/en/master/changes.html)) | `>=8,<8.3` → `>=9,<9.2` | ![age](https://developer.mend.io/api/mc/badges/age/pypi/sphinx/9.1.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/sphinx/8.2.3/9.1.0?slim=true) | --- ### Release Notes <details> <summary>sphinx-doc/sphinx (sphinx)</summary> ### [`v9.1.0`](https://redirect.github.com/sphinx-doc/sphinx/blob/HEAD/CHANGES.rst#Release-910-released-Dec-31-2025) [Compare Source](https://redirect.github.com/sphinx-doc/sphinx/compare/v9.0.4...v9.1.0) \===================================== ## Dependencies - [#&#8203;14153](https://redirect.github.com/sphinx-doc/sphinx/issues/14153): Drop Python 3.11 support. - [#&#8203;12555](https://redirect.github.com/sphinx-doc/sphinx/issues/12555): Drop Docutils 0.20 support. Patch by Adam Turner ## Features added - Add :meth:`~sphinx.application.Sphinx.add_static_dir` for copying static assets from extensions to the build output. Patch by Jared Dillard ## Bugs fixed - [#&#8203;14189](https://redirect.github.com/sphinx-doc/sphinx/issues/14189): autodoc: Fix duplicate `:no-index-entry:` for modules. Patch by Adam Turner - [#&#8203;13713](https://redirect.github.com/sphinx-doc/sphinx/issues/13713): Fix compatibility with MyST-Parser. Patch by Adam Turner - Fix tests for Python 3.15. Patch by Adam Turner - [#&#8203;14089](https://redirect.github.com/sphinx-doc/sphinx/issues/14089): autodoc: Fix default option parsing. Patch by Adam Turner - Remove incorrect static typing assertions. Patch by Adam Turner - [#&#8203;14050](https://redirect.github.com/sphinx-doc/sphinx/issues/14050): LaTeXTranslator fails to build documents using the "acronym" standard role. Patch by Günter Milde - LaTeX: Fix rendering for grid filled merged vertical cell. Patch by Tim Nordell - [#&#8203;14228](https://redirect.github.com/sphinx-doc/sphinx/issues/14228): LaTeX: Fix overrun footer for cases of merged vertical table cells. Patch by Tim Nordell - [#&#8203;14207](https://redirect.github.com/sphinx-doc/sphinx/issues/14207): Fix creating `HTMLThemeFactory` objects in third-party extensions. Patch by Adam Turner - [#&#8203;3099](https://redirect.github.com/sphinx-doc/sphinx/issues/3099): LaTeX: PDF build crashes if a code-block contains more than circa 1350 codelines (about 27 a4-sized pages at default pointsize). Patch by Jean-François B. - [#&#8203;14064](https://redirect.github.com/sphinx-doc/sphinx/issues/14064): LaTeX: TABs ending up in sphinxVerbatim fail to obey tab stops. Patch by Jean-François B. - [#&#8203;14089](https://redirect.github.com/sphinx-doc/sphinx/issues/14089): autodoc: Improve support for non-weakreferencable objects. Patch by Adam Turner - LaTeX: Fix accidental removal at `3.5.0` ([#&#8203;8854](https://redirect.github.com/sphinx-doc/sphinx/issues/8854)) of the documentation of `literalblockcappos` key of :ref:`'sphinxsetup' <latexsphinxsetup>`. Patch by Jean-François B. ### [`v9.0.4`](https://redirect.github.com/sphinx-doc/sphinx/releases/tag/v9.0.4): Sphinx 9.0.4 [Compare Source](https://redirect.github.com/sphinx-doc/sphinx/compare/v9.0.3...v9.0.4) Changelog: <https://www.sphinx-doc.org/en/master/changes/9.0.html> ## Bugs fixed - [#&#8203;14143](https://redirect.github.com/sphinx-doc/sphinx/issues/14143): Fix spurious build warnings when translators reorder references in strings, or use translated display text in references. Patch by Matt Wang. ### [`v9.0.3`](https://redirect.github.com/sphinx-doc/sphinx/releases/tag/v9.0.3): Sphinx 9.0.3 [Compare Source](https://redirect.github.com/sphinx-doc/sphinx/compare/v9.0.2...v9.0.3) Changelog: <https://www.sphinx-doc.org/en/master/changes/9.0.html> ## Bugs fixed - [#&#8203;14142](https://redirect.github.com/sphinx-doc/sphinx/issues/14142): autodoc: Restore some missing exports in `sphinx.ext.autodoc`. Patch by Adam Turner. ### [`v9.0.2`](https://redirect.github.com/sphinx-doc/sphinx/releases/tag/v9.0.2): Sphinx 9.0.2 [Compare Source](https://redirect.github.com/sphinx-doc/sphinx/compare/v9.0.1...v9.0.2) Changelog: <https://www.sphinx-doc.org/en/master/changes/9.0.html> ## Bugs fixed - [#&#8203;14142](https://redirect.github.com/sphinx-doc/sphinx/issues/14142): autodoc: Restore `sphinx.ext.autodoc.mock`. Patch by Adam Turner. ### [`v9.0.1`](https://redirect.github.com/sphinx-doc/sphinx/releases/tag/v9.0.1): Sphinx 9.0.1 [Compare Source](https://redirect.github.com/sphinx-doc/sphinx/compare/v9.0.0...v9.0.1) Changelog: <https://www.sphinx-doc.org/en/master/changes/9.0.html> ## Bugs fixed - [#&#8203;13942](https://redirect.github.com/sphinx-doc/sphinx/issues/13942): autodoc: Restore the mapping interface for options objects. Patch by Adam Turner. - [#&#8203;13942](https://redirect.github.com/sphinx-doc/sphinx/issues/13942): autodoc: Deprecate the mapping interface for options objects. Patch by Adam Turner. - [#&#8203;13387](https://redirect.github.com/sphinx-doc/sphinx/issues/13387): Update translations. ### [`v9.0.0`](https://redirect.github.com/sphinx-doc/sphinx/releases/tag/v9.0.0): Sphinx 9.0.0 Changelog: <https://www.sphinx-doc.org/en/master/changes/9.0.html> ## Dependencies - [#&#8203;13786](https://redirect.github.com/sphinx-doc/sphinx/issues/13786): Support [Docutils 0.22](https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-22-2026-07-29). Patch by Adam Turner. ## Incompatible changes - [#&#8203;13639](https://redirect.github.com/sphinx-doc/sphinx/issues/13639): `SphinxComponentRegistry.create_source_parser` no longer has an *app* parameter, instead taking *config* and *env*. Patch by Adam Turner. - [#&#8203;13679](https://redirect.github.com/sphinx-doc/sphinx/issues/13679): Non-decodable characters in source files now raise an error. Such bytes have been replaced with '?' along with logging a warning since Sphinx 2.0. Patch by Adam Turner. - [#&#8203;13751](https://redirect.github.com/sphinx-doc/sphinx/issues/13751), [#&#8203;14089](https://redirect.github.com/sphinx-doc/sphinx/issues/14089): `sphinx.ext.autodoc` has been substantially rewritten, and there may be some incompatible changes in edge cases, especially when extensions interact with autodoc internals. The `autodoc_use_legacy_class_based` option has been added to use the legacy (pre-9.0) implementation of autodoc. Patches by Adam Turner. - [#&#8203;13355](https://redirect.github.com/sphinx-doc/sphinx/issues/13355): Don't include escaped title content in the search index. Patch by Will Lachance. ## Deprecated - 13627: Deprecate remaining public `app` attributes, including `builder.app`, `env.app`, `events.app`, and `SphinxTransform.app`. Patch by Adam Turner. - [#&#8203;13637](https://redirect.github.com/sphinx-doc/sphinx/issues/13637): Deprecate the `set_application` method of `Parser` objects. Patch by Adam Turner. - [#&#8203;13644](https://redirect.github.com/sphinx-doc/sphinx/issues/13644): Deprecate the `Parser.config` and `env` attributes. Patch by Adam Turner. - [#&#8203;13665](https://redirect.github.com/sphinx-doc/sphinx/issues/13665): Deprecate support for non-UTF 8 source encodings, scheduled for removal in Sphinx 10. Patch by Adam Turner. - [#&#8203;13682](https://redirect.github.com/sphinx-doc/sphinx/issues/13682): Deprecate `sphinx.io`. Sphinx no longer uses the `sphinx.io` classes, having replaced them with standard Python I/O. The entire `sphinx.io` module will be removed in Sphinx 10. Patch by Adam Turner. - [#&#8203;13631](https://redirect.github.com/sphinx-doc/sphinx/issues/13631): `sphinx.environment.adapters.toctree.global_toctree_for_doc` and `sphinx.environment.BuildEnvironment.get_and_resolve_doctree` will require a *tags* keyword argument from Sphinx 11. It may optionally be passed from Sphinx 9 onwards. Patch by Adam Turner. ## Features added - [#&#8203;13332](https://redirect.github.com/sphinx-doc/sphinx/issues/13332): Add `doctest_fail_fast` option to exit after the first failed test. Patch by Till Hoffmann. - [#&#8203;13439](https://redirect.github.com/sphinx-doc/sphinx/issues/13439): linkcheck: Permit warning on every redirect with `linkcheck_allowed_redirects = {}`. Patch by Adam Turner and James Addison. - [#&#8203;13497](https://redirect.github.com/sphinx-doc/sphinx/issues/13497): Support C domain objects in the table of contents. - [#&#8203;13500](https://redirect.github.com/sphinx-doc/sphinx/issues/13500): LaTeX: add support for `fontawesome6` package. Patch by Jean-François B. - [#&#8203;13509](https://redirect.github.com/sphinx-doc/sphinx/issues/13509): autodoc: Detect `typing_extensions.overload` and `final` decorators. Patch by Spencer Brown. - [#&#8203;13535](https://redirect.github.com/sphinx-doc/sphinx/issues/13535): html search: Update to the latest version of Snowball (v3.0.1). Patch by Adam Turner. - [#&#8203;13647](https://redirect.github.com/sphinx-doc/sphinx/issues/13647): LaTeX: allow more cases of table nesting. Patch by Jean-François B. - [#&#8203;13657](https://redirect.github.com/sphinx-doc/sphinx/issues/13657): LaTeX: support CSS3 length units. Patch by Jean-François B. - [#&#8203;13684](https://redirect.github.com/sphinx-doc/sphinx/issues/13684): intersphinx: Add a file-based cache for remote inventories. The location of the cache directory must not be relied upon externally, as it may change without notice or warning in future releases. Patch by Adam Turner. - [#&#8203;13805](https://redirect.github.com/sphinx-doc/sphinx/issues/13805): LaTeX: add support for `fontawesome7` package. Patch by Jean-François B. - [#&#8203;13508](https://redirect.github.com/sphinx-doc/sphinx/issues/13508): autodoc: Initial support for PEP 695 type aliases. Patch by Martin Matouš, Jeremy Maitin-Shepard, and Adam Turner. - [#&#8203;14023](https://redirect.github.com/sphinx-doc/sphinx/issues/14023): Add the new `mathjax_config_path` option to load MathJax configuration from a file. Patch by Randolf Scholz and Adam Turner. - [#&#8203;14046](https://redirect.github.com/sphinx-doc/sphinx/issues/14046): linkcheck: Add the `linkcheck_case_insensitive_urls` option to allow case-insensitive URL comparison for specific URL patterns. This is useful for links to websites that normalise URL casing (e.g. GitHub) or case-insensitive servers. Patch by Fazeel Usmani and James Addison. - [#&#8203;14075](https://redirect.github.com/sphinx-doc/sphinx/issues/14075): autosummary: Provide more context in import exception stack traces. Patch by Philipp A. - [#&#8203;13468](https://redirect.github.com/sphinx-doc/sphinx/issues/13468): Add config options to `sphinx.ext.duration`. Patch by Erik Bedard and Adam Turner. - [#&#8203;14022](https://redirect.github.com/sphinx-doc/sphinx/issues/14022): Use MathJax v4 by default in the `sphinx.ext.mathjax` extension, from v3 previously. To keep using an older version, set the `mathjax_path` option. Also add the new `mathjax4_config` option to configure MathJax v4. Note that MathJax v3 is mostly compatible with MathJax v4, so existing `mathjax3_config` settings should not need to change. Patch by Matthias Geier. - [#&#8203;14029](https://redirect.github.com/sphinx-doc/sphinx/issues/14029): intersphinx: Fix error in format string interpolation. Patch by Matthieu de Cibeins. ## Bugs fixed - [#&#8203;13926](https://redirect.github.com/sphinx-doc/sphinx/issues/13926): multiple py:type directives for the same canonical type no longer result in spurious duplicate object description warnings. Patch by Jeremy Maitin-Shepard. - [#&#8203;1327](https://redirect.github.com/sphinx-doc/sphinx/issues/1327): LaTeX: tables using longtable raise error if `tabularcolumns` specifies automatic widths (`L`, `R`, `C`, or `J`). Patch by Jean-François B. - [#&#8203;3447](https://redirect.github.com/sphinx-doc/sphinx/issues/3447): LaTeX: when assigning longtable class to table for PDF, it may render "horizontally" and overflow in right margin. Patch by Jean-François B. - [#&#8203;8828](https://redirect.github.com/sphinx-doc/sphinx/issues/8828): LaTeX: adding a footnote to a longtable cell causes table to occupy full width. Patch by Jean-François B. - [#&#8203;11498](https://redirect.github.com/sphinx-doc/sphinx/issues/11498): LaTeX: Table in cell fails to build if it has many rows. Patch by Jean-François B. - [#&#8203;11515](https://redirect.github.com/sphinx-doc/sphinx/issues/11515): LaTeX: longtable does not allow nested table. Patch by Jean-François B. - [#&#8203;11973](https://redirect.github.com/sphinx-doc/sphinx/issues/11973): LaTeX: links in table captions do not work in PDF. Patch by Jean-François B. - [#&#8203;12821](https://redirect.github.com/sphinx-doc/sphinx/issues/12821): LaTeX: URLs/links in section titles should render in PDF. Patch by Jean-François B. - [#&#8203;13369](https://redirect.github.com/sphinx-doc/sphinx/issues/13369): Correctly parse and cross-reference unpacked type annotations. Patch by Alicia Garcia-Raboso. - [#&#8203;13528](https://redirect.github.com/sphinx-doc/sphinx/issues/13528): Add tilde `~` prefix support for `py:deco`. Patch by Shengyu Zhang and Adam Turner. - [#&#8203;13597](https://redirect.github.com/sphinx-doc/sphinx/issues/13597): LaTeX: table nested in a merged cell leads to invalid LaTeX mark-up and PDF cannot be built. Patch by Jean-François B. - [#&#8203;13619](https://redirect.github.com/sphinx-doc/sphinx/issues/13619): LaTeX: possible duplicated footnotes in PDF from object signatures (typically if `latex_show_urls` `= 'footnote'`). Patch by Jean-François B. - [#&#8203;13635](https://redirect.github.com/sphinx-doc/sphinx/issues/13635): LaTeX: if a cell contains a table, row coloring is turned off for the next table cells. Patch by Jean-François B. - [#&#8203;13685](https://redirect.github.com/sphinx-doc/sphinx/issues/13685): gettext: Correctly ignore trailing backslashes. Patch by Bénédikt Tran. - [#&#8203;13712](https://redirect.github.com/sphinx-doc/sphinx/issues/13712): intersphinx: Don't add "v" prefix to non-numeric versions. Patch by Szymon Karpinski. - [#&#8203;13688](https://redirect.github.com/sphinx-doc/sphinx/issues/13688): HTML builder: Replace `<em class="property">` with `<span class="property">` for attribute type annotations to improve [semantic HTML structure](https://html.spec.whatwg.org/multipage/text-level-semantics.html). Patch by Mark Ostroth. - [#&#8203;13812](https://redirect.github.com/sphinx-doc/sphinx/issues/13812) (discussion): LaTeX: long `confval` value does not wrap at spaces in PDF. Patch by Jean-François B. - [#&#8203;10785](https://redirect.github.com/sphinx-doc/sphinx/issues/10785): Autodoc: Allow type aliases defined in the project to be properly cross-referenced when used as type annotations. This makes it possible for objects documented as `:py:data:` to be hyperlinked in function signatures. - [#&#8203;13858](https://redirect.github.com/sphinx-doc/sphinx/issues/13858): doctest: doctest blocks are now correctly added to a group defined by the configuration variable `doctest_test_doctest_blocks`. - [#&#8203;13885](https://redirect.github.com/sphinx-doc/sphinx/issues/13885): Coverage builder: Fix TypeError when warning about missing modules. Patch by Damien Ayers. - [#&#8203;13929](https://redirect.github.com/sphinx-doc/sphinx/issues/13929): Duplicate equation label warnings now have a new warning sub-type, `ref.equation`. Patch by Jared Dillard. - [#&#8203;13935](https://redirect.github.com/sphinx-doc/sphinx/issues/13935): autoclass: parent class members no longer considered directly defined in certain cases, depending on autodoc processing order. Patch by Jeremy Maitin-Shepard. - [#&#8203;13939](https://redirect.github.com/sphinx-doc/sphinx/issues/13939): LaTeX: page break can separate admonition title from contents. Patch by Jean-François B. - [#&#8203;14004](https://redirect.github.com/sphinx-doc/sphinx/issues/14004): Fix `autodoc_type_aliases` when they appear in PEP 604 union syntax (`Alias | Type`). Patch by Tamika Nomara. - [#&#8203;14059](https://redirect.github.com/sphinx-doc/sphinx/issues/14059): LaTeX: Footnotes cause pdflatex error with French language (since late June 2025 upstream change to LaTeX `babel-french`). Patch by Jean-François B. - [#&#8203;13916](https://redirect.github.com/sphinx-doc/sphinx/issues/13916): HTML Search: do not clear text fragments from the URL on page load. Patch by Harmen Stoppels. - [#&#8203;13944](https://redirect.github.com/sphinx-doc/sphinx/issues/13944): autodoc: show traceback during import in human readable representation. Patch by Florian Best. - [#&#8203;14006](https://redirect.github.com/sphinx-doc/sphinx/issues/14006): Support images with data URIs that aren't base64-encoded. Patch by Shengyu Zhang and Adam Turner. - [#&#8203;12797](https://redirect.github.com/sphinx-doc/sphinx/issues/12797): Fix `Some type variables (...) are not listed in Generic[...]` TypeError when inheriting from both Generic and autodoc mocked class. Patch by Ikor Jefocur and Daniel Sperber. - [#&#8203;13945](https://redirect.github.com/sphinx-doc/sphinx/issues/13945): autodoc: Fix handling of undefined names in annotations by using the `FORWARDREF` `annotationlib` format. Patch by Rui Pinheiro and Adam Turner. - [#&#8203;14067](https://redirect.github.com/sphinx-doc/sphinx/issues/14067): EPUB: unify path separators in manifest items to forward slashes; resolve duplicates in the manifest on Windows. Patch by Akihiro Takizawa. - [#&#8203;13741](https://redirect.github.com/sphinx-doc/sphinx/issues/13741): text builder: fix an infinite loop when processing CSV tables. Patch by Bénédikt Tran. - [#&#8203;13217](https://redirect.github.com/sphinx-doc/sphinx/issues/13217): Remove extra parentheses from `js:function` arguments and errors. Patch by Shengyu Zhang. </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/hetznercloud/hcloud-python). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi4xOS45IiwidXBkYXRlZEluVmVyIjoiNDIuNzQuNSIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOltdfQ==--> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
1 parent d644bc9 commit 0d7b27e

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@
4040
],
4141
extras_require={
4242
"docs": [
43-
"sphinx>=8,<8.3",
43+
"sphinx>=9,<9.2",
4444
"sphinx-rtd-theme>=3,<3.2",
4545
"myst-parser>=5,<5.1",
4646
"watchdog>=6,<6.1",

0 commit comments

Comments
 (0)