deps: update dependency sphinx to >=7.3.4,<7.4 (#383)

[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [sphinx](https://togithub.com/sphinx-doc/sphinx)
([changelog](https://www.sphinx-doc.org/en/master/changes.html)) |
`>=7.2.2,<7.3` -> `>=7.3.4,<7.4` |
[![age](https://developer.mend.io/api/mc/badges/age/pypi/sphinx/7.3.4?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|
[![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/sphinx/7.3.4?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|
[![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/sphinx/7.2.6/7.3.4?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|
[![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/sphinx/7.2.6/7.3.4?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|

---

### Release Notes

<details>
<summary>sphinx-doc/sphinx (sphinx)</summary>

###
[`v7.3.4`](https://togithub.com/sphinx-doc/sphinx/releases/tag/v7.3.4):
Sphinx 7.3.4

[Compare
Source](https://togithub.com/sphinx-doc/sphinx/compare/v7.3.3...v7.3.4)

Changelog: https://www.sphinx-doc.org/en/master/changes.html

###
[`v7.3.3`](https://togithub.com/sphinx-doc/sphinx/blob/HEAD/CHANGES.rst#Release-733-in-development)

[Compare
Source](https://togithub.com/sphinx-doc/sphinx/compare/v7.3.2...v7.3.3)

\==============================

## Bugs fixed

- [#&#8203;12290](https://togithub.com/sphinx-doc/sphinx/issues/12290):
Fix a false-positive warning when setting a configuration value
with `Any` as the valid type to a type other than the value's default.
    Patch by Adam Turner.

###
[`v7.3.2`](https://togithub.com/sphinx-doc/sphinx/blob/HEAD/CHANGES.rst#Release-732-released-Apr-17-2024)

[Compare
Source](https://togithub.com/sphinx-doc/sphinx/compare/v7.3.1...v7.3.2)

\=====================================

## Bugs fixed

-   Preload all themes defined via entry points.
    Patch by Adam Turner.
- Fix a bad interaction between the `'Furo'` theme and the new-style for
    configuration values.
    Patch by Adam Turner.

###
[`v7.3.1`](https://togithub.com/sphinx-doc/sphinx/blob/HEAD/CHANGES.rst#Release-731-released-Apr-17-2024)

[Compare
Source](https://togithub.com/sphinx-doc/sphinx/compare/v7.3.0...v7.3.1)

\=====================================

## Dependencies

-   Require `tomli` on Python 3.10 and earlier.
    Patch by Adam Turner.

###
[`v7.3.0`](https://togithub.com/sphinx-doc/sphinx/blob/HEAD/CHANGES.rst#Release-730-released-Apr-16-2024)

[Compare
Source](https://togithub.com/sphinx-doc/sphinx/compare/v7.2.6...v7.3.0)

\=====================================

## Dependencies

- [#&#8203;11411](https://togithub.com/sphinx-doc/sphinx/issues/11411):
Support `Docutils 0.21`\_. Patch by Adam Turner.

.. \_Docutils 0.21:
https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09

- [#&#8203;12012](https://togithub.com/sphinx-doc/sphinx/issues/12012):
Use `types-docutils` instead of `docutils-stubs`.

## Deprecated

- [#&#8203;11693](https://togithub.com/sphinx-doc/sphinx/issues/11693):
Support for old-style :file:`Makefile` and :file:`make.bat` output
in :program:`sphinx-quickstart`, and the associated options
:option:`!-M`,
:option:`!-m`, :option:`!--no-use-make-mode`, and
:option:`!--use-make-mode`.
- [#&#8203;11285](https://togithub.com/sphinx-doc/sphinx/issues/11285):
Direct access to :attr:`!sphinx.testing.util.SphinxTestApp._status`
or :attr:`!sphinx.testing.util.SphinxTestApp._warning` is deprecated.
Use
the public properties :attr:`!sphinx.testing.util.SphinxTestApp.status`
    and :attr:`!sphinx.testing.util.SphinxTestApp.warning` instead.
    Patch by Bénédikt Tran.
- tests: :func:`!sphinx.testing.util.strip_escseq` is deprecated in
favour of
    :func:`!sphinx.util.console.strip_colors`.
    Patch by Bénédikt Tran.

## Features added

- [#&#8203;12265](https://togithub.com/sphinx-doc/sphinx/issues/12265):
Support theme configuration via `theme.toml`.
- [#&#8203;11701](https://togithub.com/sphinx-doc/sphinx/issues/11701):
HTML Search: Adopt the new `\<search\>`\_ element.
    Patch by Bénédikt Tran.

.. \_`\<search\>`:
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/search
- [#&#8203;11803](https://togithub.com/sphinx-doc/sphinx/issues/11803):
autodoc: Use an overriden `__repr__()` function in an enum,
    if defined. Patch by Shengyu Zhang.
- [#&#8203;11892](https://togithub.com/sphinx-doc/sphinx/issues/11892):
Improved performance when resolving cross references in the C++ domain.
    Patch by Rouslan Korneychuk.
- [#&#8203;11981](https://togithub.com/sphinx-doc/sphinx/issues/11981):
Improve rendering of signatures using `slice` syntax,
    e.g., `def foo(arg: np.float64[:,:]) -> None: ...`.
-   The manpage builder now adds `OSC 8`\_ anchors to hyperlinks, using
    the `groff`\_ device control command.

.. \_OSC 8:
https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
.. \_groff:
https://lists.gnu.org/archive/html/groff/2021-10/msg00000.html
- [#&#8203;11015](https://togithub.com/sphinx-doc/sphinx/issues/11015):
Change the text of the :rst:dir:`versionadded` directive from
    `New in [...]` to `Added in [...]`.
    Patch by Bénédikt Tran.
- [#&#8203;12131](https://togithub.com/sphinx-doc/sphinx/issues/12131):
Added :confval:`show_warning_types` configuration option.
    Patch by Chris Sewell.
- [#&#8203;12193](https://togithub.com/sphinx-doc/sphinx/issues/12193):
Improve `external` warnings for unknown roles.
In particular, suggest related role names if an object type is
mistakenly used.
    Patch by Chris Sewell.
-   Add public type alias :class:`sphinx.util.typing.ExtensionMetadata`.
    This can be used by extension developers
    to annotate the return type of their `setup` function.
    Patch by Chris Sewell.

## Bugs fixed

- [#&#8203;11668](https://togithub.com/sphinx-doc/sphinx/issues/11668):
Raise a useful error when `theme.conf` is missing.
    Patch by Vinay Sajip.
- [#&#8203;11622](https://togithub.com/sphinx-doc/sphinx/issues/11622):
Ensure that the order of keys in `searchindex.js` is deterministic.
    Patch by Pietro Albini.
- [#&#8203;11617](https://togithub.com/sphinx-doc/sphinx/issues/11617):
ANSI control sequences are stripped from the output when writing to
    a warnings file with :option:`-w <sphinx-build -w>`.
    Patch by Bénédikt Tran.
- [#&#8203;11666](https://togithub.com/sphinx-doc/sphinx/issues/11666):
Skip all hidden directories in `CatalogRepository.pofiles`.
    Patch by Aryaz Eghbali.
- [#&#8203;9686](https://togithub.com/sphinx-doc/sphinx/issues/9686):
html builder: Fix MathJax lazy loading when equations appear in titles.
    Patch by Bénédikt Tran.
- [#&#8203;11483](https://togithub.com/sphinx-doc/sphinx/issues/11483):
singlehtml builder: Fix MathJax lazy loading when the index does not
    contain any math equations.
    Patch by Bénédikt Tran.
- [#&#8203;11697](https://togithub.com/sphinx-doc/sphinx/issues/11697):
HTML Search: add 'noindex' meta robots tag.
    Patch by James Addison.
- [#&#8203;11678](https://togithub.com/sphinx-doc/sphinx/issues/11678):
Fix a possible `ZeroDivisionError` in `sphinx.ext.coverage`.
    Patch by Stephen Finucane.
- [#&#8203;11756](https://togithub.com/sphinx-doc/sphinx/issues/11756):
LaTeX: build error with recent TeXLive due to missing `substitutefont`
    package (triggered if using `fontenc` with `T2A` option and document
    language is not a Cyrillic one).
    Patch by Jean-François B.
- [#&#8203;11675](https://togithub.com/sphinx-doc/sphinx/issues/11675):
Fix rendering of progression bars in environments that do not support
    ANSI control sequences.
    Patch by Bénédikt Tran.
- [#&#8203;11715](https://togithub.com/sphinx-doc/sphinx/issues/11715):
Apply `tls_verify` and `tls_cacerts` config to
    `ImageDownloader`.
    Patch by Nick Touran.
- [#&#8203;11433](https://togithub.com/sphinx-doc/sphinx/issues/11433):
Added the :confval:`linkcheck_allow_unauthorized` configuration option.
    Set this option to `False` to report HTTP 401 (unauthorized) server
    responses as broken.
    Patch by James Addison.
- [#&#8203;11868](https://togithub.com/sphinx-doc/sphinx/issues/11868):
linkcheck: added a distinct `timeout` reporting status code.
This can be enabled by setting
:confval:`linkcheck_report_timeouts_as_broken`
    to `False`.
    Patch by James Addison.
- [#&#8203;11869](https://togithub.com/sphinx-doc/sphinx/issues/11869):
Refresh the documentation for the `linkcheck_timeout` setting.
    Patch by James Addison.
- [#&#8203;11874](https://togithub.com/sphinx-doc/sphinx/issues/11874):
Configure a default 30-second value for `linkcheck_timeout`.
    Patch by James Addison.
- [#&#8203;11886](https://togithub.com/sphinx-doc/sphinx/issues/11886):
Print the Jinja2 template path chain in `TemplateNotFound` exceptions.
    Patch by Colin Marquardt.
- [#&#8203;11598](https://togithub.com/sphinx-doc/sphinx/issues/11598):
Do not use query components in URLs for assets in EPUB rendering.
    Patch by David Runge.
- [#&#8203;11917](https://togithub.com/sphinx-doc/sphinx/issues/11917):
Fix rendering of annotated inherited members for Python 3.9.
    Patch by Janet Carson.
- [#&#8203;11925](https://togithub.com/sphinx-doc/sphinx/issues/11925):
Blacklist the `sphinxprettysearchresults` extension; the functionality
    it provides was merged into Sphinx v2.0.0.
    Patch by James Addison.
- [#&#8203;11353](https://togithub.com/sphinx-doc/sphinx/issues/11353):
Support enumeration classes inheriting from mixin or data types.
    Patch by Bénédikt Tran.
- [#&#8203;11962](https://togithub.com/sphinx-doc/sphinx/issues/11962):
Fix target resolution when using `:paramtype:` fields.
    Patch by Bénédikt Tran.
- [#&#8203;12008](https://togithub.com/sphinx-doc/sphinx/issues/12008):
Fix case-sensitive lookup of `std:label` names in intersphinx inventory.
    Patch by Michael Goerz.
- [#&#8203;11959](https://togithub.com/sphinx-doc/sphinx/issues/11959):
Fix multiple term matching when word appears in both title and document.
    Patch by Will Lachance.
- [#&#8203;11958](https://togithub.com/sphinx-doc/sphinx/issues/11958):
HTML Search: Fix partial matches overwriting full matches.
    Patch by William Lachance.
- [#&#8203;11944](https://togithub.com/sphinx-doc/sphinx/issues/11944):
Use anchor in search preview.
    Patch by Will Lachance.
- [#&#8203;11474](https://togithub.com/sphinx-doc/sphinx/issues/11474):
Fix doctrees caching causing files not be rebuilt in some cases,
    e.g., when :confval:`numfig` is `True`.
    Patch by Bénédikt Tran.
- [#&#8203;11278](https://togithub.com/sphinx-doc/sphinx/issues/11278):
autodoc: Fix rendering of :class:`functools.singledispatchmethod`
    combined with :func:`@classmethod <classmethod>`.
    Patch by Bénédikt Tran.
- [#&#8203;11894](https://togithub.com/sphinx-doc/sphinx/issues/11894):
Do not add checksums to css files if building using the htmlhelp
builder.
    Patch by mkay.
- [#&#8203;12052](https://togithub.com/sphinx-doc/sphinx/issues/12052):
Remove `<script>` and `<style>` tags from the content of search result
    summary snippets.
    Patch by James Addison.
- [#&#8203;11578](https://togithub.com/sphinx-doc/sphinx/issues/11578):
HTML Search: Order non-main index entries after other results.
    Patch by Brad King.
- [#&#8203;12147](https://togithub.com/sphinx-doc/sphinx/issues/12147):
autosummary: Fix a bug whereby the wrong file extension
    may be used,
    when multiple suffixes are specified in :confval:`source_suffix`.
    Patch by Sutou Kouhei.
- [#&#8203;10786](https://togithub.com/sphinx-doc/sphinx/issues/10786):
improve the error message when a file to be copied (e.g., an asset)
    is removed during Sphinx execution.
    Patch by Bénédikt Tran.
- [#&#8203;12040](https://togithub.com/sphinx-doc/sphinx/issues/12040):
HTML Search: Ensure that document titles that are partially-matched by
    the user search query are included in search results.
    Patch by James Addison.
- [#&#8203;11970](https://togithub.com/sphinx-doc/sphinx/issues/11970):
singlehtml builder: make target URIs to be same-document references in
the sense of :rfc:`RFC 3986, §4.4 <3986#section-4.4>`, e.g.,
`index.html#foo`
    becomes `#foo`. Patch by eanorige.
- [#&#8203;12271](https://togithub.com/sphinx-doc/sphinx/issues/12271):
Partially revert Docutils' r9562\__ to fix EPUB files.
    Patch by Adam Turner.

    \__ https://sourceforge.net/p/docutils/code/9562/

## Testing

- [#&#8203;11285](https://togithub.com/sphinx-doc/sphinx/issues/11285):
:func:`!pytest.mark.sphinx` and
:class:`!sphinx.testing.util.SphinxTestApp`
accept *warningiserror*, *keep_going* and *verbosity* as keyword
arguments.
    Patch by Bénédikt Tran.
- [#&#8203;11285](https://togithub.com/sphinx-doc/sphinx/issues/11285):
:class:`!sphinx.testing.util.SphinxTestApp` *status* and *warning*
arguments are checked to be :class:`io.StringIO` objects (the public API
    incorrectly assumed this without checking it).
    Patch by Bénédikt Tran.
-   Report the result of `test_run_epubcheck` as `skipped` instead of
    `success` when either Java or `epubcheck` are not available.
- Use dynamic allocation of unused port numbers for the test HTTP(S)
servers.
    As a side-effect, this removes the need for test server lockfiles,
meaning that any remaining `tests/test-server.lock` files can safely be
    deleted.

</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 has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/hetznercloud/hcloud-python).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMDEuNCIsInVwZGF0ZWRJblZlciI6IjM3LjMwMS40IiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

setup.py

@@ -45,7 +45,7 @@
     ],
     extras_require={
         "docs": [
-            "sphinx>=7.2.2,<7.3",
+            "sphinx>=7.3.4,<7.4",
             "sphinx-rtd-theme>=2,<2.1",
             "myst-parser>=2.0.0,<2.1",
             "watchdog>=4,<4.1",