Bump sphinx from 5.3.0 to 8.0.2 in /docs

[dependabot]

Bumps sphinx from 5.3.0 to 8.0.2.

Release notes

Sourced from sphinx's releases.

Sphinx 8.0.2

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

Sphinx 8.0.1

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

Sphinx 8.0.0

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

Dependencies

• #12633: Drop Python 3.9 support.

Incompatible changes

• Remove deprecated functions from sphinx.util:

  • Removed sphinx.util.path_stabilize (use sphinx.util.osutil.path_stabilize).
  • Removed sphinx.util.display_chunk (use sphinx.util.display.display_chunk).
  • Removed sphinx.util.status_iterator (use sphinx.util.display.status_iterator).
  • Removed sphinx.util.SkipProgressMessage (use sphinx.util.display.SkipProgressMessage).
  • Removed sphinx.util.progress_message (use sphinx.util.display.progress_message).
  • Removed sphinx.util.epoch_to_rfc1123 (use sphinx.http_date.epoch_to_rfc1123).
  • Removed sphinx.util.rfc1123_to_epoch (use sphinx.http_date.rfc1123_to_epoch).
  • Removed sphinx.util.save_traceback (use sphinx.exceptions.save_traceback).
  • Removed sphinx.util.format_exception_cut_frames (use sphinx.exceptions.format_exception_cut_frames).
  • Removed sphinx.util.xmlname_checker (use sphinx.builders.epub3._XML_NAME_PATTERN).

  Patch by Adam Turner.

• Removed sphinx.util.osutil.cd (use contextlib.chdir). Patch by Adam Turner.

• Removed sphinx.util.typing.stringify (use sphinx.util.typing.stringify_annotation). Patch by Adam Turner.

• #12593: Raise an error for invalid html_sidebars values. Patch by Adam Turner.

• #12593: Raise an error in Theme.get_config for invalid sections.

... (truncated)

Changelog

Sourced from sphinx's changelog.

Release 8.0.2 (released Jul 30, 2024)

Bugs fixed

• Fix the pygments.Formatter.__class_getitem__ patch. Patch by Adam Turner.

Release 8.0.1 (released Jul 30, 2024)

Bugs fixed

• Patch pygments.Formatter.__class_getitem__ in Pygments 2.17. Patch by Adam Turner.

Release 8.0.0 (released Jul 29, 2024)

Dependencies

• #12633: Drop Python 3.9 support.

Incompatible changes

.. rst-class:: compact

• Remove deprecated functions from sphinx.util:

  • Removed sphinx.util.path_stabilize (use sphinx.util.osutil.path_stabilize).
  • Removed sphinx.util.display_chunk (use sphinx.util.display.display_chunk).
  • Removed sphinx.util.status_iterator (use sphinx.util.display.status_iterator).
  • Removed sphinx.util.SkipProgressMessage (use sphinx.util.display.SkipProgressMessage).
  • Removed sphinx.util.progress_message (use sphinx.util.display.progress_message).
  • Removed sphinx.util.epoch_to_rfc1123 (use sphinx.http_date.epoch_to_rfc1123).
  • Removed sphinx.util.rfc1123_to_epoch (use sphinx.http_date.rfc1123_to_epoch).
  • Removed sphinx.util.save_traceback (use sphinx.exceptions.save_traceback).
  • Removed sphinx.util.format_exception_cut_frames

... (truncated)

Commits

• 043750e Bump to 8.0.2 final
• cee9efc Use classmethod for a class method
• 16fed35 Bump version
• d9bda77 Bump to 8.0.1 final
• 006a6a7 Fix Flake8
• d0915ab Fix mypy
• 865b513 Patch pygments.Formatter.__class_getitem__ in Pygments 2.17
• f1d3c3f Bump version
• 0e8a638 Bump to 8.0.0 final
• 5750d0e [bot]: Update message catalogues (#12641)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[semanticdiff-com]

Review changes with SemanticDiff.

[sourcery-ai]

We have skipped reviewing this pull request. Here's why:

• It seems to have been created by a bot (hey, dependabot[bot]!). We assume it knows what it's doing!
• We don't review packaging changes - Let us know if you'd like us to change this.

[codiumai-pr-agent-free]

CI Failure Feedback 🧐

(Checks updated until commit 15abb18)

Action: tests 3.9 / ubuntu-latest

Failed stage: Upgrade pip [❌]

Failure summary: The action failed because it could not find the required file: The file .github/workflows/constraints.txt is missing, which is needed to open the requirements file. This resulted in an error with exit code 1.

Relevant error logs: 1: ##[group]Operating System 2: Ubuntu ... 201: PRE_COMMIT_COLOR: always 202: pythonLocation: /opt/hostedtoolcache/Python/3.9.20/x64 203: PKG_CONFIG_PATH: /opt/hostedtoolcache/Python/3.9.20/x64/lib/pkgconfig 204: Python_ROOT_DIR: /opt/hostedtoolcache/Python/3.9.20/x64 205: Python2_ROOT_DIR: /opt/hostedtoolcache/Python/3.9.20/x64 206: Python3_ROOT_DIR: /opt/hostedtoolcache/Python/3.9.20/x64 207: LD_LIBRARY_PATH: /opt/hostedtoolcache/Python/3.9.20/x64/lib 208: ##[endgroup] 209: �[31mERROR: Could not open requirements file: [Errno 2] No such file or directory: '.github/workflows/constraints.txt'�[0m�[31m 210: �[0m 211: ##[error]Process completed with exit code 1.

---

✨ CI feedback usage guide:

---

The CI feedback tool (/checks) automatically triggers when a PR has a failed check.
The tool analyzes the failed checks and provides several feedbacks:

• Failed stage
• Failed test name
• Failure summary
• Relevant error logs

In addition to being automatically triggered, the tool can also be invoked manually by commenting on a PR:

/checks "https://github.com/{repo_name}/actions/runs/{run_number}/job/{job_number}"

where {repo_name} is the name of the repository, {run_number} is the run number of the failed check, and {job_number} is the job number of the failed check.

Configuration options

• enable_auto_checks_feedback - if set to true, the tool will automatically provide feedback when a check is failed. Default is true.
• excluded_checks_list - a list of checks to exclude from the feedback, for example: ["check1", "check2"]. Default is an empty list.
• enable_help_text - if set to true, the tool will provide a help message with the feedback. Default is true.
• persistent_comment - if set to true, the tool will overwrite a previous checks comment with the new feedback. Default is true.
• final_update_message - if persistent_comment is true and updating a previous checks message, the tool will also create a new message: "Persistent checks updated to latest commit". Default is true.

See more information about the checks tool in the docs.

[dependabot]

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.