Setuptools

=======


Changes
-------
* 3430: Merge with pypa/distutils152c13d including pypa/distutils155 (improved compatibility for editable installs on homebrew Python 3.9), pypa/distutils150 (better handling of runtime_library_dirs on cygwin), and pypa/distutils151 (remove warnings for namespace packages).

=======


Breaking Changes
----------------
* 3421: Drop setuptools' support for installing an entrypoint extra requirements at load time:
- the functionality has been broken since v60.8.0.
- the mechanism to do so is deprecated (``fetch_build_eggs``).
- that use case (e.g. a custom command class entrypoint) is covered by making sure the necessary build requirements are declared.

Documentation changes
---------------------
* 3305: Updated the example pyproject.toml -- by :user:`jacalata`
* 3394: This updates the documentation for the ``file_finders`` hook so that
the logging recommendation aligns with the suggestion to not use
``distutils`` directly.
* 3397: Fix reference for ``keywords`` to point to the Core Metadata Specification
instead of PEP 314 (the live standard is kept always up-to-date and
consolidates several PEPs together in a single document).
* 3402: Reordered the User Guide's Table of Contents -- by :user:`codeandfire`

=======


Changes
-------
* 3253: Enabled using ``file:`` for requirements in setup.cfg -- by :user:`akx`
(this feature is currently considered to be in **beta** stage).
* 3255: Enabled using ``file:`` for dependencies and optional-dependencies in pyproject.toml -- by :user:`akx`
(this feature is currently considered to be in **beta** stage).
* 3391: Updated ``attr:`` to also extract simple constants with type annotations -- by :user:`karlotness`

=======


Changes
-------
* 3347: Changed warnings and documentation notes about *experimental* aspect of ``pyproject.toml`` configuration:
now ``[project]`` is a fully supported configuration interface, but the ``[tool.setuptools]`` table
and sub-tables are still considered to be in **beta** stage.
* 3383: In _distutils_hack, suppress/undo the use of local distutils when select tests are imported in CPython.

Documentation changes
---------------------
* 3368: Added documentation page about extension modules -- by :user:`mkoeppe`
* 3371: Moved documentation from ``/userguide/commands`` to ``/depracted/commands``.
This change was motived by the fact that running ``python setup.py`` directly is
considered a deprecated practice.
* 3372: Consolidated sections about ``sdist`` contents and ``MANIFEST.in`` into a single page.

Added a simple ``MANIFEST.in`` example.
* 3373: Moved remarks about using :pypi:`Cython` to the newly created page for
extension modules.
* 3374: Added clarification that using ``python setup.py egg_info`` commands to
manage project versions is only supported in a *transitional* basis, and
that eventually ``egg_info`` will be deprecated.

Reorganized sections with tips for managing versions.
* 3378: Updated ``Quickstart`` docs to make it easier to follow for beginners.

Misc
----
* 3385: Modules used to parse and evaluate configuration from ``pyproject.toml`` files are
intended for internal use only and that not part of the public API.

=======


Changes
-------
* 3256: Added setuptools.command.build command to match distutils.command.build -- by :user:`isuruf`
* 3366: Merge with pypa/distutils75ed79d including reformat using black, fix for Cygwin support (pypa/distutils139), and improved support for cross compiling (pypa/distutils144 and pypa/distutils145).

Documentation changes
---------------------
* 3355: Changes to the User Guide's Entry Points page -- by :user:`codeandfire`
* 3361: Further minor corrections to the Entry Points page -- by :user:`codeandfire`
* 3363: Rework some documentation pages to de-emphasize ``distutils`` and the history
of packaging in the Python ecosystem. The focus of these changes is to make the
documentation easier to read for new users.
* 3364: Update documentation about dependency management, removing mention to
the deprecated ``dependency_links`` and adding some small improvements.
* 3367: Extracted text about automatic resource extraction and the zip-safe flag
from ``userguide/miscellaneous`` to ``deprecated/resource_extraction`` and
``deprecated/zip_safe``.

Extracted text about additional metadata files from
``userguide/miscellaneous`` into the existing ``userguide/extension``
document.

Updated ``userguide/extension`` to better reflect the status of the
setuptools project.

Removed ``userguide/functionalities_rewrite`` (a virtually empty part of the
docs).

=======


Documentation changes
---------------------
* 3349: Fixed two small issues preventing docs from building locally -- by :user:`codeandfire`
* 3350: Added note explaining ``package_data`` glob pattern matching for dotfiles -- by :user:`comabrewer`
* 3358: Clarify the role of the ``package_dir`` configuration.

Misc
----
* 3354: Improve clarity in warning about unlisted namespace packages.