Update dependency Sphinx to v7 #1740
Conversation
![renovate[bot]](https://avatars.githubusercontent.com/in/2740?s=60&v=4){kind=small}
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
from
32af619 to
1c2ff3c
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
from
1c2ff3c to
a23d97c
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
from
a23d97c to
1b8e8a6
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
2 times, most recently
from
c7b29c8 to
2b3bc02
Compare
|
This needs the resolution of readthedocs/sphinx_rtd_theme#1463 and a new release of sphinx_rtd_theme first. |
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
2 times, most recently
from
dbf79b7 to
937627d
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
7 times, most recently
from
36c9442 to
ffbe176
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
2 times, most recently
from
4da4de0 to
22da144
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
from
22da144 to
70e4ef8
Compare
renovate
bot
force-pushed
the
renovate/sphinx-7.x
branch
from
70e4ef8 to
312a44a
Compare
|
Sphinx 7.2 dropped support for Python 3.8 |
Let's try to update to Sphinx 7.12 for now, as Python 3.8 is not quite end-of-life yet. |
Edited/Blocked NotificationRenovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR. You can manually request rebase by checking the rebase/retry box above. ⚠ Warning: custom changes will be lost. |
Codecov Report
@@ Coverage Diff @@
## master #1740 +/- ##
=======================================
Coverage 77.73% 77.73%
=======================================
Files 127 127
Lines 5268 5268
=======================================
Hits 4095 4095
Misses 1173 1173
Flags with carried forward coverage won't be shown. Click here to find out more. 📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more |
|
tested locally, the Documentation still looks the same |
This PR contains the following updates:
==6.2.1->==7.2.6Release Notes
sphinx-doc/sphinx (Sphinx)
v7.2.6Compare Source
=====================================
Bugs fixed
!SPHINX_AUTODOC_RELOAD_MODULESenvironment variable,which if set reloads modules when using autodoc with
TYPE_CHECKING = True.Patch by Matt Wozniski and Adam Turner.
importlib.reloadto reload modules in autodoc.Patch by Matt Wozniski and Adam Turner.
v7.2.5Compare Source
=====================================
Bugs fixed
packages that make use of
if typing.TYPE_CHECKING:to guard circularimports needed by type checkers.
Patch by Matt Wozniski.
for sibling files in a subdirectory.
Patch by Albert Shih.
?config=...in :confval:mathjax_path.when an object claims to be an instance of
type,but is not a class.
Patch by James Braza.
source-readevents for files read viathe :dudir:
includedirective.include-readfor observing and transformingthe content of included files via the :dudir:
includedirective.YYYYwhen
SOURCE_DATE_EPOCHis set.v7.2.4Compare Source
=====================================
Bugs fixed
introduced in #10478 (#9662).
and incorrect conversion from UTC to offsets from the UNIX epoch.
Patch by Dmitry Shachnev and Adam Turner.
v7.2.3Compare Source
=====================================
Dependencies
Bugs fixed
autodoc.Documenter.parse_name().classmethodmethodswhen
autodoc_preserve_defaultsisTrue.This is deprecated and will be removed in Sphinx 8.
Use :py:func:
os.fspathto convert :py:class:~pathlib.Pathobjects to strings,or :py:class:
~pathlib.Path's methods to work with path objects.v7.2.2Compare Source
=====================================
Bugs fixed
StateMachine.insert_input()patch,for when calling with keyword arguments.
in) for the :py:class:strinterfaceof the asset classes (
_CascadingStyleSheetand_JavaScript),which several extensions relied upon.
SingleFileHTMLBuilder._get_local_toctree,includehiddenmay be passed as a string or a boolean.:noindex:forPyModuleandJSModule.v7.2.1Compare Source
=====================================
Bugs fixed
strinterface of the asset classes(
_CascadingStyleSheetand_JavaScript),which several extensions relied upon.
This will be removed in Sphinx 9.
Builder.add_{css,js}_file(),which several extensions relied upon.
TocTree.get_toctree_ancestors(),which several extensions relied upon.
v7.2.0Compare Source
=====================================
Dependencies
Deprecated
sphinx.util.md5andsphinx.util.sha1.Use
hashlibinstead.sphinx.testing.path.Use
os.pathorpathlibinstead.sphinx.util.split_index_msgandsphinx.util.split_into.Use
sphinx.util.index_entries.split_index_msginstead.sphinx.builders.html.Stylesheetand
sphinx.builders.html.Javascript.Use
sphinx.application.Sphinx.add_css_file()and
sphinx.application.Sphinx.add_js_file()instead.sphinx.builders.html.StandaloneHTMLBuilder.css_filesandsphinx.builders.html.StandaloneHTMLBuilder.script_files.Use
sphinx.application.Sphinx.add_css_file()and
sphinx.application.Sphinx.add_js_file()instead.sphinx.ext.autodoc.preserve_defaults.get_function_def().Patch by Bénédikt Tran.
Features added
os.PathLiketypes andpathlib.Pathobjectsin many more places.
Patch by Jorge Leitao.
viewcode_line_numbersto controlwhether line numbers are added to rendered source code.
Patch by Ben Krikler.
:no-typesetting:option to suppress textual outputand only create a linkable anchor.
Patch by Latosha Maltba.
Patch by Rouslan Korneychuk.
doctest_show_successesoption.Patch by Trey Hunner.
:no-index:,:no-index-entry:, and:no-contents-entry:.debuglogging of reasons why files are detected as out ofdate.
Patch by Eric Larson.
source-readevents for files read viathe :dudir:
includedirective.Patch by Halldor Fannar.
585built-in generics.Patch by Riccardo Mori.
SigElementFallbackTransformfallback logic and signaturetext elements nodes. See :doc:
the documentation </extdev/nodes>for moredetails.
Patch by Bénédikt Tran.
python -m sphinx build ....Bugs fixed
Patch by Ralf Grubenmann.
Patch by Adrian Vollmer.
missing or broken links.
Patch by Albert Shih.
gettextbuilder.Patch by Alvin Wong.
graphviz_dotis falsy.with the
translated=Trueattribute.type comments
#: :meta ...:when using :mod:sphinx.ext.napoleon.Patch by Bénédikt Tran.
Patch by Dmitry Shachnev.
~typing.Literalenumerationvalues now render correctly.
Patch by Bénédikt Tran.
sphinx.ext.coverageextension.Patch by Stephen Finucane.
devices in the
agogotheme.Patch by Lukas Engelter.
sphinx.ext.autodoc.preserve_defaults.Patch by Bénédikt Tran.
Testing
v7.1.2Compare Source
=====================================
Bugs fixed
linkcheck_anchorsand do not spuriously report failures to validate anchors.
Patch by James Addison.
v7.1.1Compare Source
=====================================
Bugs fixed
SOURCE_DATE_EPOCHin multi-line copyright footer.Patch by Bénédikt Tran.
v7.1.0Compare Source
=====================================
Incompatible changes
Releases are no longer signed, given the
change in PyPI policy_... _change in PyPI policy: https://blog.pypi.org/posts/2023-05-23-removing-pgp/
Deprecated
(namely,
module,keyword,operator,object,exception,statement, andbuiltin) in the :rst:dir:indexdirective, andset the removal version to Sphinx 9. Patch by Adam Turner.
Features added
generated HTML, using the CRC32 algorithm.
~sphinx.application.Sphinx.require_sphinxnow allows the versionrequirement to be specified as
(major, minor).:confval:
maximum_signature_line_lengthand the domain-specific variants.If the length of the signature (in characters) is greater than the configured
limit, each parameter in the signature will be split to its own logical line.
This behaviour may also be controlled by options on object description
directives, for example :rst:dir:
py:function:single-line-parameter-list.Patch by Thomas Louf, Adam Turner, and Jean-François B.
Patch by Stefanie Molin
sphinx.util.display.status_iteratornow clears the current linewith ANSI control codes, rather than overprinting with space characters.
Patch by James Addison.
translatedattribute on translated nodes.sphinx-build -Tin parallel builds. Patch by Bénédikt Tran
py:classand :rst:dir:py:functiondirectives for PEP 695 (generic classes and functions declarations) and
PEP 696 (default type parameters). Multi-line support (#11011) is enabled
for type parameters list and can be locally controlled on object description
directives, e.g., :rst:dir:
py:function:single-line-type-parameter-list.Patch by Bénédikt Tran.
via :confval:
linkcheck_anchors_ignore_for_urlwhilestill checking the validity of the page itself.
Patch by Bénédikt Tran
via a new substitution (
|translation progress|) and a newconfiguration variable (:confval:
translation_progress_classes).These enable determining the percentage of translated elements within
a document, and the remaining translated and untranslated elements.
Bugs fixed
Restored the
footnote-referenceclass that has been removed inthe latest (unreleased) version of Docutils.
#11486: Use :rfc:
8081font file MIME types in the EPUB builder.Using the correct MIME type will prevent warnings from
epubcheckand will generate a valid EPUB.
#11435: Use microsecond-resolution timestamps for outdated file detection
in
BuildEnvironment.get_outdated_files.#11437: Top-level headings starting with a reStructuredText role
now render properly when :confval:
rst_prologis set.Previously, a file starting with the below would have
improperly rendered due to where the prologue text
was inserted into the document.
.. code:: rst
:mod:
lobster-- The lobster module...
Patch by Bénédikt Tran.
#11337: Fix a
MemoryErrorinsphinx.ext.intersphinxwhen usingNoneor
typing.*as inline type references. Patch by Bénédikt Tran (picnixz)Testing
docutils.confin test directories when runningSphinxTestApp.cleanup().v7.0.1Compare Source
=====================================
Dependencies
Docutils 0.20_. Patch by Adam Turner... _Docutils 0.20: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-20-2023-05-04
Bugs fixed
sphinx.setup_commandfollowing the removal of support for setuptools.
Patch by Willem Mulder.
v7.0.0Compare Source
=====================================
Incompatible changes
MecabSplitterandDefaultSplitterinsphinx.search.ja.make_old_idfunctions in domain objectdescription classes.
build_sphinxhook insetup.py).sphinx.ext.napoleon.iteratorsmodule.jsdumpformat insphinx.search.localea required argument tosphinx.util.i18n.format_date().sphinx.util.stemmermodule.sphinx.pycode.ast.parse()function.sphinx.io.read_doc()function.sphinx.util.get_matching_files()function.sphinx.util.docutils.is_html5_writer_available()function.
envargument toBuildersubclasses required.stylekey for HTML templates.sphinx.writers.latex.LaTeXTranslator.docclassesattribute.
sphinx.builders.html.html5_readyandsphinx.builders.html.HTMLTranslatorattributes.Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.