Setuptools

=======


Changes
-------
* 3849: Overhaul warning system for better visibility.

Documentation changes
---------------------
* 3859: Added a note about historical presence of ``wheel``
in ``build-system.requires``, in ``pyproject.toml``.
* 3893: Improved the documentation example regarding making a thin :pep:`517` in-tree
backend wrapper of ``setuptools.build_meta`` that is future-proof and supports
:pep:`660` hook too -- by :user:`webknjaz`.

Misc
----
* 3884: Add a ``stacklevel`` parameter to ``warnings.warn()`` to provide more information to the user.
-- by :user:`cclauss`

=======


Misc
----
* 3865: Fixed ``_WouldIgnoreField`` warnings for ``scripts`` and ``gui_scripts``,
when ``entry-points`` is not listed in dynamic.
* 3875: Update code generated by ``validate-pyproject`` to use v0.12.2.
This should fix default license patterns when ``pyproject.toml`` is used.

=======


Changes
-------
* 3804: Added caching for supported wheel tags.
* 3846: Added pruning heuristics to ``PackageFinder`` based on ``exclude``.

=======


Misc
----
* 3836: Fixed interaction between ``setuptools``' package auto-discovery and
auto-generated ``htmlcov`` files.

Previously, the ``htmlcov`` name was ignored when searching for single-file
modules, however the correct behaviour is to ignore it when searching for
packages (since it is supposed to be a directory, see `coverage config`_)
-- by :user:`yukihiko-shinoda`.

.. _coverage config: https://coverage.readthedocs.io/en/stable/config.html#html-directory
* 3838: Improved error messages for ``pyproject.toml`` validations.
* 3839: Fixed ``pkg_resources`` errors caused when parsing metadata of packages that
are already installed but do not conform with PEP 440.

=======


Changes
-------
* 3843: Although pkg_resources has been discouraged for use, some projects still consider pkg_resources viable for usage. This change makes it clear that pkg_resources should not be used, emitting a DeprecationWarning when imported.

=======


Changes
-------
* 3832: Update vendored ``importlib-metadata`` (to 6.0.0) and
``importlib-resources`` (to 5.10.2)