7 * #3206: Changed ``setuptools.convert_path`` to an internal function that is not exposed
8   as part of setuptools API.
9   Future releases of ``setuptools`` are likely to remove this function.
45 * #3068: Deprecated ``setuptools.config.read_configuration``,
46   ``setuptools.config.parse_configuration`` and other functions or classes
47   from ``setuptools.config``.
50   import a direct replacement from ``setuptools.config.setupcfg``, however this
68   metadata/config (via ``[project]`` table or ``[tool.setuptools]``),
72   - Setuptools will attempt to validate the ``pyproject.toml`` file according
82   Setuptools will try to find these values assuming that the package uses either
96   If setuptools detects modules or packages that are not supposed to be in the
104   Setuptools will adopt the name of the top-level package (or module in the case
117   standards are handled in the ``[tool.setuptools]`` sub-table.
130   ``setuptools`` configuration and project metadata are added to the
134   the ``[tool.setuptools.packages.find]`` section in ``pyproject.toml``.
147 * #3172: Added initial documentation about configuring ``setuptools`` via ``pyproject.toml``
152 * #3065: Refactored ``setuptools.config`` by separating configuration parsing (specific
188 * #3147: Added options to provide a pre-built ``setuptools`` wheel or sdist for being
231 * #3085: Setuptools no longer relies on ``pkg_resources`` for entry point handling.
263 * #3085: Setuptools now vendors importlib_resources and importlib_metadata and jaraco.text. Setupto…
300 * #2897: Added documentation about wrapping ``setuptools.build_meta`` in a in-tree
340 * #2993: In _distutils_hack, for get-pip, simulate existence of setuptools.
397   version of ``setuptools`` under test via the source tree), it was replaced by
418 …ypass the distutils exception for pip when get-pip is being invoked, because it imports setuptools.
431 * #2974: Setuptools now relies on the Python logging infrastructure to log messages. Instead of usi…
436 * #2962: Avoid attempting to use local distutils when the presiding version of Setuptools on the pa…
437 …ke the hook. Avoids compatibility issues between different versions of Setuptools with the distuti…
446 * #2980: Bypass distutils loader when setuptools module is no longer available on sys.path.
510 * #2896: Setuptools once again makes its local copy of distutils the default. To override, set SETU…
596 * #2877: Back out deprecation of setup_requires and replace instead by a deprecation of setuptools.…
623   **deprecated**. Users should extend classes provided by setuptools instead.
631 * #2698: Exposed exception classes from ``distutils.errors`` via ``setuptools.errors``.
638 * #2227: Added new setuptools logo, including editable files and artwork documentation
640 * #2698: Added mentions to ``setuptools.errors`` as a way of handling custom command
713 …Workloads reliant on this behavior should pin to this major version of Setuptools. See `Why you sh…
784 …bution.finalize_options, suppress known removed entry points to avoid issues with older Setuptools.
793 …ojects should port to a unified codebase or pin to an older version of Setuptools using PEP 518 bu…
877 * #2678: Moved Setuptools' own entry points into declarative config.
878 * #2680: Vendored :pypi:`more_itertools` for Setuptools.
879 * #2681: Setuptools own setup.py no longer declares setup_requires, but instead expects wheel to be…
884   Towncrier and show the previews of not-yet-released setuptools versions
895 * #2641: Setuptools will now always try to use the latest supported
976 * #2595: Reduced scope of dash deprecation warning to Setuptools/distutils only -- by :user:`meliss…
1009 …in a separate egg-info directory. Build requirements no longer include setuptools itself. Sdist on…
1038 …ved bootstrap script. Now Setuptools requires pip or another pep517-compliant builder such as 'bui…
1144 * #2484: Setuptools has replaced the master branch with the main branch.
1232 * #2380: There are some setuptools specific changes in the
1233   ``setuptools.command.bdist_rpm`` module that are no longer needed, because
1235   3.5.0. Therefore, code was removed from ``setuptools.command.bdist_rpm``.
1245 * #2350: Setuptools reverts using the included distutils by default. Platform maintainers and syste…
1289 …Setuptools overrides the stdlib distutils on import. For environments or invocations where this be…
1313 * #2306: When running as a PEP 517 backend, setuptools does not try to install
1349 * #2316: Removed warning when ``distutils`` is imported before ``setuptools`` when ``distutils`` re…
1359 …Setuptools now provides a .pth file (except for editable installs of setuptools) to the target env…
1379 …when setuptools is imported after distutils modules have been loaded (exempting PyPy for 3.6), dir…
1400 * #2232: In preparation for re-enabling a local copy of distutils, Setuptools now honors an environ…
1440 * #2165: Setuptools no longer installs a site.py file during easy_install or develop installs. As a…
1459 …Setuptools adopts distutils from the Python 3.9 standard library and no longer depends on distutil…
1460 …setuptools" prior to importing anything from distutils. This behavior happens by default when usin…
1551 * #2094: Setuptools now actively crashes under Python 2. Python 3.5 or later is required. Users of …
1602 …ed to use single-source solutions or build tool chains to manage conversions outside of setuptools.
1643 * #308: Allow version number normalization to be bypassed by wrapping in a 'setuptools.sic()' call.
1653 * #1994: Fixed a bug in the "setuptools.finalize_distribution_options" hook that lead to ignoring t…
1665 * #1994: Fixed a bug in the "setuptools.finalize_distribution_options" hook that lead to ignoring t…
1679 … Fix vendored dependencies so importing ``setuptools.extern.some_module`` gives the same object as…
1714 * #1981: Setuptools now declares its ``tests`` and ``docs`` dependencies in metadata (extras).
1741 …Drop support for Python 2. Setuptools now requires Python 3.5 or later. Install setuptools using p…
1769 * #1927: Setuptools once again declares 'setuptools' in the ``build-system.requires`` and adds PEP …
1799 * #1830, #1909: Mark the easy_install script and setuptools command as deprecated, and use `pip <ht…
1816 * #1877: Setuptools now exposes a new entry point hook "setuptools.finalize_distribution_options", …
1826 * #479: Replace usage of deprecated ``imp`` module with local re-implementation in ``setuptools._im…
1941 * #1735: When parsing setup.cfg files, setuptools now requires the files to be encoded as UTF-8. An…
1951 * #1675: Added support for ``setup.cfg``-only projects when using the ``setuptools.build_meta`` bac…
1952 …irements in ``setup_requires`` when ``setup.py`` is invoked from the ``setuptools.build_meta`` bui…
1970 * #1536: ``setuptools`` will now automatically include licenses if ``setup.cfg`` contains a ``licen…
2015 * #1499: ``setuptools.package_index`` no longer relies on the deprecated ``urllib.parse.splituser``…
2027 * #1594: PEP 517 backend no longer declares setuptools as a dependency as it can be assumed.
2074 * #1560: Updated ``setuptools`` distribution documentation to remove some outdated information.
2079 * #1533: Restricted the ``recursive-include setuptools/_vendor`` to contain only .py and .txt files.
2137 …s to clean manually the dist dir to avoid multiple sdist presence, and setuptools no longer needs …
2251 * #1343: The ``setuptools`` specific ``long_description_content_type``,
2281 * #1296: Setuptools now vendors its own direct dependencies, no
2387 * #458: In order to support deterministic builds, Setuptools no
2395   rely on 'setuptools < 37dev'.
2436 * #1143: Added ``setuptools.build_meta`` module, an implementation
2437   of PEP-517 for Setuptools-defined packages.
2544 * #1083: Also use makedirs compatibility throughout setuptools.
2556   support docs built by setuptools' plugins. See
2570 * #980 and others: Once again, Setuptools vendors all
2575   build tools to have dependencies, Setuptools will adopt
2707   dependencies that Setuptools requires to function,
2708   Setuptools now requires these dependencies just like
2710   Setuptools cannot rely on ``setup_requires`` to
2714   As a result, Setuptools no longer supports self upgrade or
2717   ``wheel`` distributions of setuptools.
2720   or upgrade Setuptools using other means, such as
2721   pre-installing the Setuptools dependencies with pip
2726   successfully install Setuptools from its pre-built
2730   setuptools", then your pip is not new enough.
2732   There's an additional issue in pip where setuptools
2735   always upgrade Setuptools first prior to upgrading
2736   other packages that would upgrade Setuptools.
2750 Setuptools, and this recommendation is now explicit in the
2768   ``setuptools.depends``.
2855   <https://setuptools.pypa.io/en/latest/setuptools.html#configuring-setup-using-setup-cfg-files>`_.
2882   Python 3.2 support must use 'setuptools < 30'.
2966 * Updated ``setuptools.command.sdist`` to re-use most of
3178 * #609: Setuptools will now try to download a distribution from
3210   operation (including ``setup.py install`` when setuptools is
3272 * If MSVC++14 is needed ``setuptools.msvc`` now redirect
3278 * #625 and #626: Fixes on ``setuptools.msvc`` mainly
3290 * Renamed ``setuptools.msvc9_support`` to
3291   ``setuptools.msvc``.
3316   https://setuptools.pypa.io/.
3354 * #598: Setuptools now lists itself first in the User-Agent
3387 * Removed ez_setup.py from Setuptools sdist. The
3423   cause déjà vu with distribute and setuptools 0.7 in
3466   e.g. http://setuptools.pypa.io/en/latest/history.html#v20-6-0.
3480   `Github <https://github.com/pypa/setuptools>`_
3481   from `Bitbucket <https://bitbucket.org/pypa/setuptools>`_.
3546 …<https://setuptools.pypa.io/en/latest/setuptools.html#upload-upload-source-and-or-egg-distribution…
3553   from the list of outputs in ``--record``. This version of setuptools
3559 …ps://github.com/pypa/setuptools/commit/0dcee791dfdcfacddaaec79b29f30a347a147413>`_ and `f9bd9b9 <h…
3560 …For FreeBSD, also `honor root certificates from ca_root_nss <https://github.com/pypa/setuptools/co…
3574 * ``setuptools.launch`` shim now loads scripts in a new
3576   the setuptools package on Python 2.
3581 * Added a new entry script ``setuptools.launch``,
3584   distutils-only packages under setuptools in the same way that
3585   pip does, causing the setuptools monkeypatching of distutils
3588   setuptools when pip isn't available or otherwise does not
3591     $ python -m setuptools.launch setup.py develop
3653   the latest version of setuptools (using PyPI JSON API) rather
3668   with setuptools hidden. Fixes regression introduced in Setuptools
3724   <https://github.com/pypa/setuptools/commit/94416707fd59a65f4a8f7f70541d6b3fc018b626>`_.
3726   <https://github.com/pypa/setuptools/commit/57ebfa41e0f96b97e599ecd931b7ae8a143e096e>`_.
3737 * Correct another regression in setuptools.findall
3743 * Issue #425: Correct regression in setuptools.findall.
3748 * BB Pull Request #135: Setuptools now allows disabling of
3753   with manipulation disabled, setuptools packages will be appended to
3763 * Refactor setuptools.findall in preparation for re-submission
3790     ext = setuptools.Extension('mylib', ['src/CythonStuff.pyx', 'src/CStuff.c'])
3791     setuptools.setup(
3797   For compatibility with older versions of setuptools, packagers should
3800   However, for systems with this build of setuptools, Cython will be
3811 …<https://bitbucket.org/pypa/setuptools/commits/f572ec9563d647fa8d4ffc534f2af8070ea07a8b#comment-18…
3832 * BB Pull Request #133: Removed ``setuptools.tests`` from the
3848 * Fix ``setuptools.sandbox._execfile()`` with Python 3.1.
3901   allow for re-use of existing repository of setuptools versions. See
3927 * Issue #356: Back out BB Pull Request #119 as it requires Setuptools 10 or later
3943 * Fix ``setuptools.command.easy_install.extract_wininst_cfg()``
3945 * Issue #354. Added documentation on building setuptools
3989 * Restore ``setuptools.command.easy_install.sys_executable`` for pbr
3996 * Issue #188: Setuptools now support multiple entities in the value for
4030 * Issue #281: Since Setuptools 6.1 (Issue #268), a ValueError would be raised
4076 * Issue #315: Updated setuptools to hide its own loaded modules during
4077   installation of another package. This change will enable setuptools to
4085   <https://github.com/pypa/setuptools/commit/170657b68f4b92e7e1bf82f5e19a831f5744af67>`_.
4096   where Setuptools was unable to upgrade over earlier versions.
4106 * Issue #311: Decoupled pkg_resources from setuptools once again.
4159   pkg_resources and setuptools. This change
4162 …<https://bitbucket.org/pypa/setuptools/commits/dcd552da643c4448056de84c73d56da6d70769d5#chg-setupt…
4164   supported. Setuptools now "vendors" the `packaging
4174   later phases or invocations of setuptools will not detect the package as
4204 * Issue #100: When building a distribution, Setuptools will no longer match
4227 * Issue #258: Setuptools now patches distutils msvc9compiler to
4262 * Issue #239: Setuptools now includes the setup_requires directive on
4299   <https://setuptools.pypa.io/en/latest/developer-guide.html>`_ to the official
4335 * Issue #218: Setuptools 3.8.1 superseded 4.0.1, and 4.x was removed
4410   platforms/environments without stack support (issuing a warning). Setuptools
4417 * Add ``include`` parameter to ``setuptools.find_packages()``.
4456 * Issue #148: When building (bdist_egg), setuptools no longer adds
4460 * Issue #7: Setuptools itself is now distributed as a zip archive in addition to
4514   setuptools for those versions of Python should use setuptools 1.x.
4515 * Removed ``setuptools.command.easy_install.HAS_USER_SITE``. Clients
4590   from wheels. Therefore, if using Pip to install setuptools from a wheel,
4592 * Setuptools "natural" launcher support, introduced in 1.0, is now officially
4649 * Issue #60: On Windows, Setuptools supports deferring to another launcher,
4659   wget for retrieving the Setuptools tarball for improved security of the
4711   upgrading over other releases of Setuptools.
4781 * Issue #10: ``ez_setup.py`` now uses HTTPS to download setuptools from PyPI.
4791 * Merged Setuptools and Distribute. See docs/merge.txt for details.
4793 Added several features that were slated for setuptools 0.6c12:
4797   PEP-426 environment marker for "extra" dependencies. Setuptools uses this
4840   restoring ability to upgrade from an older setuptools version.
4845 * ``distribute_setup.py`` has been updated to allow Setuptools 0.7 to
4857 * Distribute #337: Moved site.py to setuptools/site-patch.py (graft of very old
4858   patch from setuptools trunk which inspired PR #31).
4915 * Distribute #278: Restored compatibility with distribute 0.6.22 and setuptools
4917   parsing as intended in setuptools 0.6.
5123 * Distribute #174: Fixed the edit mode when its used with setuptools itself
5164 * Distribute #90: unknown setuptools version can be added in the working set
5185   the setup script patches setuptools.
5190 * Added "check_packages" in dist. (added in Setuptools 0.6c11)
5200   can drive an installation that doesn't patch a global setuptools.
5231 * Distribute no longer shadows setuptools if we require a 0.7-series
5232   setuptools. And an error is raised when installing a 0.7 setuptools with
5236   setuptools egg, whether in a shared egg directory or a system setuptools.
5255 setuptools  section in 0.6.3
5268 setuptools  section in 0.6.2
5272   This closes Old Setuptools #39.
5278   This closes Old Setuptools #44.
5281   This closes Old Setuptools #2.
5284   This closes Old Setuptools #41.
5293 * Make sure setuptools is patched when running through easy_install
5294   This closes Old Setuptools #40.
5299 setuptools  section in 0.6.1
5305 * zip_ok is now False by default. This closes Old Setuptools #33.
5307 * Fixed invalid URL error catching. Old Setuptools #20.
5319 * The bootstrap process leave setuptools alone if detected in the system
5326 setuptools  section in 0.6
5382  * Allow ``ez_setup.use_setuptools()`` to upgrade existing setuptools
5460  * Fix "eggsecutables" (such as setuptools' own egg) only being runnable with
5512    platforms.  (This is mainly so that setuptools itself can have a single-file
5558  * The ``ez_setup`` module displays the conflicting version of setuptools (and
5562  * Running ``setup.py develop`` on a setuptools-using project will now install
5563    setuptools if needed, instead of only downloading the egg.
5568  * The ``ez_setup.py`` script now actually works when you put a setuptools
5601  * EasyInstall now includes setuptools version information in the
5653  * Fix mysterious errors during initial ``setuptools`` install, caused by
5696  * Added ``setuptools.file_finders`` entry point group to allow implementing
5713    setuptools.
5822  * Added an ``unpack_directory()`` driver to ``setuptools.archive_util``, so
5838    format. Running ``bdist_wininst`` on a setuptools-based package wraps the
5855    format.  Running ``bdist_wininst`` on a setuptools-based package wraps the
5883    being a corrupted egg. Setuptools now monkeypatches the distribution
5910    by Ian Bicking.  The setuptools egg now contains a hacked ``site`` module
5958    ``setuptools`` and define appropriate entry points.  On Windows, console
5981    the setuptools egg, and attempts to check the downloaded egg against an
5993  * ``setuptools`` now embeds itself more thoroughly into the distutils, so that
5994    other distutils extensions (e.g. py2exe, py2app) will subclass setuptools'
6001  * ``setuptools`` now finds its commands, ``setup()`` argument validators, and
6004    <https://setuptools.pypa.io/en/latest/setuptools.html#creating-distutils-extensions>`_
6067  * Fix ``python -m easy_install`` not working due to setuptools being installed
6095  * Added ``exclude=patternlist`` option to ``setuptools.find_packages()``
6129    take effect for egg files that were built with older ``setuptools``
6175  * There is now a separate documentation page for setuptools; revision
6206  * Added ``develop`` command to ``setuptools``-based packages. This command
6213  * Added ``egg_info`` command to ``setuptools``-based packages. This command
6224  * Made ``easy_install`` a standard ``setuptools`` command, moving it from
6225    the ``easy_install`` module to ``setuptools.command.easy_install``. Note
6233  * Setup scripts using setuptools can now list their dependencies directly in
6240    see the ``setuptools.dist.Distribution`` class.
6242  * Setup scripts using setuptools now always install using ``easy_install``
6257    dependencies by using setuptools.  If a package has requirements it didn't
6284    setuptools as part of their setup process::
6289     from setuptools import setup
6318  * Added ``ez_setup.py`` installer/bootstrap script to make initial setuptools
6319    installation easier, and to allow distributions using setuptools to avoid
6320    having to include setuptools in their source distribution.
6325    been moved to the new ``setuptools.package_index`` module.
6330    command class based on ``setuptools.Command``.
6332  * There is a new ``setuptools.sandbox.run_setup()`` API to invoke a setup
6333    script in a directory sandbox, and a new ``setuptools.archive_util`` module
6337  * ``setuptools.Command`` now supports reinitializing commands using keyword