This is a bugfix release to fix two regressions in the new f-string parser introduced in24.4.1.Parser- Fix regression where certain complex f-strings failed to parse (4332)Performance- Fix bad performance on certain complex string literals (4331)

Highlights- Add support for the new Python 3.12 f-string syntax introduced by PEP 701 (3822)Stable style- Fix crash involving indented dummy functions containing newlines (4318)Parser- Add support for type parameter defaults, a new syntactic feature added to Python 3.13by PEP 696 (4327)Integrations- Github Action now works even when `git archive` is skipped (4313)

* B909: Fix false positive affecting containers of mutables (469)

* B950: Add pragma comment to line length ignores (463)* B909: Add more cases to detect + more container mutating functions (460)

=====================================Bugs fixed----------* 12299: Defer loading themes defined via entry points untiltheir explicit use by the user or a child theme.Patch by Adam Turner.* 12305: Return the default value for ``theme.get_config()`` withan unsupported theme configuration section.Patch by Adam Turner.

=====================================Bugs fixed----------* 12295: Re-export all AST types in the C and C++ domains.Patch by Adam Turner.* 12295: Re-export various objects from ``sphinx.domains.python._annotations``in ``sphinx.domains.python``.Patch by Jacob Chesslo and Adam Turner.

=====================================Bugs fixed----------* 12295: Re-export various objects from ``sphinx.domains.python._object``in ``sphinx.domains.python``.Patch by Jacob Chesslo and Adam Turner.

=====================================Bugs fixed----------* Handle cases when ``Any`` is not an instance of ``type``.Patch by Adam Turner.

=====================================Bugs fixed----------* 12290: Fix a false-positive warning when setting a configuration valuewith ``Any`` as the valid type to a type other than the value's default.Patch by Adam Turner.

=====================================Bugs fixed----------* Preload all themes defined via entry points.Patch by Adam Turner.* Fix a bad interaction between the ``'Furo'`` theme and the new-style forconfiguration values.Patch by Adam Turner.

=====================================Dependencies------------* Require ``tomli`` on Python 3.10 and earlier.Patch by Adam Turner.

=====================================Dependencies------------* 11858: Increase the minimum supported version of Alabaster to 0.7.14.Patch by Adam Turner.* 11411: Support `Docutils 0.21`_. Patch by Adam Turner... _Docutils 0.21: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09* 12012: Use ``types-docutils`` instead of ``docutils-stubs``.Deprecated----------* 11693: Support for old-style :file:`Makefile` and :file:`make.bat` outputin :program:`sphinx-quickstart`, and the associated options :option:`!-M`,:option:`!-m`, :option:`!--no-use-make-mode`, and :option:`!--use-make-mode`.* 11285: Direct access to :attr:`!sphinx.testing.util.SphinxTestApp._status`or :attr:`!sphinx.testing.util.SphinxTestApp._warning` is deprecated. Usethe public properties :attr:`!sphinx.testing.util.SphinxTestApp.status`and :attr:`!sphinx.testing.util.SphinxTestApp.warning` instead.Patch by Bénédikt Tran.* tests: :func:`!sphinx.testing.util.strip_escseq` is deprecated in favour of:func:`!sphinx.util.console.strip_colors`.Patch by Bénédikt Tran.Features added--------------* 12265: Support theme configuration via ``theme.toml``.* 11701: HTML Search: Adopt the new `\<search\>`_ element.Patch by Bénédikt Tran... _`\<search\>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/search* 11776: Add long option names to ``sphinx-build``.Patch by Hugo van Kemenade, Adam Turner, Bénédikt Tran, and Ezio Melotti.* Organise the ``sphinx-build`` options into groups.Patch by Adam Turner.* 11855: Defer computation of configuration values.Patch by Adam Turner.* Add ``:no-search:`` as an alias of the ``:nosearch:`` metadata field.Patch by Adam Turner.* 11803: autodoc: Use an overriden ``__repr__()`` function in an enum,if defined. Patch by Shengyu Zhang.* 11825: Allow custom targets in the manpage role.Patch by Nicolas Peugnet.* 11892: Improved performance when resolving cross references in the C++ domain.Patch by Rouslan Korneychuk.* 11905: Add a :rst:dir:`versionremoved` directive.Patch by Hugo van Kemenade, Adam Turner, and C.A.M. Gerlach.* 11981: Improve rendering of signatures using ``slice`` syntax,e.g., ``def foo(arg: np.float64[:,:]) -> None: ...``.* The manpage builder now adds `OSC 8`_ anchors to hyperlinks, usingthe `groff`_ device control command... _OSC 8: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda.. _groff: https://lists.gnu.org/archive/html/groff/2021-10/msg00000.html* 11015: Change the text of the :rst:dir:`versionadded` directive from``New in [...]`` to ``Added in [...]``.Patch by Bénédikt Tran.* 12131: Added :confval:`show_warning_types` configuration option.Patch by Chris Sewell.* 12193: Improve ``external`` warnings for unknown roles.In particular, suggest related role names if an object type is mistakenly used.Patch by Chris Sewell.* Add public type alias :class:`sphinx.util.typing.ExtensionMetadata`.This can be used by extension developersto annotate the return type of their ``setup`` function.Patch by Chris Sewell.Bugs fixed----------* 11668: Raise a useful error when ``theme.conf`` is missing.Patch by Vinay Sajip.* 11622: Ensure that the order of keys in ``searchindex.js`` is deterministic.Patch by Pietro Albini.* 11617: ANSI control sequences are stripped from the output when writing toa warnings file with :option:`-w <sphinx-build -w>`.Patch by Bénédikt Tran.* 11666: Skip all hidden directories in ``CatalogRepository.pofiles``.Patch by Aryaz Eghbali.* 9686: html builder: Fix MathJax lazy loading when equations appear in titles.Patch by Bénédikt Tran.* 11483: singlehtml builder: Fix MathJax lazy loading when the index does notcontain any math equations.Patch by Bénédikt Tran.* 11697: HTML Search: add 'noindex' meta robots tag.Patch by James Addison.* 11678: Fix a possible ``ZeroDivisionError`` in ``sphinx.ext.coverage``.Patch by Stephen Finucane.* 11756: LaTeX: build error with recent TeXLive due to missing ``substitutefont``package (triggered if using ``fontenc`` with ``T2A`` option and documentlanguage is not a Cyrillic one).Patch by Jean-François B.* 11675: Fix rendering of progression bars in environments that do not supportANSI control sequences.Patch by Bénédikt Tran.* 11861: Whitelist more types with an incorrect ``__module__`` attribute.Patch by Adam Turner.* 11715: Apply ``tls_verify`` and ``tls_cacerts`` config to``ImageDownloader``.Patch by Nick Touran.* Allow hyphens in group names for :rst:dir:`productionlist` cross-references.Patch by Adam Turner.* 11433: Added the :confval:`linkcheck_allow_unauthorized` configuration option.Set this option to ``False`` to report HTTP 401 (unauthorized) serverresponses as broken.Patch by James Addison.* 11868: linkcheck: added a distinct ``timeout`` reporting status code.This can be enabled by setting :confval:`linkcheck_report_timeouts_as_broken`to ``False``.Patch by James Addison.* 11869: Refresh the documentation for the ``linkcheck_timeout`` setting.Patch by James Addison.* 11874: Configure a default 30-second value for ``linkcheck_timeout``.Patch by James Addison.* 11886: Print the Jinja2 template path chain in ``TemplateNotFound`` exceptions.Patch by Colin Marquardt.* 11598: Do not use query components in URLs for assets in EPUB rendering.Patch by David Runge.* 11904: Support unary subtraction when parsing annotations.Patch by James Addison.* 11925: Blacklist the ``sphinxprettysearchresults`` extension; the functionalityit provides was merged into Sphinx v2.0.0.Patch by James Addison.* 11917: Fix rendering of annotated inherited members for Python 3.9.Patch by Janet Carson.* 11935: C Domain: Fix namespace-pop context.Patch by Frank Dana.* 11923: Avoid zombie processes when parallel builds fail.Patch by Felix von Drigalski.* 11353: Support enumeration classes inheriting from mixin or data types.Patch by Bénédikt Tran.* 11962: Fix target resolution when using ``:paramtype:`` fields.Patch by Bénédikt Tran.* 11944: Use anchor in search preview.Patch by Will Lachance.* 12008: Fix case-sensitive lookup of ``std:label`` names in intersphinx inventory.Patch by Michael Goerz.* 11958: HTML Search: Fix partial matches overwriting full matches.Patch by William Lachance.* 11959: Fix multiple term matching when word appears in both title and document.Patch by Will Lachance.* 11474: Fix doctrees caching causing files not be rebuilt in some cases,e.g., when :confval:`numfig` is ``True``.Patch by Bénédikt Tran.* 11278: autodoc: Fix rendering of :class:`functools.singledispatchmethod`combined with :func:`classmethod <classmethod>`.Patch by Bénédikt Tran.* 11894: Do not add checksums to css files if building using the htmlhelp builder.Patch by reduerK akiM.* 12052: Remove ``<script>`` and ``<style>`` tags from the content of search resultsummary snippets.Patch by James Addison.* 11578: HTML Search: Order non-main index entries after other results.Patch by Brad King.* 12147: autosummary: Fix a bug whereby the wrong file extensionmay be used,when multiple suffixes are specified in :confval:`source_suffix`.Patch by Sutou Kouhei.* 10786: improve the error message when a file to be copied (e.g., an asset)is removed during Sphinx execution.Patch by Bénédikt Tran.* 12040: HTML Search: Ensure that document titles that are partially-matched bythe user search query are included in search results.Patch by James Addison.* 11970: singlehtml builder: make target URIs to be same-document references inthe sense of :rfc:`RFC 3986, §4.4 <3986section-4.4>`, e.g., ``index.htmlfoo``becomes ``foo``. Patch by Eric Norige.* 12271: Partially revert Docutils' r9562__ to fix EPUB files.Patch by Adam Turner.__ https://sourceforge.net/p/docutils/code/9562/* 12253: Escape reserved path characters in the remote images post-transformdownload cache.Patch by James Addison and Adam Turner.Testing-------* Reorganise tests into directories.Patch by Adam Turner.* Clean up global state in ``SphinxTestApp``.Patch by Adam Turner.* 11285: :func:`!pytest.mark.sphinx` and :class:`!sphinx.testing.util.SphinxTestApp`accept *warningiserror*, *keep_going* and *verbosity* as keyword arguments.Patch by Bénédikt Tran.* 11285: :class:`!sphinx.testing.util.SphinxTestApp` *status* and *warning*arguments are checked to be :class:`io.StringIO` objects (the public APIincorrectly assumed this without checking it).Patch by Bénédikt Tran.* Report the result of ``test_run_epubcheck`` as ``skipped`` instead of``success`` when either Java or ``epubcheck`` are not available.* Use dynamic allocation of unused port numbers for the test HTTP(S) servers.As a side-effect, this removes the need for test server lockfiles,meaning that any remaining ``tests/test-server.lock`` files can safely bedeleted.

* Add type stub file to `setup.py`.

* Drop support for Python 3.7. Thanks kloczek.

* Include type stubs in release.

* Add job provider for `cs_CZ`. Thanks george0st.

* Add geo provider for `sk_SK`. Thanks george0st.* Clean up data in `sk_SK` job provider. Thanks george0st.

* Remove offensive word from `pl_PL` lorem provider. Thanks Rey092.

* Tune `cs_CZ` phone number validation. Thanks george0st.

* Update list of `first_name_*` and `last_name` in `pt_BR` `PersonProvider`. Thanks dclobato.

=========================Deprecations------------- `12069 <https://github.com/pytest-dev/pytest/issues/12069>`_: A deprecation warning is now raised when implementations of one of the following hooks request a deprecated ``py.path.local`` parameter instead of the ``pathlib.Path`` parameter which replaced it:- :hook:`pytest_ignore_collect` - the ``path`` parameter - use ``collection_path`` instead.- :hook:`pytest_collect_file` - the ``path`` parameter - use ``file_path`` instead.- :hook:`pytest_pycollect_makemodule` - the ``path`` parameter - use ``module_path`` instead.- :hook:`pytest_report_header` - the ``startdir`` parameter - use ``start_path`` instead.- :hook:`pytest_report_collectionfinish` - the ``startdir`` parameter - use ``start_path`` instead.The replacement parameters are available since pytest 7.0.0.The old parameters will be removed in pytest 9.0.0.See :ref:`legacy-path-hooks-deprecated` for more details.Features--------- `11871 <https://github.com/pytest-dev/pytest/issues/11871>`_: Added support for reading command line arguments from a file using the prefix character `, like e.g.: ``pytest tests.txt``. The file must have one argument per line.See :ref:`Read arguments from file <args-from-file>` for details.Improvements------------- `11523 <https://github.com/pytest-dev/pytest/issues/11523>`_: :func:`pytest.importorskip` will now issue a warning if the module could be found, but raised :class:`ImportError` instead of :class:`ModuleNotFoundError`.The warning can be suppressed by passing ``exc_type=ImportError`` to :func:`pytest.importorskip`.See :ref:`import-or-skip-import-error` for details.- `11728 <https://github.com/pytest-dev/pytest/issues/11728>`_: For ``unittest``-based tests, exceptions during class cleanup (as raised by functions registered with :meth:`TestCase.addClassCleanup <unittest.TestCase.addClassCleanup>`) are now reported instead of silently failing.- `11777 <https://github.com/pytest-dev/pytest/issues/11777>`_: Text is no longer truncated in the ``short test summary info`` section when ``-vv`` is given.- `12112 <https://github.com/pytest-dev/pytest/issues/12112>`_: Improved namespace packages detection when :confval:`consider_namespace_packages` is enabled, covering more situations (like editable installs).- `9502 <https://github.com/pytest-dev/pytest/issues/9502>`_: Added :envvar:`PYTEST_VERSION` environment variable which is defined at the start of the pytest session and undefined afterwards. It contains the value of ``pytest.__version__``, and among other things can be used to easily check if code is running from within a pytest run.Bug Fixes---------- `12065 <https://github.com/pytest-dev/pytest/issues/12065>`_: Fixed a regression in pytest 8.0.0 where test classes containing ``setup_method`` and tests using ``staticmethod`` or ``classmethod`` would crash with ``AttributeError: 'NoneType' object has no attribute 'setup_method'``.Now the :attr:`request.instance <pytest.FixtureRequest.instance>` attribute of tests using ``staticmethod`` and ``classmethod`` is no longer ``None``, but a fresh instance of the class, like in non-static methods.Previously it was ``None``, and all fixtures of such tests would share a single ``self``.- `12135 <https://github.com/pytest-dev/pytest/issues/12135>`_: Fixed issue where fixtures adding their finalizer multiple times to fixtures they request would cause unreliable and non-intuitive teardown ordering in some instances.- `12194 <https://github.com/pytest-dev/pytest/issues/12194>`_: Fixed a bug with ``--importmode=importlib`` and ``--doctest-modules`` where child modules did not appear as attributes in parent modules.- `1489 <https://github.com/pytest-dev/pytest/issues/1489>`_: Fixed some instances where teardown of higher-scoped fixtures was not happening in the reverse order they were initialized in.Trivial/Internal Changes------------------------- `12069 <https://github.com/pytest-dev/pytest/issues/12069>`_: ``pluggy>=1.5.0`` is now required.- `12167 <https://github.com/pytest-dev/pytest/issues/12167>`_: :ref:`cache <cache>`: create supporting files (``CACHEDIR.TAG``, ``.gitignore``, etc.) in a temporary directory to provide atomic semantics.

=========================Bug Fixes---------- `12114 <https://github.com/pytest-dev/pytest/issues/12114>`_: Fixed error in :func:`pytest.approx` when used with `numpy` arrays and comparing with other types.