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

Release notes

Sourced from sphinx's releases.

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

Bugs fixed

• Restored the the :py:class:str interface of the asset classes (_CascadingStyleSheet and _JavaScript), which several extensions relied upon. This will be removed in Sphinx 9.
• Restored calls to Builder.add_{css,js}_file(), which several extensions relied upon.
• Restored the private API TocTree.get_toctree_ancestors(), which several extensions relied upon.

Release 7.2.0 (released Aug 17, 2023)

Dependencies

• #11511: Drop Python 3.8 support.
• #11576: Require Pygments 2.14 or later.

Deprecated

• #11512: Deprecate sphinx.util.md5 and sphinx.util.sha1. Use hashlib instead.
• #11526: Deprecate sphinx.testing.path. Use os.path or pathlib instead.
• #11528: Deprecate sphinx.util.split_index_msg and sphinx.util.split_into. Use sphinx.util.index_entries.split_index_msg instead.
• Deprecate sphinx.builders.html.Stylesheet and sphinx.builders.html.Javascript. Use sphinx.application.Sphinx.add_css_file()

... (truncated)

Commits

• ed84d63 Bump to 7.2.2 final
• ea4a73e [bot]: Update message catalogues (#11612)
• e47846a Fix :noindex: for PyModule and JSModule``
• b2fc47f Add CHANGES entry for renaming the StateMachine.insert_input() parameter
• 0835c3e Fix regression in SingleFileHTMLBuilder._get_local_toctree
• 49dc0dd Fix asset class string interface membership testing
• 8512855 Fix signature of docutils include_source monkeypatch (#11610)
• e1d9068 Bump version
• 441a9e4 Bump to 7.2.1 final
• ec31853 Restore TocTree.get_toctree_ancestors()
• 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> dependency 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> dependency 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--2148.org.readthedocs.build/en/2148/

[simonw]

@dependabot recreate

[codecov]

Codecov Report

Patch coverage has no change and project coverage change: +0.01% 🎉

Comparison is base (17ec309) 92.71% compared to head (a651d3c) 92.73%.
Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2148      +/-   ##
==========================================
+ Coverage   92.71%   92.73%   +0.01%     
==========================================
  Files          40       40              
  Lines        5919     5919              
==========================================
+ Hits         5488     5489       +1     
+ Misses        431      430       -1     

see 1 file with indirect coverage changes

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

[simonw]

Sphinx dropped support for Python 3.8 in their version 7.2.0:

• https://www.sphinx-doc.org/en/master/changes.html#release-7-2-0-released-aug-17-2023
• https://www.sphinx-doc.org/en/master/internals/release-process.html#python-version-support-policy
• Drop support for Python 3.8 sphinx-doc/sphinx#11511

[simonw]

Here's why the tests are failing:

datasette/.github/workflows/test.yml

Lines 30 to 46 in 2ce7872

	- name: Install dependencies
	run: |
	pip install -e '.[test,docs]'
	pip freeze
	- name: Run tests
	run: |
	pytest -n auto -m "not serial"
	pytest -m "serial"
	# And the test that exceeds a localhost HTTPS server
	tests/test_datasette_https_server.sh
	- name: Check if cog needs to be run
	run: |
	cog --check docs/*.rst
	- name: Check if blacken-docs needs to be run
	run: |
	# This fails on syntax errors, or a diff was applied
	blacken-docs -l 60 docs/*.rst

It looks like those tests don't actually need Sphinx installed - they install pip install -e '.[test,docs]' to get the other docs dependencies:

datasette/setup.py

Lines 70 to 80 in 2ce7872

	extras_require={
	"docs": [
	"Sphinx==7.1.2",
	"furo==2023.7.26",
	"sphinx-autobuild",
	"codespell>=2.2.5",
	"blacken-docs",
	"sphinx-copybutton",
	"sphinx-inline-tabs",
	"ruamel.yaml",
	],

[simonw]

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]

@dependabot rebase

[dependabot]

Looks like this PR has been edited by someone other than Dependabot. That means Dependabot can't rebase it - sorry!

If you're happy for Dependabot to recreate it from scratch, overwriting any edits, you can request @dependabot recreate.

[simonw]

Now solving this here:

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

[dependabot]

This pull request was built based on a group rule. Closing it will not ignore any of these versions in future pull requests.