Changelog
### 60.3.1
```
-------
Misc
^^^^
* 3002: Suppress AttributeError when detecting get-pip.
```
### 60.3.0
```
-------
Changes
^^^^^^^
* 2993: In _distutils_hack, bypass the distutils exception for pip when get-pip is being invoked, because it imports setuptools.
Misc
^^^^
* 2989: Merge with pypa/distutils788cc159. Includes fix for config vars missing from sysconfig.
```
### 60.2.0
```
-------
Changes
^^^^^^^
* 2974: Setuptools now relies on the Python logging infrastructure to log messages. Instead of using ``distutils.log.*``, use ``logging.getLogger(name).*``.
* 2987: Sync with pypa/distutils2def21c5d74fdd2fe7996ee4030ac145a9d751bd, including fix for missing get_versions attribute (2969), more reliance on sysconfig from stdlib.
Misc
^^^^
* 2962: Avoid attempting to use local distutils when the presiding version of Setuptools on the path doesn't have one.
* 2983: Restore 'add_shim' as the way to invoke the hook. Avoids compatibility issues between different versions of Setuptools with the distutils local implementation.
```
### 60.1.1
```
-------
Misc
^^^^
* 2980: Bypass distutils loader when setuptools module is no longer available on sys.path.
```
### 60.1.0
```
-------
Changes
^^^^^^^
* 2958: In distutils_hack, only add the metadata finder once. In ensure_local_distutils, rely on a context manager for reliable manipulation.
* 2963: Merge with pypa/distutilsa5af364910. Includes revisited fix for pypa/distutils15 and improved MinGW/Cygwin support from pypa/distutils77.
```
### 60.0.5
```
-------
Misc
^^^^
* 2960: Install schemes fall back to default scheme for headers.
```
### 60.0.4
```
-------
Misc
^^^^
* 2954: Merge with pypa/distutilseba2bcd310. Adds platsubdir to config vars available for substitution.
```
### 60.0.3
```
-------
Misc
^^^^
* 2940: Avoid KeyError in distutils hack when pip is imported during ensurepip.
```
### 60.0.2
```
-------
Misc
^^^^
* 2938: Select 'posix_user' for the scheme unless falling back to stdlib, then use 'unix_user'.
```
### 60.0.1
```
-------
Misc
^^^^
* 2944: Add support for extended install schemes in easy_install.
```
### 60.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2896: Setuptools once again makes its local copy of distutils the default. To override, set SETUPTOOLS_USE_DISTUTILS=stdlib.
```
### 59.8.0
```
-------
Changes
^^^^^^^
* 2935: Merge pypa/distutils460b59f0e68dba17e2465e8dd421bbc14b994d1f.
```
### 59.7.0
```
-------
Changes
^^^^^^^
* 2930: Require Python 3.7
```
### 59.6.0
```
-------
Changes
^^^^^^^
* 2925: Merge with pypa/distutils92082ee42c including introduction of deprecation warning on Version classes.
```
### 59.5.0
```
-------
Changes
^^^^^^^
* 2914: Merge with pypa/distutils8f2df0bf6.
```
### 59.4.0
```
-------
Changes
^^^^^^^
* 2893: Restore deprecated support for newlines in the Summary field.
```
### 59.3.0
```
-------
Changes
^^^^^^^
* 2902: Merge with pypa/distutils85db7a41242.
Misc
^^^^
* 2906: In ensure_local_distutils, re-use DistutilsMetaFinder to load the module. Avoids race conditions when _distutils_system_mod is employed.
```
### 59.2.0
```
-------
Changes
^^^^^^^
* 2875: Introduce changes from pypa/distutils514e9d0, including support for overrides from Debian and pkgsrc, unlocking the possibility of making SETUPTOOLS_USE_DISTUTILS=local the default again.
```
### 59.1.1
```
-------
Misc
^^^^
* 2885: Fixed errors when encountering LegacyVersions.
```
### 59.1.0
```
-------
Changes
^^^^^^^
* 2497: Update packaging to 21.2.
* 2877: Back out deprecation of setup_requires and replace instead by a deprecation of setuptools.installer and fetch_build_egg. Now setup_requires is still supported when installed as part of a PEP 517 build, but is deprecated when an unsatisfied requirement is encountered.
* 2879: Bump packaging to 21.2.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2867: PNG/ICO images replaced with SVG in the docs.
* 2867: Added support to SVG "favicons" via "in-tree" Sphinx extension.
```
### 59.0.1
```
-------
Misc
^^^^
* 2880: Removed URL requirement for ``pytest-virtualenv`` in ``setup.cfg``.
PyPI rejects packages with dependencies external to itself.
Instead the test dependency was overwritten via ``tox.ini``
```
### 59.0.0
```
-------
Deprecations
^^^^^^^^^^^^
* 2856: Support for custom commands that inherit directly from ``distutils`` is
**deprecated**. Users should extend classes provided by setuptools instead.
Breaking Changes
^^^^^^^^^^^^^^^^
* 2870: Started failing on invalid inline description with line breaks :class:`ValueError` -- by :user:`webknjaz`
Changes
^^^^^^^
* 2698: Exposed exception classes from ``distutils.errors`` via ``setuptools.errors``.
* 2866: Incorporate changes from pypa/distutilsf1b0a2b.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2227: Added sphinx theme customisations to display the new logo in the sidebar and
use its colours as "accent" in the documentation -- by :user:`abravalheri`
* 2227: Added new setuptools logo, including editable files and artwork documentation
-- by :user:`abravalheri`
* 2698: Added mentions to ``setuptools.errors`` as a way of handling custom command
errors.
* 2698: Added instructions to migrate from ``distutils.commands`` and
``distutils.errors`` in the porting guide.
* 2871: Added a note to the docs that it is possible to install
``setup.py``-less projects in editable mode with :doc:`pip v21.1+
<pip:index>`, only having ``setup.cfg`` and ``pyproject.toml`` in
project root -- by :user:`webknjaz`
```
### 58.5.3
```
-------
Misc
^^^^
* 2849: Add fallback for custom ``build_py`` commands inheriting directly from
:mod:`distutils`, while still handling ``include_package_data=True`` for
``sdist``.
```
### 58.5.2
```
-------
Misc
^^^^
* 2847: Suppress 'setup.py install' warning under bdist_wheel.
```
### 58.5.1
```
-------
Misc
^^^^
* 2846: Move PkgResourcesDeprecationWarning above implicitly-called function so that it's in the namespace when version warnings are generated in an environment that contains them.
```
### 58.5.0
```
-------
Changes
^^^^^^^
* 1461: Fix inconsistency with ``include_package_data`` and ``packages_data`` in sdist
by replacing the loop breaking mechanism between the ``sdist`` and
``egg_info`` commands -- by :user:`abravalheri`
```
### 58.4.0
```
-------
Changes
^^^^^^^
* 2497: Officially deprecated PEP 440 non-compliant versions.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2832: Removed the deprecated ``data_files`` option from the example in the
declarative configuration docs -- by :user:`abravalheri`
* 2832: Change type of ``data_files`` option from ``dict`` to ``section`` in
declarative configuration docs (to match previous example) -- by
:user:`abravalheri`
```
### 58.3.0
```
-------
Changes
^^^^^^^
* 917: ``setup.py install`` and ``easy_install`` commands are now officially deprecated. Use other standards-based installers (like pip) and builders (like build). Workloads reliant on this behavior should pin to this major version of Setuptools. See `Why you shouldn't invoke setup.py directly <https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html>`_ for more background.
* 1988: Deprecated the ``bdist_rpm`` command. Binary packages should be built as wheels instead.
-- by :user:`hugovk`
* 2785: Replace ``configparser``'s ``readfp`` with ``read_file``, deprecated since Python 3.2.
-- by :user:`hugovk`
* 2823: Officially deprecated support for ``setup_requires``. Users are encouraged instead to migrate to PEP 518 ``build-system.requires`` in ``pyproject.toml``. Users reliant on ``setup_requires`` should consider pinning to this major version to avoid disruption.
Misc
^^^^
* 2762: Changed codecov.yml to configure the threshold to be lower
-- by :user:`tanvimoharir`
```
### 58.2.0
```
-------
Changes
^^^^^^^
* 2757: Add windows arm64 launchers for scripts generated by easy_install.
* 2800: Added ``--owner`` and ``--group`` options to the ``sdist`` command,
for specifying file ownership within the produced tarball (similarly
to the corresponding distutils ``sdist`` options).
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2792: Document how the legacy and non-legacy versions are compared, and reference to the `PEP 440 <https://www.python.org/dev/peps/pep-0440/>`_ scheme.
```
### 58.1.0
```
-------
Changes
^^^^^^^
* 2796: Merge with pypa/distutils02e9f65ab0
```
### 58.0.4
```
-------
Misc
^^^^
* 2773: Retain case in setup.cfg during sdist.
```
### 58.0.3
```
-------
Misc
^^^^
* 2777: Build does not fail fast when ``use_2to3`` is supplied but set to a false value.
```
### 58.0.2
```
-------
Misc
^^^^
* 2769: Build now fails fast when ``use_2to3`` is supplied.
```
### 58.0.1
```
-------
Misc
^^^^
* 2765: In Distribution.finalize_options, suppress known removed entry points to avoid issues with older Setuptools.
```
### 58.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2086: Removed support for 2to3 during builds. Projects should port to a unified codebase or pin to an older version of Setuptools using PEP 518 build-requires.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2746: add python_requires example
```
### 57.5.0
```
-------
Changes
^^^^^^^
* 2712: Added implicit globbing support for `[options.data_files]` values.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2737: fix various syntax and style errors in code snippets in docs
```
### 57.4.0
```
-------
Changes
^^^^^^^
* 2722: Added support for ``SETUPTOOLS_EXT_SUFFIX`` environment variable to override the suffix normally detected from the ``sysconfig`` module.
```
### 57.3.0
```
-------
Changes
^^^^^^^
* 2465: Documentation is now published using the Furo theme.
```
### 57.2.0
```
-------
Changes
^^^^^^^
* 2724: Added detection of Windows ARM64 build environments using the ``VSCMD_ARG_TGT_ARCH`` environment variable.
```
### 57.1.0
```
-------
Changes
^^^^^^^
* 2692: Globs are now sorted in 'license_files' restoring reproducibility by eliminating variance from disk order.
* 2714: Update to distutils at pypa/distutilse2627b7.
* 2715: Removed reliance on deprecated ssl.match_hostname by removing the ssl support. Now any index operations rely on the native SSL implementation.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2604: Revamped the backward/cross tool compatibility section to remove
some confusion.
Add some examples and the version since when ``entry_points`` are
supported in declarative configuration.
Tried to make the reading flow a bit leaner, gather some information
that were a bit dispersed.
```
### 57.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2645: License files excluded via the ``MANIFEST.in`` but matched by either
the ``license_file`` (deprecated) or ``license_files`` options,
will be nevertheless included in the source distribution. - by :user:`cdce8p`
Changes
^^^^^^^
* 2628: Write long description in message payload of PKG-INFO file. - by :user:`cdce8p`
* 2645: Added ``License-File`` (multiple) to the output package metadata.
The field will contain the path of a license file, matched by the
``license_file`` (deprecated) and ``license_files`` options,
relative to ``.dist-info``. - by :user:`cdce8p`
* 2678: Moved Setuptools' own entry points into declarative config.
* 2680: Vendored `more_itertools <https://pypi.org/project/more-itertools>`_ for Setuptools.
* 2681: Setuptools own setup.py no longer declares setup_requires, but instead expects wheel to be installed as declared by pyproject.toml.
Misc
^^^^
* 2650: Updated the docs build tooling to support the latest version of
Towncrier and show the previews of not-yet-released setuptools versions
in the changelog -- :user:`webknjaz`
```
### 56.2.0
```
-------
Changes
^^^^^^^
* 2640: Fixed handling of multiline license strings. - by :user:`cdce8p`
* 2641: Setuptools will now always try to use the latest supported
metadata version for ``PKG-INFO``. - by :user:`cdce8p`
```
### 56.1.0
```
-------
Changes
^^^^^^^
* 2653: Incorporated assorted changes from pypa/distutils.
* 2657: Adopted docs from distutils.
* 2663: Added Visual Studio Express 2017 support -- by :user:`dofuuz`
Misc
^^^^
* 2644: Fixed ``DeprecationWarning`` due to ``threading.Thread.setDaemon`` in tests -- by :user:`tirkarthi`
* 2654: Made the changelog generator compatible
with Towncrier >= 19.9 -- :user:`webknjaz`
* 2664: Relax the deprecation message in the distutils hack.
```
### 56.0.0
```
-------
Deprecations
^^^^^^^^^^^^
* 2620: The ``license_file`` option is now marked as deprecated.
Use ``license_files`` instead. -- by :user:`cdce8p`
Breaking Changes
^^^^^^^^^^^^^^^^
* 2620: If neither ``license_file`` nor ``license_files`` is specified, the ``sdist``
option will now auto-include files that match the following patterns:
``LICEN[CS]E*``, ``COPYING*``, ``NOTICE*``, ``AUTHORS*``.
This matches the behavior of ``bdist_wheel``. -- by :user:`cdce8p`
Changes
^^^^^^^
* 2620: The ``license_file`` and ``license_files`` options now support glob patterns. -- by :user:`cdce8p`
* 2632: Implemented ``VendorImporter.find_spec()`` method to get rid
of ``ImportWarning`` that Python 3.10 emits when only the old-style
importer hooks are present -- by :user:`webknjaz`
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2620: Added documentation for the ``license_files`` option. -- by :user:`cdce8p`
```
### 55.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2566: Remove the deprecated ``bdist_wininst`` command. Binary packages should be built as wheels instead. -- by :user:`hroncok`
```
### 54.2.0
```
-------
Changes
^^^^^^^
* 2608: Added informative error message to PEP 517 build failures owing to
an empty ``setup.py`` -- by :user:`layday`
```
### 54.1.3
```
-------
No significant changes.
```
### 54.1.2
```
-------
Misc
^^^^
* 2595: Reduced scope of dash deprecation warning to Setuptools/distutils only -- by :user:`melissa-kun-li`
```
### 54.1.1
```
-------
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2584: Added ``sphinx-inline-tabs`` extension to allow for comparison of ``setup.py`` and its equivalent ``setup.cfg`` -- by :user:`amy-lei`
Misc
^^^^
* 2592: Made option keys in the ``[metadata]`` section of ``setup.cfg`` case-sensitive. Users having
uppercase option spellings will get a warning suggesting to make them to lowercase
-- by :user:`melissa-kun-li`
```
### 54.1.0
```
-------
Changes
^^^^^^^
* 1608: Removed the conversion of dashes to underscores in the :code:`extras_require` and :code:`data_files` of :code:`setup.cfg` to support the usage of dashes. Method will warn users when they use a dash-separated key which in the future will only allow an underscore. Note: the method performs the dash to underscore conversion to preserve compatibility, but future versions will no longer support it -- by :user:`melissa-kun-li`
```
### 54.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2582: Simplified build-from-source story by providing bootstrapping metadata in a separate egg-info directory. Build requirements no longer include setuptools itself. Sdist once again includes the pyproject.toml. Project can no longer be installed from source on pip 19.x, but install from source is still supported on pip < 19 and pip >= 20 and install from wheel is still supported with pip >= 9.
Changes
^^^^^^^
* 1932: Handled :code:`AttributeError` by raising :code:`DistutilsSetupError` in :code:`dist.check_specifier()` when specifier is not a string -- by :user:`melissa-kun-li`
* 2570: Correctly parse cmdclass in setup.cfg.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2553: Added userguide example for markers in extras_require -- by :user:`pwoolvett`
```
### 53.1.0
```
-------
Changes
^^^^^^^
* 1937: Preserved case-sensitivity of keys in setup.cfg so that entry point names are case-sensitive. Changed sensitivity of configparser. NOTE: Any projects relying on case-insensitivity will need to adapt to accept the original case as published. -- by :user:`melissa-kun-li`
* 2573: Fixed error in uploading a Sphinx doc with the :code:`upload_docs` command. An html builder will be used.
Note: :code:`upload_docs` is deprecated for PyPi, but is supported for other sites -- by :user:`melissa-kun-li`
```
### 53.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 1527: Removed bootstrap script. Now Setuptools requires pip or another pep517-compliant builder such as 'build' to build. Now Setuptools can be installed from Github main branch.
```
### 52.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2537: Remove fallback support for fetch_build_eggs using easy_install. Now pip is required for setup_requires to succeed.
* 2544: Removed 'easy_install' top-level model (runpy entry point) and 'easy_install' console script.
* 2545: Removed support for eggsecutables.
Changes
^^^^^^^
* 2459: Tests now run in parallel via pytest-xdist, completing in about half the time. Special thanks to :user:`webknjaz` for hard work implementing test isolation. To run without parallelization, disable the plugin with ``tox -- -p no:xdist``.
```
### 51.3.3
```
-------
Misc
^^^^
* 2539: Fix AttributeError in Description validation.
```
### 51.3.2
```
-------
Misc
^^^^
* 1390: Validation of Description field now is more lenient, emitting a warning and mangling the value to be valid (replacing newlines with spaces).
```
### 51.3.1
```
-------
Misc
^^^^
* 2536: Reverted tag deduplication handling.
```
### 51.3.0
```
-------
Changes
^^^^^^^
* 1390: Newlines in metadata description/Summary now trigger a ValueError.
* 2481: Define ``create_module()`` and ``exec_module()`` methods in ``VendorImporter``
to get rid of ``ImportWarning`` -- by :user:`hroncok`
* 2489: ``pkg_resources`` behavior for zipimport now matches the regular behavior, and finds
``.egg-info`` (previoulsy would only find ``.dist-info``) -- by :user:`thatch`
* 2529: Fixed an issue where version tags may be added multiple times
```
### 51.2.0
```
-------
Changes
^^^^^^^
* 2493: Use importlib.import_module() rather than the deprecated loader.load_module()
in pkg_resources namespace delaration -- by :user:`encukou`
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2525: Fix typo in the document page about entry point. -- by :user:`jtr109`
Misc
^^^^
* 2534: Avoid hitting network during test_easy_install.
```
### 51.1.2
```
-------
Misc
^^^^
* 2505: Disable inclusion of package data as it causes 'tests' to be included as data.
```
### 51.1.1
```
-------
Misc
^^^^
* 2534: Avoid hitting network during test_virtualenv.test_test_command.
```
### 51.1.0
```
-------
Changes
^^^^^^^
* 2486: Project adopts jaraco/skeleton for shared package maintenance.
Misc
^^^^
* 2477: Restore inclusion of rst files in sdist.
* 2484: Setuptools has replaced the master branch with the main branch.
* 2485: Fixed failing test when pip 20.3+ is present.
-- by :user:`yan12125`
* 2487: Fix tests with pytest 6.2
-- by :user:`yan12125`
```
### 51.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2435: Require Python 3.6 or later.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2430: Fixed inconsistent RST title nesting levels caused by 2399
-- by :user:`webknjaz`
* 2430: Fixed a typo in Sphinx docs that made docs dev section disappear
as a result of PR 2426 -- by :user:`webknjaz`
Misc
^^^^
* 2471: Removed the tests that guarantee that the vendored dependencies can be built by distutils.
```
### 50.3.2
```
-------
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2394: Extended towncrier news template to include change note categories.
This allows to see what types of changes a given version introduces
-- by :user:`webknjaz`
* 2427: Started enforcing strict syntax and reference validation
in the Sphinx docs -- by :user:`webknjaz`
* 2428: Removed redundant Sphinx ``Makefile`` support -- by :user:`webknjaz`
Misc
^^^^
* 2401: Enabled test results reporting in AppVeyor CI
-- by :user:`webknjaz`
* 2420: Replace Python 3.9.0 beta with 3.9.0 final on GitHub Actions.
* 2421: Python 3.9 Trove classifier got added to the dist metadata
-- by :user:`webknjaz`
```
### 50.3.1
```
-------
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2093: Finalized doc revamp.
* 2097: doc: simplify index and group deprecated files
* 2102: doc overhaul step 2: break main doc into multiple sections
* 2111: doc overhaul step 3: update userguide
* 2395: Added a ``:user:`` role to Sphinx config -- by :user:`webknjaz`
* 2395: Added an illustrative explanation about the change notes to fragments dir -- by :user:`webknjaz`
Misc
^^^^
* 2379: Travis CI test suite now tests against PPC64.
* 2413: Suppress EOF errors (and other exceptions) when importing lib2to3.
```
### 50.3.0
```
-------
Changes
^^^^^^^
* 2368: In distutils, restore support for monkeypatched CCompiler.spawn per pypa/distutils15.
```
### 50.2.0
```
-------
Changes
^^^^^^^
* 2355: When pip is imported as part of a build, leave distutils patched.
* 2380: There are some setuptools specific changes in the
``setuptools.command.bdist_rpm`` module that are no longer needed, because
they are part of the ``bdist_rpm`` module in distutils in Python
3.5.0. Therefore, code was removed from ``setuptools.command.bdist_rpm``.
```
### 50.1.0
```
-------
Changes
^^^^^^^
* 2350: Setuptools reverts using the included distutils by default. Platform maintainers and system integrators and others are *strongly* encouraged to set ``SETUPTOOLS_USE_DISTUTILS=local`` to help identify and work through the reported issues with distutils adoption, mainly to file issues and pull requests with pypa/distutils such that distutils performs as needed across every supported environment.
```
### 50.0.3
```
-------
Misc
^^^^
* 2363: Restore link_libpython support on Python 3.7 and earlier (see pypa/distutils9).
```
### 50.0.2
```
-------
Misc
^^^^
* 2352: In distutils hack, use absolute import rather than relative to avoid bpo-30876.
```
### 50.0.1
```
-------
Misc
^^^^
* 2357: Restored Python 3.5 support in distutils.util for missing ``subprocess._optim_args_from_interpreter_flags``.
* 2358: Restored AIX support on Python 3.8 and earlier.
* 2361: Add Python 3.10 support to _distutils_hack. Get the 'Loader' abstract class
from importlib.abc rather than importlib.util.abc (alias removed in Python
3.10).
```
### 50.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2232: Once again, Setuptools overrides the stdlib distutils on import. For environments or invocations where this behavior is undesirable, users are provided with a temporary escape hatch. If the environment variable ``SETUPTOOLS_USE_DISTUTILS`` is set to ``stdlib``, Setuptools will fall back to the legacy behavior. Use of this escape hatch is discouraged, but it is provided to ease the transition while proper fixes for edge cases can be addressed.
Changes
^^^^^^^
* 2334: In MSVC module, refine text in error message.
```
### 49.6.0
```
-------
Changes
^^^^^^^
* 2129: In pkg_resources, no longer detect any pathname ending in .egg as a Python egg. Now the path must be an unpacked egg or a zip file.
```
### 49.5.0
```
-------
Changes
^^^^^^^
* 2306: When running as a PEP 517 backend, setuptools does not try to install
``setup_requires`` itself. They are reported as build requirements for the
frontend to install.
```
### 49.4.0
```
-------
Changes
^^^^^^^
* 2310: Updated vendored packaging version to 20.4.
```
### 49.3.2
```
-------
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2300: Improve the ``safe_version`` function documentation
Misc
^^^^
* 2297: Once again, in stubs prefer exec_module to the deprecated load_module.
```
### 49.3.1
```
-------
Changes
^^^^^^^
* 2316: Removed warning when ``distutils`` is imported before ``setuptools`` when ``distutils`` replacement is not enabled.
```
### 49.3.0
```
-------
Changes
^^^^^^^
* 2259: Setuptools now provides a .pth file (except for editable installs of setuptools) to the target environment to ensure that when enabled, the setuptools-provided distutils is preferred before setuptools has been imported (and even if setuptools is never imported). Honors the SETUPTOOLS_USE_DISTUTILS environment variable.
```
### 49.2.1
```
-------
Misc
^^^^
* 2257: Fixed two flaws in distutils._msvccompiler.MSVCCompiler.spawn.
```
### 49.2.0
```
-------
Changes
^^^^^^^
* 2230: Now warn the user when setuptools is imported after distutils modules have been loaded (exempting PyPy for 3.6), directing the users of packages to import setuptools first.
```
### 49.1.3
```
-------
Misc
^^^^
* 2212: (Distutils) Allow spawn to accept environment. Avoid monkey-patching global state.
* 2249: Fix extension loading technique in stubs.
```
### 49.1.2
```
-------
Changes
^^^^^^^
* 2232: In preparation for re-enabling a local copy of distutils, Setuptools now honors an environment variable, SETUPTOOLS_USE_DISTUTILS. If set to 'stdlib' (current default), distutils will be used from the standard library. If set to 'local' (default in a imminent backward-incompatible release), the local copy of distutils will be used.
```
### 49.1.1
```
-------
Misc
^^^^
* 2094: Removed pkg_resources.py2_warn module, which is no longer reachable.
```
### 49.1.0
```
-------
Changes
^^^^^^^
* 2228: Disabled distutils adoption for now while emergent issues are addressed.
```
### 49.0.1
```
-------
Misc
^^^^
* 2228: Applied fix for pypa/distutils3, restoring expectation that spawn will raise a DistutilsExecError when attempting to execute a missing file.
```
### 49.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2165: Setuptools no longer installs a site.py file during easy_install or develop installs. As a result, .eggs on PYTHONPATH will no longer take precedence over other packages on sys.path. If this issue affects your production environment, please reach out to the maintainers at 2165.
Changes
^^^^^^^
* 2137: Removed (private) pkg_resources.RequirementParseError, now replaced by packaging.requirements.InvalidRequirement. Kept the name for compatibility, but users should catch InvalidRequirement instead.
* 2180: Update vendored packaging in pkg_resources to 19.2.
Misc
^^^^
* 2199: Fix exception causes all over the codebase by using ``raise new_exception from old_exception``
```
### 48.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2143: Setuptools adopts distutils from the Python 3.9 standard library and no longer depends on distutils in the standard library. When importing ``setuptools`` or ``setuptools.distutils_patch``, Setuptools will expose its bundled version as a top-level ``distutils`` package (and unload any previously-imported top-level distutils package), retaining the expectation that ``distutils``' objects are actually Setuptools objects.
To avoid getting any legacy behavior from the standard library, projects are advised to always "import setuptools" prior to importing anything from distutils. This behavior happens by default when using ``pip install`` or ``pep517.build``. Workflows that rely on ``setup.py (anything)`` will need to first ensure setuptools is imported. One way to achieve this behavior without modifying code is to invoke Python thus: ``python -c "import setuptools; exec(open('setup.py').read())" (anything)``.
```
### 47.3.2
```
-------
Misc
^^^^
* 2071: Replaced references to the deprecated imp package with references to importlib
```
### 47.3.1
```
-------
Misc
^^^^
* 1973: Removed ``pkg_resources.py31compat.makedirs`` in favor of the stdlib. Use ``os.makedirs()`` instead.
* 2198: Restore ``__requires__`` directive in easy-install wrapper scripts.
```
### 47.3.0
```
-------
Changes
^^^^^^^
* 2197: Console script wrapper for editable installs now has a unified template and honors importlib_metadata if present for faster script execution on older Pythons.
Misc
^^^^
* 2195: Fix broken entry points generated by easy-install (pip editable installs).
```
### 47.2.0
```
-------
Changes
^^^^^^^
* 2194: Editable-installed entry points now load significantly faster on Python versions 3.8+.
* 1471: Incidentally fixed by 2194 on Python 3.8 or when importlib_metadata is present.
```
### 47.1.1
```
-------
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 2156: Update mailing list pointer in developer docs
```
### 47.1.0
```
-------
Changes
^^^^^^^
* 2070: In wheel-to-egg conversion, use simple pkg_resources-style namespace declaration for packages that declare namespace_packages.
```
### 47.0.0
```
-------
Breaking Changes
^^^^^^^^^^^^^^^^
* 2094: Setuptools now actively crashes under Python 2. Python 3.5 or later is required. Users of Python 2 should use ``setuptools<45``.
Changes
^^^^^^^
* 1700: Document all supported keywords by migrating the ones from distutils.
```
### 46.4.0
```
-------
Changes
^^^^^^^
* 1753: ``attr:`` now extracts variables through rudimentary examination of the AST,
thereby supporting modules with third-party imports. If examining the AST
fails to find the variable, ``attr:`` falls back to the old behavior of
importing the module. Works on Python 3 only.
```
### 46.3.1
```
-------
No significant changes.
```
### 46.3.0
```
-------
Changes
^^^^^^^
* 2089: Package index functionality no longer attempts to remove an md5 fragment from the index URL. This functionality, added for distribute 163 is no longer relevant.
Misc
^^^^
* 2041: Preserve file modes during pkg files copying, but clear read only flag for target afterwards.
* 2105: Filter ``2to3`` deprecation warnings from ``TestDevelop.test_2to3_user_mode``.
```
### 46.2.0
```
-------
Changes
^^^^^^^
* 2040: Deprecated the ``bdist_wininst`` command. Binary packages should be built as wheels instead.
* 2062: Change 'Mac OS X' to 'macOS' in code.
* 2075: Stop recognizing files ending with ``.dist-info`` as distribution metadata.
* 2086: Deprecate 'use_2to3' functionality. Packagers are encouraged to use single-source solutions or build tool chains to manage conversions outside of setuptools.
Documentation changes
^^^^^^^^^^^^^^^^^^^^^
* 1698: Added documentation for ``build_meta`` (a bare minimum, not completed).
Misc
^^^^
* 2082: Filter ``lib2to3`` ``PendingDeprecationWarning`` and ``DeprecationWarning`` in tests,
because ``lib2to3`` is `deprecated in Python 3.9 <https://bugs.python.org/issue40360>`_.
```
Links
- PyPI: https://pypi.org/project/setuptools
- Changelog: https://pyup.io/changelogs/setuptools/
- Repo: https://github.com/pypa/setuptools
This PR updates setuptools from 46.1.3 to 60.3.1.
Changelog
### 60.3.1 ``` ------- Misc ^^^^ * 3002: Suppress AttributeError when detecting get-pip. ``` ### 60.3.0 ``` ------- Changes ^^^^^^^ * 2993: In _distutils_hack, bypass the distutils exception for pip when get-pip is being invoked, because it imports setuptools. Misc ^^^^ * 2989: Merge with pypa/distutils788cc159. Includes fix for config vars missing from sysconfig. ``` ### 60.2.0 ``` ------- Changes ^^^^^^^ * 2974: Setuptools now relies on the Python logging infrastructure to log messages. Instead of using ``distutils.log.*``, use ``logging.getLogger(name).*``. * 2987: Sync with pypa/distutils2def21c5d74fdd2fe7996ee4030ac145a9d751bd, including fix for missing get_versions attribute (2969), more reliance on sysconfig from stdlib. Misc ^^^^ * 2962: Avoid attempting to use local distutils when the presiding version of Setuptools on the path doesn't have one. * 2983: Restore 'add_shim' as the way to invoke the hook. Avoids compatibility issues between different versions of Setuptools with the distutils local implementation. ``` ### 60.1.1 ``` ------- Misc ^^^^ * 2980: Bypass distutils loader when setuptools module is no longer available on sys.path. ``` ### 60.1.0 ``` ------- Changes ^^^^^^^ * 2958: In distutils_hack, only add the metadata finder once. In ensure_local_distutils, rely on a context manager for reliable manipulation. * 2963: Merge with pypa/distutilsa5af364910. Includes revisited fix for pypa/distutils15 and improved MinGW/Cygwin support from pypa/distutils77. ``` ### 60.0.5 ``` ------- Misc ^^^^ * 2960: Install schemes fall back to default scheme for headers. ``` ### 60.0.4 ``` ------- Misc ^^^^ * 2954: Merge with pypa/distutilseba2bcd310. Adds platsubdir to config vars available for substitution. ``` ### 60.0.3 ``` ------- Misc ^^^^ * 2940: Avoid KeyError in distutils hack when pip is imported during ensurepip. ``` ### 60.0.2 ``` ------- Misc ^^^^ * 2938: Select 'posix_user' for the scheme unless falling back to stdlib, then use 'unix_user'. ``` ### 60.0.1 ``` ------- Misc ^^^^ * 2944: Add support for extended install schemes in easy_install. ``` ### 60.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2896: Setuptools once again makes its local copy of distutils the default. To override, set SETUPTOOLS_USE_DISTUTILS=stdlib. ``` ### 59.8.0 ``` ------- Changes ^^^^^^^ * 2935: Merge pypa/distutils460b59f0e68dba17e2465e8dd421bbc14b994d1f. ``` ### 59.7.0 ``` ------- Changes ^^^^^^^ * 2930: Require Python 3.7 ``` ### 59.6.0 ``` ------- Changes ^^^^^^^ * 2925: Merge with pypa/distutils92082ee42c including introduction of deprecation warning on Version classes. ``` ### 59.5.0 ``` ------- Changes ^^^^^^^ * 2914: Merge with pypa/distutils8f2df0bf6. ``` ### 59.4.0 ``` ------- Changes ^^^^^^^ * 2893: Restore deprecated support for newlines in the Summary field. ``` ### 59.3.0 ``` ------- Changes ^^^^^^^ * 2902: Merge with pypa/distutils85db7a41242. Misc ^^^^ * 2906: In ensure_local_distutils, re-use DistutilsMetaFinder to load the module. Avoids race conditions when _distutils_system_mod is employed. ``` ### 59.2.0 ``` ------- Changes ^^^^^^^ * 2875: Introduce changes from pypa/distutils514e9d0, including support for overrides from Debian and pkgsrc, unlocking the possibility of making SETUPTOOLS_USE_DISTUTILS=local the default again. ``` ### 59.1.1 ``` ------- Misc ^^^^ * 2885: Fixed errors when encountering LegacyVersions. ``` ### 59.1.0 ``` ------- Changes ^^^^^^^ * 2497: Update packaging to 21.2. * 2877: Back out deprecation of setup_requires and replace instead by a deprecation of setuptools.installer and fetch_build_egg. Now setup_requires is still supported when installed as part of a PEP 517 build, but is deprecated when an unsatisfied requirement is encountered. * 2879: Bump packaging to 21.2. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2867: PNG/ICO images replaced with SVG in the docs. * 2867: Added support to SVG "favicons" via "in-tree" Sphinx extension. ``` ### 59.0.1 ``` ------- Misc ^^^^ * 2880: Removed URL requirement for ``pytest-virtualenv`` in ``setup.cfg``. PyPI rejects packages with dependencies external to itself. Instead the test dependency was overwritten via ``tox.ini`` ``` ### 59.0.0 ``` ------- Deprecations ^^^^^^^^^^^^ * 2856: Support for custom commands that inherit directly from ``distutils`` is **deprecated**. Users should extend classes provided by setuptools instead. Breaking Changes ^^^^^^^^^^^^^^^^ * 2870: Started failing on invalid inline description with line breaks :class:`ValueError` -- by :user:`webknjaz` Changes ^^^^^^^ * 2698: Exposed exception classes from ``distutils.errors`` via ``setuptools.errors``. * 2866: Incorporate changes from pypa/distutilsf1b0a2b. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2227: Added sphinx theme customisations to display the new logo in the sidebar and use its colours as "accent" in the documentation -- by :user:`abravalheri` * 2227: Added new setuptools logo, including editable files and artwork documentation -- by :user:`abravalheri` * 2698: Added mentions to ``setuptools.errors`` as a way of handling custom command errors. * 2698: Added instructions to migrate from ``distutils.commands`` and ``distutils.errors`` in the porting guide. * 2871: Added a note to the docs that it is possible to install ``setup.py``-less projects in editable mode with :doc:`pip v21.1+ <pip:index>`, only having ``setup.cfg`` and ``pyproject.toml`` in project root -- by :user:`webknjaz` ``` ### 58.5.3 ``` ------- Misc ^^^^ * 2849: Add fallback for custom ``build_py`` commands inheriting directly from :mod:`distutils`, while still handling ``include_package_data=True`` for ``sdist``. ``` ### 58.5.2 ``` ------- Misc ^^^^ * 2847: Suppress 'setup.py install' warning under bdist_wheel. ``` ### 58.5.1 ``` ------- Misc ^^^^ * 2846: Move PkgResourcesDeprecationWarning above implicitly-called function so that it's in the namespace when version warnings are generated in an environment that contains them. ``` ### 58.5.0 ``` ------- Changes ^^^^^^^ * 1461: Fix inconsistency with ``include_package_data`` and ``packages_data`` in sdist by replacing the loop breaking mechanism between the ``sdist`` and ``egg_info`` commands -- by :user:`abravalheri` ``` ### 58.4.0 ``` ------- Changes ^^^^^^^ * 2497: Officially deprecated PEP 440 non-compliant versions. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2832: Removed the deprecated ``data_files`` option from the example in the declarative configuration docs -- by :user:`abravalheri` * 2832: Change type of ``data_files`` option from ``dict`` to ``section`` in declarative configuration docs (to match previous example) -- by :user:`abravalheri` ``` ### 58.3.0 ``` ------- Changes ^^^^^^^ * 917: ``setup.py install`` and ``easy_install`` commands are now officially deprecated. Use other standards-based installers (like pip) and builders (like build). Workloads reliant on this behavior should pin to this major version of Setuptools. See `Why you shouldn't invoke setup.py directly <https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html>`_ for more background. * 1988: Deprecated the ``bdist_rpm`` command. Binary packages should be built as wheels instead. -- by :user:`hugovk` * 2785: Replace ``configparser``'s ``readfp`` with ``read_file``, deprecated since Python 3.2. -- by :user:`hugovk` * 2823: Officially deprecated support for ``setup_requires``. Users are encouraged instead to migrate to PEP 518 ``build-system.requires`` in ``pyproject.toml``. Users reliant on ``setup_requires`` should consider pinning to this major version to avoid disruption. Misc ^^^^ * 2762: Changed codecov.yml to configure the threshold to be lower -- by :user:`tanvimoharir` ``` ### 58.2.0 ``` ------- Changes ^^^^^^^ * 2757: Add windows arm64 launchers for scripts generated by easy_install. * 2800: Added ``--owner`` and ``--group`` options to the ``sdist`` command, for specifying file ownership within the produced tarball (similarly to the corresponding distutils ``sdist`` options). Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2792: Document how the legacy and non-legacy versions are compared, and reference to the `PEP 440 <https://www.python.org/dev/peps/pep-0440/>`_ scheme. ``` ### 58.1.0 ``` ------- Changes ^^^^^^^ * 2796: Merge with pypa/distutils02e9f65ab0 ``` ### 58.0.4 ``` ------- Misc ^^^^ * 2773: Retain case in setup.cfg during sdist. ``` ### 58.0.3 ``` ------- Misc ^^^^ * 2777: Build does not fail fast when ``use_2to3`` is supplied but set to a false value. ``` ### 58.0.2 ``` ------- Misc ^^^^ * 2769: Build now fails fast when ``use_2to3`` is supplied. ``` ### 58.0.1 ``` ------- Misc ^^^^ * 2765: In Distribution.finalize_options, suppress known removed entry points to avoid issues with older Setuptools. ``` ### 58.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2086: Removed support for 2to3 during builds. Projects should port to a unified codebase or pin to an older version of Setuptools using PEP 518 build-requires. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2746: add python_requires example ``` ### 57.5.0 ``` ------- Changes ^^^^^^^ * 2712: Added implicit globbing support for `[options.data_files]` values. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2737: fix various syntax and style errors in code snippets in docs ``` ### 57.4.0 ``` ------- Changes ^^^^^^^ * 2722: Added support for ``SETUPTOOLS_EXT_SUFFIX`` environment variable to override the suffix normally detected from the ``sysconfig`` module. ``` ### 57.3.0 ``` ------- Changes ^^^^^^^ * 2465: Documentation is now published using the Furo theme. ``` ### 57.2.0 ``` ------- Changes ^^^^^^^ * 2724: Added detection of Windows ARM64 build environments using the ``VSCMD_ARG_TGT_ARCH`` environment variable. ``` ### 57.1.0 ``` ------- Changes ^^^^^^^ * 2692: Globs are now sorted in 'license_files' restoring reproducibility by eliminating variance from disk order. * 2714: Update to distutils at pypa/distutilse2627b7. * 2715: Removed reliance on deprecated ssl.match_hostname by removing the ssl support. Now any index operations rely on the native SSL implementation. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2604: Revamped the backward/cross tool compatibility section to remove some confusion. Add some examples and the version since when ``entry_points`` are supported in declarative configuration. Tried to make the reading flow a bit leaner, gather some information that were a bit dispersed. ``` ### 57.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2645: License files excluded via the ``MANIFEST.in`` but matched by either the ``license_file`` (deprecated) or ``license_files`` options, will be nevertheless included in the source distribution. - by :user:`cdce8p` Changes ^^^^^^^ * 2628: Write long description in message payload of PKG-INFO file. - by :user:`cdce8p` * 2645: Added ``License-File`` (multiple) to the output package metadata. The field will contain the path of a license file, matched by the ``license_file`` (deprecated) and ``license_files`` options, relative to ``.dist-info``. - by :user:`cdce8p` * 2678: Moved Setuptools' own entry points into declarative config. * 2680: Vendored `more_itertools <https://pypi.org/project/more-itertools>`_ for Setuptools. * 2681: Setuptools own setup.py no longer declares setup_requires, but instead expects wheel to be installed as declared by pyproject.toml. Misc ^^^^ * 2650: Updated the docs build tooling to support the latest version of Towncrier and show the previews of not-yet-released setuptools versions in the changelog -- :user:`webknjaz` ``` ### 56.2.0 ``` ------- Changes ^^^^^^^ * 2640: Fixed handling of multiline license strings. - by :user:`cdce8p` * 2641: Setuptools will now always try to use the latest supported metadata version for ``PKG-INFO``. - by :user:`cdce8p` ``` ### 56.1.0 ``` ------- Changes ^^^^^^^ * 2653: Incorporated assorted changes from pypa/distutils. * 2657: Adopted docs from distutils. * 2663: Added Visual Studio Express 2017 support -- by :user:`dofuuz` Misc ^^^^ * 2644: Fixed ``DeprecationWarning`` due to ``threading.Thread.setDaemon`` in tests -- by :user:`tirkarthi` * 2654: Made the changelog generator compatible with Towncrier >= 19.9 -- :user:`webknjaz` * 2664: Relax the deprecation message in the distutils hack. ``` ### 56.0.0 ``` ------- Deprecations ^^^^^^^^^^^^ * 2620: The ``license_file`` option is now marked as deprecated. Use ``license_files`` instead. -- by :user:`cdce8p` Breaking Changes ^^^^^^^^^^^^^^^^ * 2620: If neither ``license_file`` nor ``license_files`` is specified, the ``sdist`` option will now auto-include files that match the following patterns: ``LICEN[CS]E*``, ``COPYING*``, ``NOTICE*``, ``AUTHORS*``. This matches the behavior of ``bdist_wheel``. -- by :user:`cdce8p` Changes ^^^^^^^ * 2620: The ``license_file`` and ``license_files`` options now support glob patterns. -- by :user:`cdce8p` * 2632: Implemented ``VendorImporter.find_spec()`` method to get rid of ``ImportWarning`` that Python 3.10 emits when only the old-style importer hooks are present -- by :user:`webknjaz` Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2620: Added documentation for the ``license_files`` option. -- by :user:`cdce8p` ``` ### 55.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2566: Remove the deprecated ``bdist_wininst`` command. Binary packages should be built as wheels instead. -- by :user:`hroncok` ``` ### 54.2.0 ``` ------- Changes ^^^^^^^ * 2608: Added informative error message to PEP 517 build failures owing to an empty ``setup.py`` -- by :user:`layday` ``` ### 54.1.3 ``` ------- No significant changes. ``` ### 54.1.2 ``` ------- Misc ^^^^ * 2595: Reduced scope of dash deprecation warning to Setuptools/distutils only -- by :user:`melissa-kun-li` ``` ### 54.1.1 ``` ------- Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2584: Added ``sphinx-inline-tabs`` extension to allow for comparison of ``setup.py`` and its equivalent ``setup.cfg`` -- by :user:`amy-lei` Misc ^^^^ * 2592: Made option keys in the ``[metadata]`` section of ``setup.cfg`` case-sensitive. Users having uppercase option spellings will get a warning suggesting to make them to lowercase -- by :user:`melissa-kun-li` ``` ### 54.1.0 ``` ------- Changes ^^^^^^^ * 1608: Removed the conversion of dashes to underscores in the :code:`extras_require` and :code:`data_files` of :code:`setup.cfg` to support the usage of dashes. Method will warn users when they use a dash-separated key which in the future will only allow an underscore. Note: the method performs the dash to underscore conversion to preserve compatibility, but future versions will no longer support it -- by :user:`melissa-kun-li` ``` ### 54.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2582: Simplified build-from-source story by providing bootstrapping metadata in a separate egg-info directory. Build requirements no longer include setuptools itself. Sdist once again includes the pyproject.toml. Project can no longer be installed from source on pip 19.x, but install from source is still supported on pip < 19 and pip >= 20 and install from wheel is still supported with pip >= 9. Changes ^^^^^^^ * 1932: Handled :code:`AttributeError` by raising :code:`DistutilsSetupError` in :code:`dist.check_specifier()` when specifier is not a string -- by :user:`melissa-kun-li` * 2570: Correctly parse cmdclass in setup.cfg. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2553: Added userguide example for markers in extras_require -- by :user:`pwoolvett` ``` ### 53.1.0 ``` ------- Changes ^^^^^^^ * 1937: Preserved case-sensitivity of keys in setup.cfg so that entry point names are case-sensitive. Changed sensitivity of configparser. NOTE: Any projects relying on case-insensitivity will need to adapt to accept the original case as published. -- by :user:`melissa-kun-li` * 2573: Fixed error in uploading a Sphinx doc with the :code:`upload_docs` command. An html builder will be used. Note: :code:`upload_docs` is deprecated for PyPi, but is supported for other sites -- by :user:`melissa-kun-li` ``` ### 53.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 1527: Removed bootstrap script. Now Setuptools requires pip or another pep517-compliant builder such as 'build' to build. Now Setuptools can be installed from Github main branch. ``` ### 52.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2537: Remove fallback support for fetch_build_eggs using easy_install. Now pip is required for setup_requires to succeed. * 2544: Removed 'easy_install' top-level model (runpy entry point) and 'easy_install' console script. * 2545: Removed support for eggsecutables. Changes ^^^^^^^ * 2459: Tests now run in parallel via pytest-xdist, completing in about half the time. Special thanks to :user:`webknjaz` for hard work implementing test isolation. To run without parallelization, disable the plugin with ``tox -- -p no:xdist``. ``` ### 51.3.3 ``` ------- Misc ^^^^ * 2539: Fix AttributeError in Description validation. ``` ### 51.3.2 ``` ------- Misc ^^^^ * 1390: Validation of Description field now is more lenient, emitting a warning and mangling the value to be valid (replacing newlines with spaces). ``` ### 51.3.1 ``` ------- Misc ^^^^ * 2536: Reverted tag deduplication handling. ``` ### 51.3.0 ``` ------- Changes ^^^^^^^ * 1390: Newlines in metadata description/Summary now trigger a ValueError. * 2481: Define ``create_module()`` and ``exec_module()`` methods in ``VendorImporter`` to get rid of ``ImportWarning`` -- by :user:`hroncok` * 2489: ``pkg_resources`` behavior for zipimport now matches the regular behavior, and finds ``.egg-info`` (previoulsy would only find ``.dist-info``) -- by :user:`thatch` * 2529: Fixed an issue where version tags may be added multiple times ``` ### 51.2.0 ``` ------- Changes ^^^^^^^ * 2493: Use importlib.import_module() rather than the deprecated loader.load_module() in pkg_resources namespace delaration -- by :user:`encukou` Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2525: Fix typo in the document page about entry point. -- by :user:`jtr109` Misc ^^^^ * 2534: Avoid hitting network during test_easy_install. ``` ### 51.1.2 ``` ------- Misc ^^^^ * 2505: Disable inclusion of package data as it causes 'tests' to be included as data. ``` ### 51.1.1 ``` ------- Misc ^^^^ * 2534: Avoid hitting network during test_virtualenv.test_test_command. ``` ### 51.1.0 ``` ------- Changes ^^^^^^^ * 2486: Project adopts jaraco/skeleton for shared package maintenance. Misc ^^^^ * 2477: Restore inclusion of rst files in sdist. * 2484: Setuptools has replaced the master branch with the main branch. * 2485: Fixed failing test when pip 20.3+ is present. -- by :user:`yan12125` * 2487: Fix tests with pytest 6.2 -- by :user:`yan12125` ``` ### 51.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2435: Require Python 3.6 or later. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2430: Fixed inconsistent RST title nesting levels caused by 2399 -- by :user:`webknjaz` * 2430: Fixed a typo in Sphinx docs that made docs dev section disappear as a result of PR 2426 -- by :user:`webknjaz` Misc ^^^^ * 2471: Removed the tests that guarantee that the vendored dependencies can be built by distutils. ``` ### 50.3.2 ``` ------- Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2394: Extended towncrier news template to include change note categories. This allows to see what types of changes a given version introduces -- by :user:`webknjaz` * 2427: Started enforcing strict syntax and reference validation in the Sphinx docs -- by :user:`webknjaz` * 2428: Removed redundant Sphinx ``Makefile`` support -- by :user:`webknjaz` Misc ^^^^ * 2401: Enabled test results reporting in AppVeyor CI -- by :user:`webknjaz` * 2420: Replace Python 3.9.0 beta with 3.9.0 final on GitHub Actions. * 2421: Python 3.9 Trove classifier got added to the dist metadata -- by :user:`webknjaz` ``` ### 50.3.1 ``` ------- Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2093: Finalized doc revamp. * 2097: doc: simplify index and group deprecated files * 2102: doc overhaul step 2: break main doc into multiple sections * 2111: doc overhaul step 3: update userguide * 2395: Added a ``:user:`` role to Sphinx config -- by :user:`webknjaz` * 2395: Added an illustrative explanation about the change notes to fragments dir -- by :user:`webknjaz` Misc ^^^^ * 2379: Travis CI test suite now tests against PPC64. * 2413: Suppress EOF errors (and other exceptions) when importing lib2to3. ``` ### 50.3.0 ``` ------- Changes ^^^^^^^ * 2368: In distutils, restore support for monkeypatched CCompiler.spawn per pypa/distutils15. ``` ### 50.2.0 ``` ------- Changes ^^^^^^^ * 2355: When pip is imported as part of a build, leave distutils patched. * 2380: There are some setuptools specific changes in the ``setuptools.command.bdist_rpm`` module that are no longer needed, because they are part of the ``bdist_rpm`` module in distutils in Python 3.5.0. Therefore, code was removed from ``setuptools.command.bdist_rpm``. ``` ### 50.1.0 ``` ------- Changes ^^^^^^^ * 2350: Setuptools reverts using the included distutils by default. Platform maintainers and system integrators and others are *strongly* encouraged to set ``SETUPTOOLS_USE_DISTUTILS=local`` to help identify and work through the reported issues with distutils adoption, mainly to file issues and pull requests with pypa/distutils such that distutils performs as needed across every supported environment. ``` ### 50.0.3 ``` ------- Misc ^^^^ * 2363: Restore link_libpython support on Python 3.7 and earlier (see pypa/distutils9). ``` ### 50.0.2 ``` ------- Misc ^^^^ * 2352: In distutils hack, use absolute import rather than relative to avoid bpo-30876. ``` ### 50.0.1 ``` ------- Misc ^^^^ * 2357: Restored Python 3.5 support in distutils.util for missing ``subprocess._optim_args_from_interpreter_flags``. * 2358: Restored AIX support on Python 3.8 and earlier. * 2361: Add Python 3.10 support to _distutils_hack. Get the 'Loader' abstract class from importlib.abc rather than importlib.util.abc (alias removed in Python 3.10). ``` ### 50.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2232: Once again, Setuptools overrides the stdlib distutils on import. For environments or invocations where this behavior is undesirable, users are provided with a temporary escape hatch. If the environment variable ``SETUPTOOLS_USE_DISTUTILS`` is set to ``stdlib``, Setuptools will fall back to the legacy behavior. Use of this escape hatch is discouraged, but it is provided to ease the transition while proper fixes for edge cases can be addressed. Changes ^^^^^^^ * 2334: In MSVC module, refine text in error message. ``` ### 49.6.0 ``` ------- Changes ^^^^^^^ * 2129: In pkg_resources, no longer detect any pathname ending in .egg as a Python egg. Now the path must be an unpacked egg or a zip file. ``` ### 49.5.0 ``` ------- Changes ^^^^^^^ * 2306: When running as a PEP 517 backend, setuptools does not try to install ``setup_requires`` itself. They are reported as build requirements for the frontend to install. ``` ### 49.4.0 ``` ------- Changes ^^^^^^^ * 2310: Updated vendored packaging version to 20.4. ``` ### 49.3.2 ``` ------- Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2300: Improve the ``safe_version`` function documentation Misc ^^^^ * 2297: Once again, in stubs prefer exec_module to the deprecated load_module. ``` ### 49.3.1 ``` ------- Changes ^^^^^^^ * 2316: Removed warning when ``distutils`` is imported before ``setuptools`` when ``distutils`` replacement is not enabled. ``` ### 49.3.0 ``` ------- Changes ^^^^^^^ * 2259: Setuptools now provides a .pth file (except for editable installs of setuptools) to the target environment to ensure that when enabled, the setuptools-provided distutils is preferred before setuptools has been imported (and even if setuptools is never imported). Honors the SETUPTOOLS_USE_DISTUTILS environment variable. ``` ### 49.2.1 ``` ------- Misc ^^^^ * 2257: Fixed two flaws in distutils._msvccompiler.MSVCCompiler.spawn. ``` ### 49.2.0 ``` ------- Changes ^^^^^^^ * 2230: Now warn the user when setuptools is imported after distutils modules have been loaded (exempting PyPy for 3.6), directing the users of packages to import setuptools first. ``` ### 49.1.3 ``` ------- Misc ^^^^ * 2212: (Distutils) Allow spawn to accept environment. Avoid monkey-patching global state. * 2249: Fix extension loading technique in stubs. ``` ### 49.1.2 ``` ------- Changes ^^^^^^^ * 2232: In preparation for re-enabling a local copy of distutils, Setuptools now honors an environment variable, SETUPTOOLS_USE_DISTUTILS. If set to 'stdlib' (current default), distutils will be used from the standard library. If set to 'local' (default in a imminent backward-incompatible release), the local copy of distutils will be used. ``` ### 49.1.1 ``` ------- Misc ^^^^ * 2094: Removed pkg_resources.py2_warn module, which is no longer reachable. ``` ### 49.1.0 ``` ------- Changes ^^^^^^^ * 2228: Disabled distutils adoption for now while emergent issues are addressed. ``` ### 49.0.1 ``` ------- Misc ^^^^ * 2228: Applied fix for pypa/distutils3, restoring expectation that spawn will raise a DistutilsExecError when attempting to execute a missing file. ``` ### 49.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2165: Setuptools no longer installs a site.py file during easy_install or develop installs. As a result, .eggs on PYTHONPATH will no longer take precedence over other packages on sys.path. If this issue affects your production environment, please reach out to the maintainers at 2165. Changes ^^^^^^^ * 2137: Removed (private) pkg_resources.RequirementParseError, now replaced by packaging.requirements.InvalidRequirement. Kept the name for compatibility, but users should catch InvalidRequirement instead. * 2180: Update vendored packaging in pkg_resources to 19.2. Misc ^^^^ * 2199: Fix exception causes all over the codebase by using ``raise new_exception from old_exception`` ``` ### 48.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2143: Setuptools adopts distutils from the Python 3.9 standard library and no longer depends on distutils in the standard library. When importing ``setuptools`` or ``setuptools.distutils_patch``, Setuptools will expose its bundled version as a top-level ``distutils`` package (and unload any previously-imported top-level distutils package), retaining the expectation that ``distutils``' objects are actually Setuptools objects. To avoid getting any legacy behavior from the standard library, projects are advised to always "import setuptools" prior to importing anything from distutils. This behavior happens by default when using ``pip install`` or ``pep517.build``. Workflows that rely on ``setup.py (anything)`` will need to first ensure setuptools is imported. One way to achieve this behavior without modifying code is to invoke Python thus: ``python -c "import setuptools; exec(open('setup.py').read())" (anything)``. ``` ### 47.3.2 ``` ------- Misc ^^^^ * 2071: Replaced references to the deprecated imp package with references to importlib ``` ### 47.3.1 ``` ------- Misc ^^^^ * 1973: Removed ``pkg_resources.py31compat.makedirs`` in favor of the stdlib. Use ``os.makedirs()`` instead. * 2198: Restore ``__requires__`` directive in easy-install wrapper scripts. ``` ### 47.3.0 ``` ------- Changes ^^^^^^^ * 2197: Console script wrapper for editable installs now has a unified template and honors importlib_metadata if present for faster script execution on older Pythons. Misc ^^^^ * 2195: Fix broken entry points generated by easy-install (pip editable installs). ``` ### 47.2.0 ``` ------- Changes ^^^^^^^ * 2194: Editable-installed entry points now load significantly faster on Python versions 3.8+. * 1471: Incidentally fixed by 2194 on Python 3.8 or when importlib_metadata is present. ``` ### 47.1.1 ``` ------- Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 2156: Update mailing list pointer in developer docs ``` ### 47.1.0 ``` ------- Changes ^^^^^^^ * 2070: In wheel-to-egg conversion, use simple pkg_resources-style namespace declaration for packages that declare namespace_packages. ``` ### 47.0.0 ``` ------- Breaking Changes ^^^^^^^^^^^^^^^^ * 2094: Setuptools now actively crashes under Python 2. Python 3.5 or later is required. Users of Python 2 should use ``setuptools<45``. Changes ^^^^^^^ * 1700: Document all supported keywords by migrating the ones from distutils. ``` ### 46.4.0 ``` ------- Changes ^^^^^^^ * 1753: ``attr:`` now extracts variables through rudimentary examination of the AST, thereby supporting modules with third-party imports. If examining the AST fails to find the variable, ``attr:`` falls back to the old behavior of importing the module. Works on Python 3 only. ``` ### 46.3.1 ``` ------- No significant changes. ``` ### 46.3.0 ``` ------- Changes ^^^^^^^ * 2089: Package index functionality no longer attempts to remove an md5 fragment from the index URL. This functionality, added for distribute 163 is no longer relevant. Misc ^^^^ * 2041: Preserve file modes during pkg files copying, but clear read only flag for target afterwards. * 2105: Filter ``2to3`` deprecation warnings from ``TestDevelop.test_2to3_user_mode``. ``` ### 46.2.0 ``` ------- Changes ^^^^^^^ * 2040: Deprecated the ``bdist_wininst`` command. Binary packages should be built as wheels instead. * 2062: Change 'Mac OS X' to 'macOS' in code. * 2075: Stop recognizing files ending with ``.dist-info`` as distribution metadata. * 2086: Deprecate 'use_2to3' functionality. Packagers are encouraged to use single-source solutions or build tool chains to manage conversions outside of setuptools. Documentation changes ^^^^^^^^^^^^^^^^^^^^^ * 1698: Added documentation for ``build_meta`` (a bare minimum, not completed). Misc ^^^^ * 2082: Filter ``lib2to3`` ``PendingDeprecationWarning`` and ``DeprecationWarning`` in tests, because ``lib2to3`` is `deprecated in Python 3.9 <https://bugs.python.org/issue40360>`_. ```Links
- PyPI: https://pypi.org/project/setuptools - Changelog: https://pyup.io/changelogs/setuptools/ - Repo: https://github.com/pypa/setuptools