Bump the docs-dependencies group across 1 directory with 4 updates

[dependabot]

Bumps the docs-dependencies group with 4 updates in the /docs directory: furo, sphinx, sphinx-click and myst-parser.

Updates furo from 2023.9.10 to 2024.8.6

Changelog

Sourced from furo's changelog.

Changelog

2024.08.06 -- Energetic Eminence

• ✨ Add support for Sphinx 8
• ✨ Add smoother transitions between breakpoints
• Increase specificity of table-wrapper selector
• Avoid page breaks inside paragraphs

2024.07.18 -- Dull Denim

• Improve how icons are handled and aligned.
• Improve scroll event handler.
• Hide the copybutton by default.
• Fix source_view_link configuration handling.
• Fix close tag on pencil icon.

2024.05.06 -- Cheerful Cerulean

• ✨ Add new custom icons for auto mode, reflecting the currently active theme.
• ✨ Add a view this page button.
• ✨ Add colours and highlighting to "version modified" API helpers.
• ✨ Add release information to various customisation knobs.
• Make all icons bigger and use a thinner stroke with them.

2024.04.27 -- Bold Burgundy

• Add a skip to content link.
• Add --font-stack--headings.
• Add :visited colour and enforce uniform contrast between light/dark.
• Add an offset of :target to reduce back-to-top overlap.
• Improve dark mode colours.
• Fix outstanding colour contrast warnings on Firefox.
• Fix bad indent in footnotes.
• Tweak handling of default configuration options in a more resilient manner.
• Tweak length and sizing of API source links.
• Stop search engine indexing on search page.

2024.01.29 -- Amazing Amethyst

... (truncated)

Commits

• 1bbf4ee Prepare release: 2024.08.06
• bcb22c3 Update changelog
• e633f02 Improve the selector for sidebar
• d2fa2e0 [pre-commit.ci] pre-commit autoupdate (#821)
• 05a2d63 Add smoother transitions between breakpoints
• d261d3b [pre-commit.ci] pre-commit autoupdate (#810)
• 2d3b6ba Add support for Sphinx 8
• bf98041 Increase specificity of table-wrapper selector
• fc6337c Fix the figures
• fd3f422 Avoid page breaks inside paragraphs
• Additional commits viewable in compare view

Updates sphinx from 7.2.6 to 8.2.1

Release notes

Sourced from sphinx's releases.

Sphinx 8.2.1

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

Sphinx 8.2.0

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

Dependencies

• #13000: Drop Python 3.10 support.

Incompatible changes

• #13044: Remove the internal and undocumented has_equations data from the MathDomain domain. The undocumented MathDomain.has_equations method now unconditionally returns True. These are replaced by the has_maths_elements key of the page context dict. Patch by Adam Turner.
• #13227: HTML output for sequences of keys in the kbd role no longer uses a <kbd class="kbd compound"> element to wrap the keys and separators, but places them directly in the relevant parent node. This means that CSS rulesets targeting kbd.compound or .kbd.compound will no longer have any effect. Patch by Adam Turner.

Deprecated

• #13037: Deprecate the SingleHTMLBuilder.fix_refuris method. Patch by James Addison.
• #13083, #13330: Un-deprecate sphinx.util.import_object. Patch by Matthias Geier.

Features added

• #13173: Add a new duplicate_declaration warning type, with duplicate_declaration.c and duplicate_declaration.cpp subtypes. Patch by Julien Lecomte and Adam Turner.
• #11824: linkcode: Allow extensions to add support for a domain by defining the keys that should be present. Patch by Nicolas Peugnet.
• #13144: Add a class option to the autosummary directive. Patch by Tim Hoffmann.
• #13146: Napoleon: Unify the type preprocessing logic to allow Google-style docstrings to use the optional and default keywords. Patch by Chris Barrick.

... (truncated)

Changelog

Sourced from sphinx's changelog.

Release 8.2.1 (released Feb 21, 2025)

Bugs fixed

• #13367: Correct spelling of highlighting_failure in warning sub-type. Patch by Bart Kamphorst.
• #13377: Restore support for using sphinx.testing.path paths with sphinx.testing.fixtures. Patch by Kazuya Takei.
• #13380: viewcode: Fix importing modules more than once. Patch by Dave Hoese.
• #13382: Napoleon: Use the right valid types for configuration values. Patch by Adam Turner.
• 13376: Fix copying assets from a relative :confval:html_static_path entry. Patch by Adam Turner.

Release 8.2.0 (released Feb 18, 2025)

Dependencies

• #13000: Drop Python 3.10 support.

Incompatible changes

• #13044: Remove the internal and undocumented has_equations data from the :py:class:!MathDomain domain. The undocumented :py:meth:!MathDomain.has_equations method now unconditionally returns True. These are replaced by the has_maths_elements key of the page context dict. Patch by Adam Turner.
• #13227: HTML output for sequences of keys in the :rst:role:kbd role no longer uses a <kbd class="kbd compound"> element to wrap the keys and separators, but places them directly in the relevant parent node. This means that CSS rulesets targeting kbd.compound or .kbd.compound will no longer have any effect. Patch by Adam Turner.

Deprecated

• #13037: Deprecate the SingleHTMLBuilder.fix_refuris method. Patch by James Addison.
• #13083, #13330: Un-deprecate sphinx.util.import_object. Patch by Matthias Geier.

... (truncated)

Commits

• 0215a73 Bump to 8.2.1 final
• 53b7913 Remove background colours from (un)translated classes
• 58e64d4 Fix _relative_path() for unresolved paths
• 1a3d1de Add missing CHANGES entry
• d847d73 Bump Ruff to 0.9.7
• 7ba7628 Napoleon: Fix valid types for configuration values (#13382)
• 8ef0708 Fix viewcode extension importing modules more than once (#13380)
• 7e1bf28 Restore support for sphinx.testing.path paths in ``sphinx.testing.fixture...
• d099161 Revert "Mark autodoc singledispatchmethod tests as expected failures" (#13381)
• ba3c729 Switch transifex workflow trigger from 'push' to 'pull_request'
• Additional commits viewable in compare view

Updates sphinx-click from 5.1.0 to 6.0.0

Commits

• 7f29172 FIX Format string defaults correctly
• 34470b6 Remove errant prints
• f4ffef0 Drop support for click 7.x, Sphinx < 5.x
• f0bf6e9 readthedocs: Use dirhtml builder
• 0808867 docs: Add discrete mocking section
• 8381e90 actions: Integrate tox-gh-actions
• 05b69cf Distinguish between click and asyncclick
• ac21950 tests: Set maxDiff
• f099fe3 Skip test with click 7.x
• 82b5bcd FIX If the help of an argument is None, don't fail
• Additional commits viewable in compare view

Updates myst-parser from 2.0.0 to 4.0.1

Release notes

Sourced from myst-parser's releases.

v4.0.1

What's Changed

• 🔧 Minor fix for sphinx 8.2 compat by @​chrisjsewell in executablebooks/MyST-Parser#1013

• 🧪 Add CI testing support for Python 3.13 by @​hugovk in executablebooks/MyST-Parser#955

• 🔧 Fix type of MockIncludeDirective’s klass parameter by @​flying-sheep in executablebooks/MyST-Parser#975

• 📚 Fix typos discovered by codespell by @​cclauss in executablebooks/MyST-Parser#969

• 📚 remove redundant paragraph by @​Snoopy1866 in executablebooks/MyST-Parser#987

• 📚 Minor typo in cross-referencing.md by @​goekce in executablebooks/MyST-Parser#990

New Contributors

• @​cclauss made their first contribution in executablebooks/MyST-Parser#969
• @​flying-sheep made their first contribution in executablebooks/MyST-Parser#975
• @​Snoopy1866 made their first contribution in executablebooks/MyST-Parser#987
• @​goekce made their first contribution in executablebooks/MyST-Parser#990

Full Changelog: executablebooks/MyST-Parser@v4.0.0...v4.0.1

v4.0.0

What's Changed

• ⬆️ Support python>=3.10, sphinx >=7,=0.19,<0.22 by @​chrisjsewell in executablebooks/MyST-Parser#952
• 👌 Improve footnote def/ref warnings and translations by @​chrisjsewell in executablebooks/MyST-Parser#931
• 📚 Fix typo by @​meli-lewis in executablebooks/MyST-Parser#940

New Contributors

• @​meli-lewis made their first contribution in executablebooks/MyST-Parser#940

Full Changelog: executablebooks/MyST-Parser@v3.0.1...v4.0.0

v3.0.1

What's Changed

• 🐛 FIX empty value for final directive option by @​chrisjsewell in executablebooks/MyST-Parser#924
• 🐛 FIX: allow indented option block by @​chrisjsewell in executablebooks/MyST-Parser#925

Full Changelog: executablebooks/MyST-Parser@v3.0.0...v3.0.1

v3.0.0

What's Changed

Upgraded dependencies

• ⬆️ Add support for Python 3.12 by @​hugovk in executablebooks/MyST-Parser#848
• ⬆️ Update docutils requirement from >=0.16,=0.18,<0.22 by @​chrisjsewell in executablebooks/MyST-Parser#916

New features

... (truncated)

Changelog

Sourced from myst-parser's changelog.

4.0.1 - 2025-02-12

🔧 Minor fix for Sphinx 8.2 compatibility (in gh-pr:1013)

4.0.0 - 2024-08-05

This release bumps the supported versions of:

• Python to 3.10 and greater
• Sphinx to >=7,<9
• Docutils to >=0.19,<0.22

Additionally, footnotes are now parsed similar to the corresponding reStructuredText, in that resolution (between definitions and references) and ordering is now deferred to transforms on the doctree (in gh-pr:931).

This allows for the proper interaction with other docutils/sphinx transforms, including those that perform translations, and logging of warnings for duplicate/unreferenced footnote definitions and also for footnote references with no definitions.

See the footnotes guide for more information.

Full Changelog: v3.0.1...v4.0.0

3.0.1 - 2024-04-28

🐛 Bug Fixes

• Account for the final directive option having an empty value, by gh-user:chrisjsewell in gh-pr:924
• Re-allow indented directive option blocks, by gh-user:chrisjsewell in gh-pr:925

Full Changelog: v3.0.0...v3.0.1

3.0.0 - 2024-04-23

Upgraded dependencies

• ⬆️ Add support for Python 3.12 by gh-user:hugovk in gh-pr:848
• ⬆️ Update docutils requirement from >=0.16,

New features

• ✨ Allow for use of the line-block directive by gh-user:chrisjsewell in gh-pr:900
• ✨ Emits sphinx include-read event by gh-user:sumezulike in gh-pr:887

Improvements

• 👌 Nested parse attribution in attr_block by gh-user:chrisjsewell in gh-pr:831
• 👌 Directive option parsing by gh-user:chrisjsewell in <gh-pr:796
• 👌 Improve directive parsing warnings by gh-user:chrisjsewell in gh-pr:893
• 👌 Allow for opening external links in new tabs (#856) by gh-user:marjus45 in gh-pr:857

Internal

... (truncated)

Commits

• 8a44f5d 🚀 Release v4.0.1 (#1022)
• fbb7f1d 🔧 Minor fix for sphinx 8.2 compat (#1013)
• 0437558 🔧 update pre-commit (#1006)
• b58737f ⬆️ Update pre-commit requirement from ~=3.0 to ~=4.0 (#982)
• f62025f [pre-commit.ci] pre-commit autoupdate (#986)
• 14ea197 📚 Minor typo in cross-referencing.md (#990)
• bc35794 📚 remove redundant paragraph (#987)
• 9fe724e 🧪 Fix tests for latest sphinx (#993)
• 59b5386 [pre-commit.ci] pre-commit autoupdate (#976)
• 6bcba98 🔧 Fix type of MockIncludeDirective’s klass parameter (#975)
• 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 <dependency name> major version will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
• @dependabot ignore <dependency name> minor version will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
• @dependabot ignore <dependency name> will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
• @dependabot unignore <dependency name> will remove all of the ignore conditions of the specified dependency
• @dependabot unignore <dependency name> <ignore condition> will remove the ignore condition of the specified dependency and ignore conditions

[dependabot]

Superseded by #500.