Bump sphinx, furo, blacken-docs dependencies

[dependabot]

Bumps the python-packages group with 3 updates: sphinx, furo and blacken-docs.

Updates sphinx from 7.1.2 to 7.2.4

Release notes

Sourced from sphinx's releases.

Sphinx 7.2.4

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

Sphinx 7.2.3

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

Sphinx 7.2.2

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

Sphinx 7.2.1

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

Sphinx 7.2.0

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

Changelog

Sourced from sphinx's changelog.

Release 7.2.4 (released Aug 28, 2023)

Bugs fixed

• #11618: Fix a regression in the MoveModuleTargets transform, introduced in #10478 (#9662).
• #11649: linkcheck: Resolve hanging tests for timezones west of London and incorrect conversion from UTC to offsets from the UNIX epoch. Patch by Dmitry Shachnev and Adam Turner.

Release 7.2.3 (released Aug 23, 2023)

Dependencies

• #11576: Require sphinxcontrib-serializinghtml 1.1.9.

Bugs fixed

• Fix regression in autodoc.Documenter.parse_name().
• Fix regression in JSON serialisation.
• #11543: autodoc: Support positional-only parameters in classmethod methods when autodoc_preserve_defaults is True.
• Restore support string methods on path objects. This is deprecated and will be removed in Sphinx 8. Use :py:func:os.fspath to convert :py:class:~pathlib.Path objects to strings, or :py:class:~pathlib.Path's methods to work with path objects.

Release 7.2.2 (released Aug 17, 2023)

Bugs fixed

• Fix the signature of the StateMachine.insert_input() patch, for when calling with keyword arguments.
• Fixed membership testing (in) for the :py:class:str interface of the asset classes (_CascadingStyleSheet and _JavaScript), which several extensions relied upon.
• Fixed a type error in SingleFileHTMLBuilder._get_local_toctree, includehidden may be passed as a string or a boolean.
• Fix :noindex: for PyModule and JSModule.

Release 7.2.1 (released Aug 17, 2023)

... (truncated)

Commits

• 3256f1f Bump to 7.2.4 final
• 2f025a4 linkcheck: Fix conversion from UTC time to the UNIX epoch (#11649)
• 1567281 autodoc: Fix UnboundLocalError in filter_members (#11651)
• 5e88b9f Fix the MoveModuleTargets transform (#11647)
• 694fcee Fix markup in CHANGES (#11639)
• c503c90 Improve pathlib type annotations (#11646)
• bf339b1 Bump version
• 2f6ea14 Bump to 7.2.3 final
• 511e407 Implement bool() for string paths
• 494de73 Implement hash() for string paths
• Additional commits viewable in compare view

Updates furo from 2023.7.26 to 2023.8.19

Changelog

Sourced from furo's changelog.

Changelog

2023.08.19 -- Xenolithic Xanadu

• Fix missing search context with Sphinx 7.2, for dirhtml builds.
• Drop support for Python 3.7.
• Present configuration errors in a better format -- thanks @​AA-Turner!
• Bump require_sphinx() to Sphinx 6.0, in line with dependency changes in Unassuming Ultramarine.

2023.08.17 -- Wonderous White

• Fix compatiblity with Sphinx 7.2.0 and 7.2.1.

2023.07.26 -- Vigilant Volt

• Fix compatiblity with Sphinx 7.1.
• Improve how content overflow is handled.
• Improve how literal blocks containing inline code are handled.

2023.05.20 -- Unassuming Ultramarine

• ✨ Add support for Sphinx 7.
• Drop support for Sphinx 5.
• Improve the screen-reader label for sidebar collapse.
• Make it easier to create derived themes from Furo.
• Bump all JS dependencies (NodeJS and npm packages).

2023.03.27 -- Tasty Tangerine

• Regenerate with newer version of sphinx-theme-builder, to fix RECORD hashes.
• Add missing class to Font Awesome examples

2023.03.23 -- Sassy Saffron

• Update Python version classifiers.
• Increase the icon size in mobile header.
• Increase admonition title bg opacity.
• Change the default API background to transparent.
• Transition the API background change.

... (truncated)

Commits

• 0766bb2 Prepare release: 2023.08.19
• 807d73c Update changelog
• 364b261 Accomodate for the required data-content_root for search
• 0d38bc6 Simplify retrieval of pygments_dark_style value (#699)
• 3631ffc Use sphinx.errors.ConfigError (#697)
• d2e2448 Remove duplicate HTML builder check (#698)
• 7b4f130 Drop Python 3.7 (#701)
• e322b71 Remove pointless assert (#702)
• ee2097a Bump require_sphinx() to Sphinx 6.0 (#700)
• c1ff10b Back to development
• Additional commits viewable in compare view

Updates blacken-docs from 1.15.0 to 1.16.0

Changelog

Sourced from blacken-docs's changelog.

1.16.0 (2023-08-16)

• Allow Markdown fence options.

  Thanks to initial work from Matthew Anderson in PR [#246](https://github.com/asottile/blacken-docs/issues/246) <https://github.com/adamchainz/blacken-docs/pull/246>__.

• Expand Markdown detection to all Python language names from Pygments: py, sage, python3, py3, and numpy.

• Preserve leading whitespace lines in reStructuredText code blocks.

  Thanks to Julianus Pfeuffer for the report in Issue [#217](https://github.com/asottile/blacken-docs/issues/217) <https://github.com/adamchainz/blacken-docs/issues/217>__.

• Use exit code 2 to indicate errors from Black, whilst exit code 1 remains for “files have been formatted”.

  Thanks to Julianus Pfeuffer for the report in Issue [#218](https://github.com/asottile/blacken-docs/issues/218) <https://github.com/adamchainz/blacken-docs/issues/218>__.

• Support passing the --preview option through to Black, to select the future style.

• Remove language_version from .pre-commit-hooks.yaml. This change allows default_language_version in ``.pre-commit-config.yaml` to take precedence.

  Thanks to Aneesh Agrawal in PR [#258](https://github.com/asottile/blacken-docs/issues/258) <https://github.com/adamchainz/blacken-docs/pull/258>__.

Commits

• 960ead2 Version 1.16.0
• 8f0ed18 Support passing --preview through to Black (#273)
• 4eb4e4c Tweak changelog note
• 6c7450c Use exit code 2 to indicate errors (#272)
• 99dfc8d Preserve leading whitespace lines in rST (#271)
• 94465e8 Reformat markdown tests with dedent() (#270)
• 7cd5f30 Use .md in glob example
• f97e569 Document applying to many files (#269)
• ae612b0 Expand Markdown detection to all Python language names (#268)
• da9b455 Replace NamedTuple with plain class (#267)
• 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

---

📚 Documentation preview 📚: https://datasette--2160.org.readthedocs.build/en/2160/

[codecov]

Codecov Report

Patch and project coverage have no change.

Comparison is base (2e28258) 92.82% compared to head (c81b024) 92.82%.

❗ Current head c81b024 differs from pull request most recent head 3529c9c. Consider uploading reports for the commit 3529c9c to get more accurate results

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2160   +/-   ##
=======================================
  Coverage   92.82%   92.82%           
=======================================
  Files          40       40           
  Lines        5948     5948           
=======================================
  Hits         5521     5521           
  Misses        427      427           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[simonw]

I figured out why this was failing in:

• Bump sphinx, furo, blacken-docs dependencies #2148

It's because Sphinx dropped support for Python 3.8.

[simonw]

#2148 (comment)

Simplest possible solution is to only run the pip install .[docs] bit under Python 3.9+, ditto for the docs tests. I think I'll try that.

[simonw]

Since this bumps Sphinx I'm manually reviewing the ReadTheDocs preview a bit, looks good to me: https://datasette--2160.org.readthedocs.build/en/2160/

[simonw]

Cog failed!