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.1.3

Release notes

Sourced from sphinx's releases.

Sphinx 8.1.3

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

Bugs fixed

• #13013: Restore support for cut_lines() with no object type. Patch by Adam Turner.

Sphinx 8.1.2

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

Bugs fixed

• #13012: Expose sphinx.errors.ExtensionError in sphinx.util for backwards compatibility. This will be removed in Sphinx 9, as exposing the exception in sphinx.util was never intentional. ExtensionError has been part of sphinx.errors since Sphinx 0.9. Patch by Adam Turner.

Sphinx 8.1.1

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

Bugs fixed

• #13006: Use the preferred https://www.cve.org/ URL for the :cve: role. Patch by Hugo van Kemenade.
• #13007: LaTeX: Improve resiliency when the required fontawesome or fontawesome5 packages are not installed. Patch by Jean-François B.

Sphinx 8.1.0

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

Dependencies

• #12756: Add lower-bounds to the sphinxcontrib-* dependencies. Patch by Adam Turner.
• #12833: Update the LaTeX parskip package from 2001 to 2018. Patch by Jean-François B.

Incompatible changes

• #12763: Remove unused internal class sphinx.util.Tee. Patch by Adam Turner.
• #12822: LaTeX: for Unicode engines, the fvset default is changed to '\\fvset{fontsize=auto}' from '\\fvset{fontsize=\\small}'. Code-blocks are unchanged as FreeMono is now loaded with Scale=0.9. An adjustment to existing projects is needed only if they used a custom fontpkg configuration and did not set fvset.

... (truncated)

Changelog

Sourced from sphinx's changelog.

Release 8.1.3 (released Oct 13, 2024)

Bugs fixed

• #13013: Restore support for :func:!cut_lines with no object type. Patch by Adam Turner.

Release 8.1.2 (released Oct 12, 2024)

Bugs fixed

• #13012: Expose :exc:sphinx.errors.ExtensionError in sphinx.util for backwards compatibility. This will be removed in Sphinx 9, as exposing the exception in sphinx.util was never intentional. :exc:!ExtensionError has been part of sphinx.errors since Sphinx 0.9. Patch by Adam Turner.

Release 8.1.1 (released Oct 11, 2024)

Bugs fixed

• #13006: Use the preferred https://www.cve.org/ URL for the :rst:role::cve: <cve> role. Patch by Hugo van Kemenade.
• #13007: LaTeX: Improve resiliency when the required fontawesome or fontawesome5 packages are not installed. Patch by Jean-François B.

Release 8.1.0 (released Oct 10, 2024)

Dependencies

• #12756: Add lower-bounds to the sphinxcontrib-* dependencies. Patch by Adam Turner.
• #12833: Update the LaTeX parskip package from 2001 to 2018. Patch by Jean-François B.

Incompatible changes

• #12763: Remove unused internal class sphinx.util.Tee.

... (truncated)

Commits

• a1510de Bump to 8.1.3 final
• 62e9606 Restore support for cut_lines() with no object type (#13015)
• 5ae32ce Bump version
• a72b47b Bump to 8.1.2 final
• 39a45ad Expose ExtensionError in sphinx.util for backwards compatibility.
• 5a4859a Add docs about sphinx-autobuild (#13011)
• 05679ef Type-check the 'autodoc_intenum' example (#12827)
• 86d1d31 Prune CHANGES of unneeded sections
• b6269d3 Improve documentation for the Builder API (#13008)
• c46abc4 Improve clarity for master_doc and root_doc
• 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.0

Release notes

Sourced from myst-parser's releases.

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

• ✨ Allow for use of the line-block directive by @​chrisjsewell in executablebooks/MyST-Parser#900
• ✨ Emits sphinx include-read event by @​sumezulike in executablebooks/MyST-Parser#887

Improvements

• 👌 Nested parse attribution in attr_block by @​chrisjsewell in executablebooks/MyST-Parser#831
• 👌 Directive option parsing by @​chrisjsewell in executablebooks/MyST-Parser#796
• 👌 Improve directive parsing warnings by @​chrisjsewell in executablebooks/MyST-Parser#893
• 👌 Allow for opening external links in new tabs (#856) by @​marjus45 in executablebooks/MyST-Parser#857

Internal

• 🔧 Replace black, isort, pyupgrade with ruff formatter by @​chrisjsewell in executablebooks/MyST-Parser#833
• 🔧 remove redundant mypy config by @​danieleades in executablebooks/MyST-Parser#866
• 🔧 Add additional Ruff lints (and fix issues) by @​danieleades in executablebooks/MyST-Parser#862
• 🔧 mypy- disallow 'any generics' by @​danieleades in executablebooks/MyST-Parser#865
• 🔧 Fix docutils deprecation in option parsing by @​agoose77 in executablebooks/MyST-Parser#842

Documentation

... (truncated)

Changelog

Sourced from myst-parser's changelog.

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

• 🔧 Replace black, isort, pyupgrade with ruff formatter by gh-user:chrisjsewell in gh-pr:833
• 🔧 remove redundant mypy config by gh-user:danieleades in gh-pr:866
• 🔧 Add additional Ruff lints (and fix issues) by gh-user:danieleades in gh-pr:862

... (truncated)

Commits

• ce37be5 🚀 Release v4.0.0 (#954)
• 850f7c9 👌 Improve footnote def/ref warnings and translations (#931)
• 401e08c ⬆️ Support python>=3.10, sphinx >=7,<9, docutils>=0.19,<0.22 (#952)
• d3d7fbb 🔧 pre-commit autoupdate (#946)
• ad0f24f 🔧 test fixes for sphinx 7.4 (#945)
• d448abf 📚 Fix typo (#940)
• 3d84ff8 🚀 Release v3.0.1 (#926)
• 790a926 🐛 FIX: allow indented option block (#925)
• 446feba 🐛 FIX empty value for final directive option (#924)
• c9579c4 📚 Update live preview (#921)
• 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