Changelog
### 74.1.2
```
=======
Bugfixes
--------
- Fixed TypeError in sdist filelist processing by adding support for pathlib Paths for the build_base. (4615)
- Removed degraded and deprecated ``test_integration`` (easy_install) from the test suite. (4632)
```
### 74.1.1
```
=======
Bugfixes
--------
- Fixed TypeError in ``msvc.EnvironmentInfo.return_env`` when no runtime redistributables are installed. (1902)
```
### 74.1.0
```
=======
Features
--------
- Added support for defining ``ext-modules`` via ``pyproject.toml``
(**EXPERIMENTAL**, may change in future releases). (4568)
Bugfixes
--------
- Merge with pypa/distutils3dcdf8567, removing the duplicate vendored copy of packaging. (4622)
- Restored ``setuptools.msvc.Environmentinfo`` as it is used externally. (4625)
```
### 74.0.0
```
=======
Features
--------
- Changed the type of error raised by ``setuptools.command.easy_install.CommandSpec.from_param`` on unsupported argument from `AttributeError` to `TypeError` -- by :user:`Avasam` (4548)
- Added detection of ARM64 variant of MSVC -- by :user:`saschanaz` (4553)
- Made ``setuptools.package_index.Credential`` a `typing.NamedTuple` -- by :user:`Avasam` (4585)
- Reraise error from ``setuptools.command.easy_install.auto_chmod`` instead of nonsensical ``TypeError: 'Exception' object is not subscriptable`` -- by :user:`Avasam` (4593)
- Fully typed all collection attributes in ``pkg_resources`` -- by :user:`Avasam` (4598)
- Automatically exclude ``.tox|.nox|.venv`` directories from ``sdist``. (4603)
Deprecations and Removals
-------------------------
- Removed the monkeypatching of distutils._msvccompiler. Now all compiler logic is consolidated in distutils. (4600)
- Synced with pypa/distutils58fe058e4, including consolidating Visual Studio 2017 support (4600, pypa/distutils289), removal of deprecated legacy MSVC compiler modules (pypa/distutils287), suppressing of errors when the home directory is missing (pypa/distutils278), removal of wininst binaries (pypa/distutils282). (4606)
Misc
----
- 4592
```
### 73.0.1
```
=======
Bugfixes
--------
- Remove `abc.ABCMeta` metaclass from abstract classes. `pypa/setuptools4503 <https://github.com/pypa/setuptools/pull/4503>`_ had an unintended consequence of causing potential ``TypeError: metaclass conflict: the metaclass of a derived class must be a (non-strict) subclass of the metaclasses of all its bases`` -- by :user:`Avasam` (#4579)
```
### 73.0.0
```
=======
Features
--------
- Mark abstract base classes and methods with `abc.ABC` and `abc.abstractmethod` -- by :user:`Avasam` (4503)
- Changed the order of type checks in ``setuptools.command.easy_install.CommandSpec.from_param`` to support any `collections.abc.Iterable` of `str` param -- by :user:`Avasam` (4505)
Bugfixes
--------
- Prevent an error in ``bdist_wheel`` if ``compression`` is set to a `str` (even if valid) after finalizing options but before running the command. -- by :user:`Avasam` (4383)
- Raises an exception when ``py_limited_api`` is used in a build with
``Py_GIL_DISABLED``. This is currently not supported (python/cpython111506). (4420)
- Synced with pypa/distutils30b7331 including fix for modified check on empty sources (pypa/distutils284).
Deprecations and Removals
-------------------------
- ``setuptools`` is replacing the usages of :pypi:`ordered_set` with simple
instances of ``dict[Hashable, None]``. This is done to remove the extra
dependency and it is possible because since Python 3.7, ``dict`` maintain
insertion order. (4574)
Misc
----
- 4534, 4546, 4554, 4559, 4565
```
### 72.2.0
```
=======
Features
--------
- Merged with pypa/distutilsb7ee725f3 including: Support for Pathlike objects in data files and extensions (pypa/distutils272, pypa/distutils237), native support for C++ compilers (pypa/distuils228) and removed unused get_msvcr() (pypa/distutils274). (4538)
```
### 72.1.0
```
=======
Features
--------
- Restore the tests command and deprecate access to the module. (4519) (4520)
```
### 72.0.0
```
=======
Deprecations and Removals
-------------------------
- The test command has been removed. Users relying on 'setup.py test' will need to migrate to another test runner or pin setuptools before this version. (931)
```
### 71.1.0
```
=======
Features
--------
- Added return types to typed public functions -- by :user:`Avasam`
Marked `pkg_resources` as ``py.typed`` -- by :user:`Avasam` (4409)
Misc
----
- 4492
```
### 71.0.4
```
=======
Bugfixes
--------
- Removed lingering unused code around Distribution._patched_dist. (4489)
```
### 71.0.3
```
=======
Bugfixes
--------
- Reset the backports module when enabling vendored packages. (4476)
```
### 71.0.2
```
=======
Bugfixes
--------
- Include all vendored files in the sdist. (4480)
```
### 71.0.1
```
=======
Bugfixes
--------
- Restored package data that went missing in 71.0. This change also incidentally causes tests to be installed once again. (4475)
```
### 71.0.0
```
=======
Deprecations and Removals
-------------------------
- Now setuptools declares its own dependencies in the ``core`` extra. Dependencies are still vendored for bootstrapping purposes, but setuptools will prefer installed dependencies if present. The ``core`` extra is used for informational purposes and should *not* be declared in package metadata (e.g. ``build-requires``). Downstream packagers can de-vendor by simply removing the ``setuptools/_vendor`` directory. Since Setuptools now prefers installed dependencies, those installing to an environment with old, incompatible dependencies will not work. In that case, either uninstall the incompatible dependencies or upgrade them to satisfy those declared in ``core``. (2825)
```
### 70.3.0
```
=======
Features
--------
- Support for loading distutils from the standard library is now deprecated, including use of SETUPTOOLS_USE_DISTUTILS=stdlib and importing distutils before importing setuptools. (4137)
Bugfixes
--------
- Bugfix for building Cython extension on Windows (pypa/distutils268).
```
### 70.2.0
```
=======
Features
--------
- Updated distutils including significant changes to support Cygwin and mingw compilers. (4444)
Bugfixes
--------
- Fix distribution name normalisation (:pep:`625`) for valid versions that are
not canonical (e.g. ``1.0-2``). (4434)
```
### 70.1.1
```
=======
Misc
----
- 4429
```
### 70.1.0
```
=======
Features
--------
- Adopted the ``bdist_wheel`` command from the ``wheel`` project -- by :user:`agronholm` (1386)
- Improve error message when ``pkg_resources.ZipProvider`` tries to extract resources with a missing Egg -- by :user:`Avasam`
Added variables and parameter type annotations to ``pkg_resources`` to be nearly on par with typeshed.\* -- by :user:`Avasam`
\* Excluding ``TypeVar`` and ``overload``. Return types are currently inferred. (4246)
- Migrated Setuptools' own config to pyproject.toml (4310)
Bugfixes
--------
- Prevent a ``TypeError: 'NoneType' object is not callable`` when ``shutil_rmtree`` is called without an ``onexc`` parameter on Python<=3.11 -- by :user:`Avasam` (4382)
- Replace use of mktemp with can_symlink from the stdlib test suite. (4403)
- Improvement for ``attr:`` directives in configuration to handle
more edge cases related to complex ``package_dir``. (4405)
- Fix accidental implicit string concatenation. (4411)
Misc
----
- 4365, 4422
```
### 70.0.0
```
=======
Features
--------
- Emit a warning when ``[tools.setuptools]`` is present in ``pyproject.toml`` and will be ignored. -- by :user:`SnoopJ` (4150)
- Improved `AttributeError` error message if ``pkg_resources.EntryPoint.require`` is called without extras or distribution
Gracefully "do nothing" when trying to activate a ``pkg_resources.Distribution`` with a `None` location, rather than raising a `TypeError`
-- by :user:`Avasam` (4262)
- Typed the dynamically defined variables from `pkg_resources` -- by :user:`Avasam` (4267)
- Modernized and refactored VCS handling in package_index. (4332)
Bugfixes
--------
- In install command, use super to call the superclass methods. Avoids race conditions when monkeypatching from _distutils_system_mod occurs late. (4136)
- Fix finder template for lenient editable installs of implicit nested namespaces
constructed by using ``package_dir`` to reorganise directory structure. (4278)
- Fix an error with `UnicodeDecodeError` handling in ``pkg_resources`` when trying to read files in UTF-8 with a fallback -- by :user:`Avasam` (4348)
Improved Documentation
----------------------
- Uses RST substitution to put badges in 1 line. (4312)
Deprecations and Removals
-------------------------
- Further adoption of UTF-8 in ``setuptools``.
This change regards mostly files produced and consumed during the build process
(e.g. metadata files, script wrappers, automatically updated config files, etc..)
Although precautions were taken to minimize disruptions, some edge cases might
be subject to backwards incompatibility.
Support for ``"locale"`` encoding is now **deprecated**. (4309)
- Remove ``setuptools.convert_path`` after long deprecation period.
This function was never defined by ``setuptools`` itself, but rather a
side-effect of an import for internal usage. (4322)
- Remove fallback for customisations of ``distutils``' ``build.sub_command`` after long
deprecated period.
Users are advised to import ``build`` directly from ``setuptools.command.build``. (4322)
- Removed ``typing_extensions`` from vendored dependencies -- by :user:`Avasam` (4324)
- Remove deprecated ``setuptools.dep_util``.
The provided alternative is ``setuptools.modified``. (4360)
Misc
----
- 4255, 4280, 4282, 4308, 4348
```
### 69.5.1
```
=======
No significant changes.
```
### 69.5.0
```
=======
Features
--------
- Refresh unpinned vendored dependencies. (4253)
- Updated vendored packaging to version 24.0. (4301)
```
### 69.4.2
```
=======
Bugfixes
--------
- Merged bugfix for pypa/distutils246.
```
### 69.4.1
```
=======
No significant changes.
```
### 69.4.0
```
=======
Features
--------
- Merged with pypa/distutils55982565e, including interoperability improvements for rfc822_escape (pypa/distutils213), dynamic resolution of config_h_filename for Python 3.13 compatibility (pypa/distutils219), added support for the z/OS compiler (pypa/distutils216), modernized compiler options in unixcompiler (pypa/distutils214), fixed accumulating flags bug after compile/link (pypa/distutils207), fixed enconding warnings (pypa/distutils236), and general quality improvements (pypa/distutils234). (4298)
```
### 69.3.1
```
=======
Bugfixes
--------
- Remove attempt to canonicalize the version. It's already canonical enough. (4302)
```
### 69.3.0
```
=======
Features
--------
- Support PEP 625 by canonicalizing package name and version in filenames
per
`the spec <https://packaging.python.org/en/latest/specifications/source-distribution-format/#source-distribution-file-name>`_.
Projects whose names contain uppercase characters, dashes, or periods will
now see their sdist names normalized to match the standard and the format
previously seen in wheels. For example:
- ``zope.interface`` -> ``zope_interface``
- ``CherryPy`` -> ``cherrypy``
- ``foo-bar_baz`` -> ``foo_bar_baz``
Projects are encouraged to adopt this change to align with standards and
other backend build systems. (3593)
```
### 69.2.0
```
=======
Features
--------
- Explicitly use ``encoding="locale"`` for ``.pth`` files whenever possible,
to reduce ``EncodingWarnings``.
This avoid errors with UTF-8 (see discussion in python/cpython77102). (4265)
Bugfixes
--------
- Clarify some `pkg_resources` methods return `bytes`, not `str`. Also return an empty `bytes` in ``EmptyProvider._get`` -- by :user:`Avasam` (4243)
- Return an empty `list` by default in ``pkg_resources.ResourceManager.cleanup_resources`` -- by :user:`Avasam` (4244)
- Made ``pkg_resoursces.NullProvider``'s ``has_metadata`` and ``metadata_isdir`` methods return actual booleans like all other Providers. -- by :user:`Avasam` (4254)
Misc
----
- 4237, 4238, 4241, 4260, 4261, 4263
```
### 69.1.1
```
=======
Bugfixes
--------
- Fix argument order of ``--config-settings["--build-option"]`` arguments.
This was broken by <https://github.com/pypa/setuptools/pull/4079>`. (#4217)
Misc
----
- 4231
```
### 69.1.0
```
=======
Features
--------
- Updated and removed obsolete Python < 3.8 code and comments. -- by :user:`Avasam` (4096)
- Updated `pkg_resources` to use stdlib `importlib.machinery` instead of ``importlib_machinery`` -- by :user:`Avasam` (4097)
Bugfixes
--------
- In tests, rely on pytest-home for reusable fixture. (4072)
- Explicitely marked as ``Protocol`` and fixed missing ``self`` argument in interfaces ``pkg_resources.IMetadataProvider`` and ``pkg_resources.IResourceProvider`` -- by :user:`Avasam` (4144)
- Restored expectation that egg-link files would be named with dash separators for compatibility with pip prior to version 24. (4167)
Improved Documentation
----------------------
- Updated documentation referencing obsolete Python 3.7 code. -- by :user:`Avasam` (4096)
- Changed ``versionadded`` for "Type information included by default" feature from ``v68.3.0`` to ``v69.0.0`` -- by :user:`Avasam` (4182)
- Described the auto-generated files -- by :user:`VladimirFokow` (4198)
- Updated "Quickstart" to describe the current status of ``setup.cfg`` and ``pyproject.toml`` -- by :user:`VladimirFokow` (4200)
```
### 69.0.3
```
=======
Bugfixes
--------
- Retain valid names with underscores in egg_info.
```
### 69.0.2
```
=======
Bugfixes
--------
- Added missing estimated date for removing ``setuptools.dep_util`` (deprecated in v69.0.0). (4131)
```
### 69.0.1
```
=======
Bugfixes
--------
- Fixed imports of ``setuptools.dep_util.newer_group``.
A deprecation warning is issued instead of a hard failure. (4126)
```
### 69.0.0
```
=======
Features
--------
- Include type information (``py.typed``, ``*.pyi``) by default (3136) -- by :user:`Danie-1`,
**EXPERIMENTAL**. (3136)
- Exported ``distutils.dep_util`` and ``setuptools.dep_util`` through ``setuptools.modified`` -- by :user:`Avasam` (4069)
- Merged with pypa/distutils7a04cbda0fc714.
Bugfixes
--------
- Replaced hardcoded numeric values with :obj:`dis.opmap`,
fixing problem with 3.13.0a1. (4094)
Deprecations and Removals
-------------------------
- Configuring project ``version`` and ``egg_info.tag_*`` in such a way that
results in invalid version strings (according to :pep:`440`) is no longer permitted. (4066)
- Removed deprecated ``egg_base`` option from ``dist_info``.
Note that the ``dist_info`` command is considered internal to the way
``setuptools`` build backend works and not intended for
public usage. (4066)
- The parsing of the deprecated ``metadata.license_file`` and
``metadata.requires`` fields in ``setup.cfg`` is no longer supported.
Users are expected to move to ``metadata.license_files`` and
``options.install_requires`` (respectively). (4066)
- Passing ``config_settings`` to ``setuptools.build_meta`` with
deprecated values for ``--global-option`` is no longer allowed. (4066)
- Removed deprecated ``namespace-packages`` from ``pyproject.toml``.
Users are asked to use
:doc:`implicit namespace packages <PyPUG:guides/packaging-namespace-packages>`
(as defined in :pep:`420`). (4066)
- Added strict enforcement for ``project.dynamic`` in ``pyproject.toml``.
This removes the transitional ability of users configuring certain parameters
via ``setup.py`` without making the necessary changes to ``pyproject.toml``
(as mandated by :pep:`621`). (4066)
- Removed handling of ``--config-settings["--build-option"]`` in ``setuptools.build_meta``
from build-backend API hooks *other than* ``build_wheel``.
This was motivate by `errors caused when passing this option
<https://github.com/pypa/setuptools/issues/2491#issuecomment-1742859314>`_. (4079)
```
### 68.2.2
```
=======
Bugfixes
--------
- Improve backwards compatibility with deprecated CLI practices. (4048)
```
### 68.2.1
```
=======
Bugfixes
--------
- Avoid using caching attributes in ``Distribution.metadata`` for requirements.
This is done for backwards compatibility with customizations that attempt to
modify ``install_requires`` or ``extras_require`` at a late point (still not
recommended). (4043)
Misc
----
- 4045
```
### 68.2.0
```
=======
Features
--------
- Rework how ``setuptools`` internally handles ``dependencies/install_requires``
and ``optional-dependencies/extras_require``. (3903)
- Improve the generated ``PKG-INFO`` files, by adding ``Requires-Dist`` fields.
Previously, these fields would be omitted in favour of a non-standard
``*.egg-info/requires.txt`` file (which is still generated for the time being). (3904)
- Improve atomicity when writing ``PKG-INFO`` files to avoid race
conditions with ``importlib.metadata``. (3904)
Bugfixes
--------
- Fix the name given to the ``*-nspkg.pth`` files in editable installs,
ensuring they are unique per distribution. (4041)
- Workaround some limitations on ``pkg_resources``-style legacy namespaces in
the meta path finder for editable installations. (4041)
Misc
----
- 4023, 4027, 4027
```
### 68.1.2
```
=======
Misc
----
- 4022, 4022
```
### 68.1.1
```
=======
Bugfixes
--------
- Fix editable install finder handling of nested packages, by only handling 1
level of nesting and relying on ``importlib.machinery`` to find the remaining
modules based on the parent package path. (4020)
```
### 68.1.0
```
=======
Features
--------
- Removed code referencing bdist_wininst in install_scripts. (3525)
- Promote ``pyproject.toml``'s ``[tool.setuptools]`` out of beta.
Note that some fields are still considered deprecated and/or obsolete,
and these might be removed in future versions (i.e., there is no guarantee
for long term support and backward compatibility on those fields). (3962)
- Automatically add files listed in ``Extension.depends`` to sdists,
as long as they are contained in the project directory -- by :user:`RuRo` (4000)
- Require Python 3.8 or later.
Bugfixes
--------
- Made imports in editable installs case-sensitive on case-insensitive filesystems -- by :user:`aganders3` (3995)
- Use default encoding to create ``.pth`` files with ``editable_wheel``. (4009)
- Detects (and complain about) ``scripts`` and ``gui-scripts`` set via ``setup.py``
when ``pyproject.toml`` does not include them in ``dynamic``. (4012)
Misc
----
- 3833, 3960, 4001, 4007
```
### 68.0.0
```
=======
Breaking Changes
----------------
* 3948: Removed verification for existing ``depends.txt`` file (deprecated since v0.5a4).
* 3948: Remove autofixing of broken ``.egg-info`` directories containing the ``-``
character in their base name (without suffix).
They should no longer be produced by sufficiently new versions of ``setuptools``
(warning introduced in 2005).
* 3948: Remove deprecated APIs in ``easy_install``: ``get_script_args``,
``get_script_header`` and ``get_writer``.
The direct usage of ``easy_install`` has been deprecated since v58.3.0,
and the warnings regarding these APIs predate that version.
* 3948: Removed ``egg_info.get_pkg_info_revision`` (deprecated since 2015).
* 3948: Removed ``setuptools.dist._get_unpatched`` (deprecated since 2016)
* 3948: Removed support for SVN in ``setuptools.package_index`` (deprecated since 2018).
* 3948: Removed support for invalid ``pyproject.toml`` files.
During the implementation of PEP 621, it was identified that some users were
producing invalid files. As a transitional measure, the validation was relaxed
for a few use cases. The grace period, however, came to an end.
Changes
-------
* 3760: Added symlink support to launcher for installed executables -- by :user:`eugene-sevostianov-sc`
* 3926: Updated vendored ``packaging`` version from 23.0 to 23.1 -- by :user:`MetRonnie`
* 3950: Implemented workaround for old versions of ``vswhere``, which miss the
``-requiresAny`` parameter, such as the ones distributed together with Visual Studio 2017 < 15.6.
* 3952: Changed ``DistutilsMetaFinder`` to skip ``spec_for_pip`` on Python >= 3.12.
* 3952: Removed ``_distutils_hack.remove_shim`` on Python >= 3.12
(since ``distutils`` was removed from the standard library,
``DistutilsMetaFinder`` cannot be disabled on Python >= 3.12).
Misc
----
* 3920: Add a link to deprecation warning in ``pkg_resources`` and improve
``stacklevel`` for better visibility.
```
### 67.8.0
```
=======
Changes
-------
* 3128: In deprecated easy_install, reload and merge the pth file before saving.
Misc
----
* 3915: Adequate tests to the latest changes in ``virtualenv`` for Python 3.12.
```
### 67.7.2
```
=======
Misc
----
* 3902: Fixed wrong URLs used in warnings and logs.
```
### 67.7.1
```
=======
Misc
----
* 3898: Fixes setuptools.dist:invalid_unless_false when value is false don't raise error -- by :user:`jammarher`
```
### 67.7.0
```
=======
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`
```
### 67.6.1
```
=======
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.
```
### 67.6.0
```
=======
Changes
-------
* 3804: Added caching for supported wheel tags.
* 3846: Added pruning heuristics to ``PackageFinder`` based on ``exclude``.
```
### 67.5.1
```
=======
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.
```
### 67.5.0
```
=======
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.
```
### 67.4.0
```
=======
Changes
-------
* 3832: Update vendored ``importlib-metadata`` (to 6.0.0) and
``importlib-resources`` (to 5.10.2)
```
### 67.3.3
```
=======
Misc
----
* 3820: Restore quoted ``include`` argument to ``has_function``.
```
### 67.3.2
```
=======
Misc
----
* 3827: Improve deprecation warning message on ``pkg_resources.declare_namespace``
to display package name.
```
### 67.3.1
```
=======
Misc
----
* 3823: Fixes ``egg_info`` code path triggered during integration with ``pip``.
```
### 67.3.0
```
=======
Deprecations
------------
* 3434: Added deprecation warning for ``pkg_resources.declare_namespace``.
Users that wish to implement namespace packages, are recommended to follow the
practice described in PEP 420 and omit the ``__init__.py`` file entirely.
Changes
-------
* 3792: Reduced usage of ``pkg_resources`` in ``setuptools`` via internal
restructuring and refactoring.
Misc
----
* 3822: Added debugging tips for "editable mode" and update related docs.
Instead of using a custom exception to display the help message to the user,
``setuptools`` will now use a warning and re-raise the original exception.
* 3822: Added clarification about ``editable_wheel`` and ``dist_info`` CLI commands:
they should not be called directly with ``python setup.py ...``.
Instead they are reserved for internal use of ``setuptools`` (effectively as "private" commands).
Users are recommended to rely on build backend APIs (:pep:`517` and :pep:`660`)
exposed by ``setuptools.build_meta``.
```
### 67.2.0
```
=======
Changes
-------
* 3809: Merge with distutils8c3c3d29, including fix for ``sysconfig.get_python_inc()`` (pypa/distutils178), fix for segfault on MinGW (pypa/distutils196), and better ``has_function`` support (pypa/distutils195, 3648).
```
### 67.1.0
```
=======
Changes
-------
* 3795: Ensured that ``__file__`` is an absolute path when executing ``setup.py`` as
part of ``setuptools.build_meta``.
Misc
----
* 3798: Updated validations for ``pyproject.toml`` using ``validate-pyproject==0.12.1``
to allow stub packages (:pep:`561`) to be listed in ``tool.setuptools.packages``
and ``tool.setuptools.package-dir``.
```
### 67.0.0
```
=======
Breaking Changes
----------------
* 3741: Removed patching of ``distutils._msvccompiler.gen_lib_options``
for compatibility with Numpy < 1.11.2 -- by :user:`mgorny`
* 3790: Bump vendored version of :pypi:`packaging` to 23.0
(:pypi:`pyparsing` is no longer required and was removed).
As a consequence, users will experience a more strict parsing of requirements.
Specifications that don't comply with :pep:`440` and :pep:`508` will result
in build errors.
```
### 66.1.1
```
=======
Misc
----
* 3782: Fixed problem with ``file`` directive in ``tool.setuptools.dynamic``
(``pyproject.toml``) when value is a simple string instead of list.
```
### 66.1.0
```
=======
Changes
-------
* 3685: Fix improper usage of deprecated/removed ``pkgutil`` APIs in Python 3.12+.
* 3779: Files referenced by ``file:`` in ``setup.cfg`` and by ``project.readme.file``,
``project.license.file`` or ``tool.setuptools.dynamic.*.file`` in
``pyproject.toml`` are now automatically included in the generated sdists.
Misc
----
* 3776: Added note about using the ``--pep-517`` flag with ``pip`` to workaround
``InvalidVersion`` errors for packages that are already installed in the system.
```
### 66.0.0
```
=======
Breaking Changes
----------------
* 2497: Support for PEP 440 non-conforming versions has been removed. Environments containing packages with non-conforming versions may fail or the packages may not be recognized.
Changes
-------
* 3769: Replace 'appdirs' with 'platformdirs'.
```
### 65.7.0
```
=======
Changes
-------
* 3594: Added ``htmlcov`` to FlatLayoutModuleFinder.DEFAULT_EXCLUDE -- by :user:`demianbrecht`
* 3667: Added a human-readable error description when ``.egg-info`` directory is not writeable -- by :user:`droodev`
Misc
----
* 3713: Fixed incomplete ``getattr`` statement that caused problems when accessing
undefined attribute.
```
### 65.6.3
```
=======
Misc
----
* 3709: Fix condition to patch ``distutils.dist.log`` to only apply when using
``distutils`` from the stdlib.
```
### 65.6.2
```
=======
No significant changes.
```
### 65.6.1
```
=======
Documentation changes
---------------------
* 3689: Documented that ``distutils.cfg`` might be ignored unless
``SETUPTOOLS_USE_DISTUTILS=stdlib``.
Misc
----
* 3678: Improve clib builds reproducibility by sorting sources -- by :user:`danigm`
* 3684: Improved exception/traceback when invalid entry-points are specified.
* 3690: Fixed logging errors: 'underlying buffer has been detached' (issue 1631).
* 3693: Merge pypa/distutils3e9d47e with compatibility fix for distutils.log.Log.
* 3695, 3697, 3698, 3699: Changed minor text details (spelling, spaces ...)
* 3696: Removed unnecessary ``coding: utf-8`` annotations
* 3704: Fixed temporary build directories interference with auto-discovery.
```
### 65.6.0
```
=======
Changes
-------
* 3674: Sync with pypa/distutilse0787fa, including pypa/distutils183 updating distutils to use the Python logging framework.
```
### 65.5.1
```
=======
Misc
----
* 3638: Drop a test dependency on the ``mock`` package, always use :external+python:py:mod:`unittest.mock` -- by :user:`hroncok`
* 3659: Fixed REDoS vector in package_index -- by :user:`SCH227`
```
### 65.5.0
```
=======
Changes
-------
* 3624: Fixed editable install for multi-module/no-package ``src``-layout projects.
* 3626: Minor refactorings to support distutils using stdlib logging module.
Documentation changes
---------------------
* 3419: Updated the example version numbers to be compliant with PEP-440 on the "Specifying Your Project’s Version" page of the user guide.
Misc
----
* 3569: Improved information about conflicting entries in the current working directory
and editable install (in documentation and as an informational warning).
* 3576: Updated version of ``validate_pyproject``.
```
### 65.4.1
```
=======
Misc
----
* 3613: Fixed encoding errors in ``expand.StaticModule`` when system default encoding doesn't match expectations for source files.
* 3617: Merge with pypa/distutils6852b20 including fix for pypa/distutils181.
```
### 65.4.0
```
=======
Changes
-------
* 3609: Merge with pypa/distutilsd82d926 including support for DIST_EXTRA_CONFIG in pypa/distutils177.
```
### 65.3.0
```
=======
Changes
-------
* 3547: Stop ``ConfigDiscovery.analyse_name`` from splatting the ``Distribution.name`` attribute -- by :user:`jeamland`
Documentation changes
---------------------
* 3554: Changed requires to requests in the pyproject.toml example in the :doc:`Dependency management section of the Quickstart guide <userguide/quickstart>` -- by :user:`mfbutner`
Misc
----
* 3561: Fixed accidental name matching in editable hooks.
```
### 65.2.0
```
=======
Changes
-------
* 3553: Sync with pypa/distutils22b9bcf, including fixed cross-compiling support and removing deprecation warning per pypa/distutils169.
```
### 65.1.1
```
=======
Misc
----
* 3551: Avoided circular imports in meta path finder for editable installs when a
missing module has the same name as its parent.
```
### 65.1.0
```
=======
Changes
-------
* 3536: Remove monkeypatching of msvc9compiler.
Documentation changes
---------------------
* 3538: Corrected documentation on how to use the ``legacy-editable`` mode.
```
### 65.0.2
```
=======
Misc
----
* 3505: Restored distutils msvccompiler and msvc9compiler modules and marked as deprecated (pypa/distutilsc802880).
```
### 65.0.1
```
=======
Documentation changes
---------------------
* 3529: Added clarification to :doc:`/userguide/quickstart` about support
to ``setup.py``.
Misc
----
* 3526: Fixed backward compatibility of editable installs and custom ``build_ext``
commands inheriting directly from ``distutils``.
* 3528: Fixed ``buid_meta.prepare_metadata_for_build_wheel`` when
given ``metadata_directory`` is ``"."``.
```
### 65.0.0
```
=======
Breaking Changes
----------------
* 3505: Removed 'msvccompiler' and 'msvc9compiler' modules from distutils.
* 3521: Remove bdist_msi and bdist_wininst commands, which have been deprecated since Python 3.9. Use older Setuptools for these behaviors if needed.
Documentation changes
---------------------
* 3519: Changed the note in ``keywords`` documentation regarding editable installations
to specify which ``setuptools`` version require a minimal ``setup.py`` file or not.
```
### 64.0.3
```
=======
Misc
----
* 3515: Fixed "inline" file copying for editable installations and
optional extensions.
* 3517: Fixed ``editable_wheel`` to ensure other commands are finalized before using
them. This should prevent errors with plugins trying to use different commands
or reinitializing them.
* 3517: Augmented filter to prevent transient/temporary source files from being
considered ``package_data`` or ``data_files``.
```
### 64.0.2
```
=======
Misc
----
* 3506: Suppress errors in custom ``build_py`` implementations when running editable
installs in favor of a warning indicating what is the most appropriate
migration path.
This is a *transitional* measure. Errors might be raised in future versions of
``setuptools``.
* 3512: Added capability of handling namespace packages created
accidentally/purposefully via discovery configuration during editable installs.
This should emulate the behaviour of a non-editable installation.
```
### 64.0.1
```
=======
Misc
----
* 3497: Fixed ``editable_wheel`` for legacy namespaces.
* 3502: Fixed issue with editable install and single module distributions.
* 3503: Added filter to ignore external ``.egg-info`` files in manifest.
Some plugins might rely on the fact that the ``.egg-info`` directory is
produced inside the project dir, which may not be the case in editable installs
(the ``.egg-info`` directory is produced inside the metadata directory given by
the build frontend via PEP 660 hooks).
```
### 64.0.0
```
=======
Deprecations
------------
* 3380: Passing some types of parameters via ``--global-option`` to setuptools PEP 517/PEP 660 backend
is now considered deprecated. The user can pass the same arbitrary parameter
via ``--build-option`` (``--global-option`` is now reserved for flags like
``--verbose`` or ``--quiet``).
Both ``--build-option`` and ``--global-option`` are supported as a **transitional** effort (a.k.a. "escape hatch").
In the future a proper list of allowed ``config_settings`` may be created.
Breaking Changes
----------------
* 3265: Added implementation for *editable install* hooks (PEP 660).
By default the users will experience a *lenient* behavior which prioritises
the ability of the users of changing the distributed packages (e.g. adding new
files or removing old ones).
But they can also opt into a *strict* mode, which will try to replicate as much
as possible the behavior of the package as if it would be normally installed by
end users. The *strict* editable installation is not able to detect if files
are added or removed from the project (a new installation is required).
This implementation might also affect plugins and customizations that assume
certain ``build`` subcommands don't run during editable installs or that they
always copy files to the temporary build directory.
.. important::
The *editable* aspect of the *editable install* supported this implementation
is restricted to the Python modules contained in the distributed package.
Changes in binary extensions (e.g. C/C++), entry-point definitions,
dependencies, metadata, datafiles, etc may require a new installation.
Changes
-------
* 3380: Improved the handling of the ``config_settings`` parameter in both PEP 517 and
PEP 660 interfaces:
- It is possible now to pass both ``--global-option`` and ``--build-option``.
As discussed in 1928, arbitrary arguments passed via ``--global-option``
should be placed before the name of the setuptools' internal command, while
``--build-option`` should come after.
- Users can pass ``editable-mode=strict`` to select a strict behaviour for the
editable installation.
* 3392: Exposed ``get_output_mapping()`` from ``build_py`` and ``build_ext``
subcommands. This interface is reserved for the use of ``setuptools``
Extensions and third part packages are explicitly disallowed to calling it.
However, any implementation overwriting ``build_py`` or ``build_ext`` are
required to honour this interface.
* 3412: Added ability of collecting source files from custom build sub-commands to
``sdist``. This allows plugins and customization scripts to automatically
add required source files in the source distribution.
* 3414: Users can *temporarily* specify an environment variable
``SETUPTOOLS_ENABLE_FEATURES=legacy-editable`` as a escape hatch for the
:pep:`660` behavior. This setting is **transitional** and may be removed in the
future.
* 3484: Added *transient* ``compat`` mode to editable installs.
This more will be temporarily available (to facilitate the transition period)
for those that want to emulate the behavior of the ``develop`` command
(in terms of what is added to ``sys.path``).
This mode is provided "as is", with limited support, and will be removed in
future versions of ``setuptools``.
Documentation changes
---------------------
* 3414: Updated :doc:`Development Mode </userguide/development_mode>` to reflect on the
implementation of :pep:`660`.
```
### 63.4.3
```
=======
Misc
----
* 3496: Update to pypa/distutilsb65aa40 including more robust support for library/include dir handling in msvccompiler (pypa/distutils153) and test suite improvements.
```
### 63.4.2
```
=======
Misc
----
* 3453: Bump vendored version of :pypi:`pyparsing` to 3.0.9.
* 3481: Add warning for potential ``install_requires`` and ``extras_require``
misconfiguration in ``setup.cfg``
* 3487: Modified ``pyproject.toml`` validation exception handling to
make relevant debugging information easier to spot.
```
### 63.4.1
```
=======
Misc
----
* 3482: Sync with pypa/distutils274758f1c02048d295efdbc13d2f88d9923547f8, restoring compatibility shim in bdist.format_commands.
```
### 63.4.0
```
=======
Changes
-------
* 2971: ``upload_docs`` command is deprecated once again.
Documentation changes
---------------------
* 3443: Installed ``sphinx-hoverxref`` extension to show tooltips on internal an external references.
-- by :user:`humitos`
* 3444: Installed ``sphinx-notfound-page`` extension to generate nice 404 pages.
-- by :user:`humitos`
Misc
----
* 3480: Merge with pypa/distutilsc397f4c
```
### 63.3.0
```
=======
Changes
-------
* 3475: Merge with pypa/distutils129480b, including substantial delinting and cleanup, some refactoring around compiler logic, better messaging in cygwincompiler (pypa/distutils161).
```
### 63.2.0
```
=======
Changes
-------
* 3395: Included a performance optimization: ``setuptools.build_meta`` no longer tries
to :func:`compile` the setup script code before :func:`exec`-ing it.
Misc
----
* 3435: Corrected issue in macOS framework builds on Python 3.9 not installed by homebrew (pypa/distutils158).
```
### 63.1.0
```
=======
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).
```
### 63.0.0
```
=======
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`
```
### 62.6.0
```
=======
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`
```
### 62.5.0
```
=======
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.
```
### 62.4.0
```
=======
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).
```
### 62.3.4
```
=======
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.
```
### 62.3.3
```
=======
Documentation changes
---------------------
* 3331: Replaced single backticks with double ones in ``CHANGES.rst`` -- by :user:`codeandfire`
* 3332: Fixed grammar/typos, modified example directory trees for src-layout and flat-layout -- by :user:`codeandfire`
* 3335: Changes to code snippets and other examples in the Data Files page of the User Guide -- by :user:`codeandfire`
Misc
----
* 3336: Modified ``test_setup_install_includes_dependencies`` to work with custom ``PYTHONPATH`` –- by :user:`hroncok`
```
### 62.3.2
```
=======
Misc
----
* 3328: Include a first line summary to some of the existing multi-line warnings.
```
### 62.3.1
```
=======
Misc
----
* 3320: Fixed typo which causes ``namespace_packages`` to raise an error instead of
warning.
```
### 62.3.0
```
=======
Deprecations
------------
* 3262: Formally added deprecation messages for ``namespace_packages``.
The methodology that uses ``pkg_resources`` and ``namespace_packages`` for
creating namespaces was already discouraged by the :doc:`setuptools docs
</userguide/package_discovery>` and the
:doc:`Python Packaging User Guide <PyPUG:guides/packaging-namespace-packages>`,
therefore this change just make the deprecation more official.
Users can consider migrating to native/implicit namespaces (as introduced in
:pep:`420`).
* 3308: Relying on ``include_package_data`` to ensure sub-packages are automatically
added to the build wheel distribution (as "data") is now considered a
deprecated practice.
This behaviour was controversial and caused inconsistencies (3260).
Instead, projects are encouraged to properly configure ``packages`` or use
discovery tools. General information can be found in :doc:`userguide/package_discovery`.
Changes
-------
* 1806: Allowed recursive globs (``**``) in ``package_data``. -- by :user:`nullableVoidPtr`
* 3206: Fixed behaviour when both ``install_requires`` (in ``setup.py``) and
``dependencies`` (in ``pyproject.toml``) are specified.
The configuration in ``pyproject.toml`` will take precedence over ``setup.py``
(in accordance with PEP 621). A warning was added to inform users.
Documentation changes
---------------------
* 3307: Added introduction to references/keywords.
Added deprecation tags to test kwargs.
Moved userguide/keywords to deprecated section.
Clarified in deprecated doc what keywords came from distutils and which were added or changed by setuptools.
Misc
----
* 3274: Updated version of vendored ``pyparsing`` to 3.0.8 to avoid problems with
upcoming deprecation in Python 3.11.
* 3292: Added warning about incompatibility with old versions of
``importlib-metadata``.
```
### 62.2.0
```
=======
Changes
-------
* 3299: Optional metadata fields are now truly optional. Includes merge with pypa/distutilsa7cfb56 per pypa/distutils138.
Misc
----
* 3282: Added CI cache for ``setup.cfg`` examples used when testing ``setuptools.config``.
```
### 62.1.0
```
=======
Changes
-------
* 3258: Merge pypa/distutils5229dad46b.
Misc
----
* 3249: Simplified ``package_dir`` obtained via auto-discovery.
```
### 62.0.0
```
=======
Breaking Changes
----------------
* 3151: Made ``setup.py develop --user`` install to the user site packages directory even if it is disabled in the current interpreter.
Changes
-------
* 3153: When resolving requirements use both canonical and normalized names -- by :user:`ldaniluk`
* 3167: Honor unix file mode in ZipFile when installing wheel via ``install_as_egg`` -- by :user:`delijati`
Misc
----
* 3088: Fixed duplicated tag with the ``dist-info`` command.
* 3247: Fixed problem preventing ``readme`` specified as dynamic in ``pyproject.toml``
from being dynamically specified in ``setup.py``.
```
### 61.3.1
```
=======
Misc
----
* 3233: Included missing test file ``setupcfg_examples.txt`` in ``sdist``.
* 3233: Added script that allows developers to download ``setupcfg_examples.txt`` prior to
running tests. By caching these files it should be possible to run the test suite
offline.
```
### 61.3.0
```
=======
Changes
-------
* 3229: Disabled automatic download of ``trove-classifiers`` to facilitate reproducibility.
Misc
----
* 3229: Updated ``pyproject.toml`` validation via ``validate-pyproject`` v0.7.1.
* 3229: New internal tool made available for updating the code responsible for
the validation of ``pyproject.toml``.
This tool can be executed via ``tox -e generate-validation-code``.
```
### 61.2.0
```
=======
Changes
-------
* 3215: Ignored a subgroup of invalid ``pyproject.toml`` files that use the ``[project]``
table to specify only ``requires-python`` (**transitional**).
.. warning::
Please note that future releases of setuptools will halt the build process
if a ``pyproject.toml`` file that does not match doc:`the PyPA Specification
<PyPUG:specifications/section-distribution-metadata>` is given.
* 3215: Updated ``pyproject.toml`` validation, as generated by ``validate-pyproject==0.6.1``.
* 3218: Prevented builds from erroring if the project specifies metadata via
``pyproject.toml``, but uses other files (e.g. ``setup.py``) to complement it,
without setting ``dynamic`` properly.
.. important::
This is a **transitional** behaviour.
Future releases of ``setuptools`` may simply ignore externally set metadata
not backed by ``dynamic`` or even halt the build with an error.
* 3224: Merge changes from pypa/distutilse1d5c9b1f6
Documentation changes
---------------------
* 3217: Fixed typo in ``pyproject.toml`` example in Quickstart -- by :user:`pablo-cardenas`.
Misc
----
* 3223: Fixed missing requirements with environment markers when
``optional-dependencies`` is set in ``pyproject.toml``.
```
### 61.1.1
```
=======
Misc
----
* 3212: Fixed missing dependencies when running ``setup.py install``.
Note that calling ``setup.py install`` directly is still deprecated and
will be removed in future versions of ``setuptools``.
Please check the release notes for :ref:`setup_install_deprecation_note`.
```
### 61.1.0
```
=======
Deprecations
------------
* 3206: Changed ``setuptools.convert_path`` to an internal function that is not exposed
as part of setuptools API.
Future releases of ``setuptools`` are likely to remove this function.
Changes
-------
* 3202: Changed behaviour of auto-discovery to not explicitly expand ``package_dir``
for flat-layouts and to not use relative paths starting with ``./``.
* 3203: Prevented ``pyproject.toml`` parsing from overwriting
``dist.include_package_data`` explicitly set in ``setup.py`` with default
value.
* 3208: Added a warning for non existing files listed with the ``file`` directive in
``setup.cfg`` and ``pyproject.toml``.
* 3208: Added a default value for dynamic ``classifiers`` in ``pyproject.toml`` when
files are missing and errors being ignored.
* 3211: Disabled auto-discovery when distribution class has a ``configuration``
attribute (e.g. when the ``setup.py`` script contains ``setup(...,
configuration=...)``). This is done to ensure extension-only packages created
with ``numpy.distutils.misc_util.Configuration`` are not broken by the safe
guard
behaviour to avoid accidental multiple top-level packages in a flat-layout.
.. note::
Users that don't set ``packages``, ``py_modules``, or ``configuration`` are
still likely to observe the auto-discovery behavior, which may halt the
build if the project contains multiple directories and/or multiple Python
files directly under the project root.
To disable auto-discovery please explicitly set either ``packages`` or
``py_modules``. Alternatively you can also configure :ref:`custom-discovery`.
```
### 61.0.0
```
=======
Deprecations
------------
* 3068: Deprecated ``setuptools.config.read_configuration``,
``setuptools.config.parse_configuration`` and other functions or classes
from ``setuptools.config``.
Users that still need to parse and process configuration from ``setup.cfg`` can
import a direct replacement from ``setuptools.config.setupcfg``, however this
module is transitional and might be removed in the future
(the ``setup.cfg`` configuration format itself is likely to be deprecated in the future).
Breaking Changes
----------------
* 2894: If you purposefully want to create an *"empty distribution"*, please be aware
that some Python files (or general folders) might be automatically detected and
included.
Projects that currently don't specify both ``packages`` and ``py_modules`` in their
configuration and contain extra folders or Python files (not meant for distribution),
might see these files being included in the wheel archive or even experience
the build to fail.
You can check details about the automatic discovery (and how to configure a
different behaviour) in :doc:`/userguide/package_discovery`.
* 3067: If the file ``pyproject.toml`` exists and it includes project
metadata/config (via ``[project]`` table or ``[tool.setuptools]``),
a series of new behaviors that are not backward compatible may take place:
- The default value of ``include_package_data`` will be considered to be ``True``.
- Setuptools will attempt to validate the ``pyproject.toml`` file according
to PEP 621 specification.
- The values specified in ``pyproject.toml`` will take precedence over those
specified in ``setup.cfg`` or ``setup.py``.
Changes
-------
* 2887: **[EXPERIMENTAL]** Added automatic discovery for ``py_modules`` and ``packages``
-- by :user:`abravalheri`.
Setuptools will try to find these values assuming that the package uses either
the *src-layout* (a ``src`` directory containing all the packages or modules),
the *flat-layout* (package directories directly under the project root),
or the *single-module* approach (an isolated Python file, directly under
the project root).
The automatic discovery will also respect layouts that are explicitly
configured using the ``package_dir`` option.
For backward-compatibility, this behavior will be observed **only if both**
``py_modules`` **and** ``packages`` **are not set**.
(**Note**: specifying ``ext_modules`` might also prevent auto-discover from
taking place)
If setuptools detects modules or packages that are not supposed to be in the
distribution, please manually set ``py_modules`` and ``packages`` in your
``setup.cfg`` or ``setup.py`` file.
If you are using a *flat-layout*, you can also consider switching to
*src-layout*.
* 2887: **[EXPERIMENTAL]** Added automatic configuration for the ``name`` metadata
-- by :user:`abravalheri`.
Setuptools will adopt the name of the top-level package (or module in the case
of single-module distributions), **only when** ``name`` **is not explicitly
provided**.
Please note that it is not possible to automatically derive a single name when
the distribution consists of multiple top-level packages or modules.
* 3066: Added vendored dependencies for :pypi:`tomli`, :pypi:`validate-pyproject`.
These dependencies are used to read ``pyproject.toml`` files and validate them.
* 3067: **[EXPERIMENTAL]** When using ``pyproject.toml`` metadata,
the default value of ``include_package_data`` is changed to ``True``.
* 3068: **[EXPERIMENTAL]** Add support for ``pyproject.toml`` configuration
(as introduced by :pep:`621`). Configuration parameters not covered by
standards are handled in the ``[tool.setuptools]`` sub-table.
In the future, existing ``setup.cfg`` configuration
may be automatically converted into the ``pyproject.toml`` equivalent before taking effect
(as proposed in 1688). Meanwhile users can use automated tools like
:pypi:`ini2toml` to help in the transition.
Please note that the legacy backend is not guaranteed to work with
``pyproject.toml`` configuration.
-- by :user:`abravalheri`
* 3125: Implicit namespaces (as introduced in :pep:`420`) are now considered by default
during :doc:`package discovery </userguide/package_discovery>`, when
``setuptools`` configuration and project metadata are added to the
``pyproject.toml`` file.
To disable this behaviour, use ``namespaces = False`` when explicitly setting
the ``[tool.setuptools.packages.find]`` section in ``pyproject.toml``.
This change is backwards compatible and does not affect the behaviour of
configuration done in ``setup.cfg`` or ``setup.py``.
* 3152: **[EXPERIMENTAL]** Added support for ``attr:`` and ``cmdclass`` configurations
in ``setup.cfg`` and ``pyproject.toml`` when ``package_dir`` is implicitly
found via auto-discovery.
* 3178: Postponed importing ``ctypes`` when hiding files on Windows.
This helps to prevent errors in systems that might not have ``libffi`` installed.
* 3179: Merge with pypa/distutils267dbd25ac
Documentation changes
---------------------
* 3172: Added initial documentation about configuring ``setuptools`` via ``pyproject.toml``
(using standard project metadata).
Misc
----
* 3065: Refactored ``setuptools.config`` by separating configuration parsing (specific
to the configuration file format, e.g. ``setup.cfg``) and post-processing
(which includes directives such as ``file:`` that can be used across different
configuration formats).
```
### 60.10.0
```
========
Changes
-------
* 2971: Deprecated upload_docs command, to be removed in the future.
* 3137: Use samefile from stdlib, supported on Windows since Python 3.2.
* 3170: Adopt nspektr (vendored) to implement Distribution._install_dependencies.
Documentation changes
---------------------
* 3144: Added documentation on using console_scripts from setup.py, which was previously only shown in setup.cfg -- by :user:`xhlulu`
* 3148: Added clarifications about ``MANIFEST.in``, that include links to PyPUG docs
and more prominent mentions to using a revision control system plugin as an
alternative.
* 3148: Removed mention to ``pkg_resources`` as the recommended way of accessing data
files, in favour of importlib.resources.
Additionally more emphasis was put on the fact that *package data files* reside
**inside** the *package directory* (and therefore should be *read-only*).
Misc
----
* 3120: Added workaround for intermittent failures of backend tests on PyPy.
These tests now are marked with `XFAIL
<https://docs.pytest.org/en/stable/how-to/skipping.html>`_, instead of erroring
out directly.
* 3124: Improved configuration for :pypi:`rst-linker` (extension used to build the
changelog).
* 3133: Enhanced isolation of tests using virtual environments - PYTHONPATH is not leaking to spawned subprocesses -- by :user:`befeleme`
* 3147: Added options to provide a pre-built ``setuptools`` wheel or sdist for being
used during tests with virtual environments.
Paths for these pre-built distribution files can now be set via the environment
variables: ``PRE_BUILT_SETUPTOOLS_SDIST`` and ``PRE_BUILT_SETUPTOOLS_WHEEL``.
```
### 60.9.3
```
=======
Misc
----
* 3093: Repaired automated release process.
```
### 60.9.2
```
=======
Misc
----
* 3035: When loading distutils from the vendored copy, rewrite ``__name__`` to ensure consistent importing from inside and out.
```
### 60.9.1
```
=======
Misc
----
* 3102: Prevent vendored importlib_metadata from loading distributions from older importlib_metadata.
* 3103: Fixed issue where string-based entry points would be omitted.
* 3107: Bump importlib_metadata to 4.11.1 addressing issue with parsing requirements in egg-info as found in PyPy.
```
### 60.9.0
```
=======
Changes
-------
* 2876: In the build backend, allow single config settings to be supplied.
* 2993: Removed workaround in distutils hack for get-pip now that pypa/get-pip137 is closed.
* 3085: Setuptools no longer relies on ``pkg_resources`` for entry point handling.
* 3098: Bump vendored packaging to 21.3.
* Removed bootstrap script.
.. warning:: Users trying to install the unmaintained :pypi:`pathlib` backport
from PyPI/``sdist``/source code may find problems when using ``setuptools >= 60.9.0``.
This happens because during the installation, the unmaintained
implementation of ``pathlib`` is loaded and may cause compatibility problems
(it does not expose the same public API defined in the Python standard library).
Whenever possible users should avoid declaring ``pathlib`` as a dependency.
An alternative is to pre-build a wheel for ``pathlib`` using a separated
virtual environment with an older version of setuptools and install the
library directly from the pre-built wheel.
```
### 60.8.2
```
=======
Misc
----
* 3091: Make ``concurrent.futures`` import lazy in vendored ``more_itertools``
package to a avoid importing threading as a side effect (which caused
`gevent/gevent1865 <https://github.com/gevent/gevent/issues/1865>`__).
-- by :user:`maciejp-ro`
```
### 60.8.1
```
=======
Misc
----
* 3084: When vendoring jaraco packages, ensure the namespace package is converted to a simple package to support zip importer.
```
### 60.8.0
```
=======
Changes
-------
* 3085: Setuptools now vendors importlib_resources and importlib_metadata and jaraco.text. Setuptools no longer relies on pkg_resources for ensure_directory nor parse_requirements.
```
### 60.7.1
```
=======
Misc
----
* 3072: Remove lorem_ipsum from jaraco.text when vendored.
```
### 60.7.0
```
=======
Changes
-------
* 3061: Vendored jaraco.text and use line processing from that library in pkg_resources.
Misc
----
* 3070: Avoid AttributeError in easy_install.create_home_path when sysconfig.get_config_vars values are not strings.
```
### 60.6.0
```
=======
Changes
-------
* 3043: Merge with pypa/distutilsbb018f1ac3 including consolidated behavior in sysconfig.get_platform (pypa/distutils104).
* 3057: Don't include optional ``Home-page`` in metadata if no ``url`` is specified. -- by :user:`cdce8p`
* 3062: Merge with pypa/distutilsb53a824ec3 including improved support for lib directories on non-x64 Windows builds.
Documentation changes
---------------------
* 2897: Added documentation about wrapping ``setuptools.build_meta`` in a in-tree
custom backend. This is a :pep:`517`-compliant way of dynamically specifying
build dependencies (e.g. when platform, OS and other markers are not enough).
-- by :user:`abravalheri`
* 3034: Replaced occurrences of the defunct distutils-sig mailing list with pointers
to GitHub Discussions.
-- by :user:`ashemedai`
* 3056: The documentation has stopped suggesting to add ``wheel`` to
:pep:`517` requirements -- by :user:`webknjaz`
Misc
----
* 3054: Used Py3 syntax ``super().__init__()`` -- by :user:`imba-tjd`
```
### 60.5.4
```
=======
Misc
----
* 3009: Remove filtering of distutils warnings.
* 3031: Suppress distutils replacement when building or testing CPython.
```
##
This PR updates setuptools from 36.7.2 to 74.1.2.
Changelog
### 74.1.2 ``` ======= Bugfixes -------- - Fixed TypeError in sdist filelist processing by adding support for pathlib Paths for the build_base. (4615) - Removed degraded and deprecated ``test_integration`` (easy_install) from the test suite. (4632) ``` ### 74.1.1 ``` ======= Bugfixes -------- - Fixed TypeError in ``msvc.EnvironmentInfo.return_env`` when no runtime redistributables are installed. (1902) ``` ### 74.1.0 ``` ======= Features -------- - Added support for defining ``ext-modules`` via ``pyproject.toml`` (**EXPERIMENTAL**, may change in future releases). (4568) Bugfixes -------- - Merge with pypa/distutils3dcdf8567, removing the duplicate vendored copy of packaging. (4622) - Restored ``setuptools.msvc.Environmentinfo`` as it is used externally. (4625) ``` ### 74.0.0 ``` ======= Features -------- - Changed the type of error raised by ``setuptools.command.easy_install.CommandSpec.from_param`` on unsupported argument from `AttributeError` to `TypeError` -- by :user:`Avasam` (4548) - Added detection of ARM64 variant of MSVC -- by :user:`saschanaz` (4553) - Made ``setuptools.package_index.Credential`` a `typing.NamedTuple` -- by :user:`Avasam` (4585) - Reraise error from ``setuptools.command.easy_install.auto_chmod`` instead of nonsensical ``TypeError: 'Exception' object is not subscriptable`` -- by :user:`Avasam` (4593) - Fully typed all collection attributes in ``pkg_resources`` -- by :user:`Avasam` (4598) - Automatically exclude ``.tox|.nox|.venv`` directories from ``sdist``. (4603) Deprecations and Removals ------------------------- - Removed the monkeypatching of distutils._msvccompiler. Now all compiler logic is consolidated in distutils. (4600) - Synced with pypa/distutils58fe058e4, including consolidating Visual Studio 2017 support (4600, pypa/distutils289), removal of deprecated legacy MSVC compiler modules (pypa/distutils287), suppressing of errors when the home directory is missing (pypa/distutils278), removal of wininst binaries (pypa/distutils282). (4606) Misc ---- - 4592 ``` ### 73.0.1 ``` ======= Bugfixes -------- - Remove `abc.ABCMeta` metaclass from abstract classes. `pypa/setuptools4503 <https://github.com/pypa/setuptools/pull/4503>`_ had an unintended consequence of causing potential ``TypeError: metaclass conflict: the metaclass of a derived class must be a (non-strict) subclass of the metaclasses of all its bases`` -- by :user:`Avasam` (#4579) ``` ### 73.0.0 ``` ======= Features -------- - Mark abstract base classes and methods with `abc.ABC` and `abc.abstractmethod` -- by :user:`Avasam` (4503) - Changed the order of type checks in ``setuptools.command.easy_install.CommandSpec.from_param`` to support any `collections.abc.Iterable` of `str` param -- by :user:`Avasam` (4505) Bugfixes -------- - Prevent an error in ``bdist_wheel`` if ``compression`` is set to a `str` (even if valid) after finalizing options but before running the command. -- by :user:`Avasam` (4383) - Raises an exception when ``py_limited_api`` is used in a build with ``Py_GIL_DISABLED``. This is currently not supported (python/cpython111506). (4420) - Synced with pypa/distutils30b7331 including fix for modified check on empty sources (pypa/distutils284). Deprecations and Removals ------------------------- - ``setuptools`` is replacing the usages of :pypi:`ordered_set` with simple instances of ``dict[Hashable, None]``. This is done to remove the extra dependency and it is possible because since Python 3.7, ``dict`` maintain insertion order. (4574) Misc ---- - 4534, 4546, 4554, 4559, 4565 ``` ### 72.2.0 ``` ======= Features -------- - Merged with pypa/distutilsb7ee725f3 including: Support for Pathlike objects in data files and extensions (pypa/distutils272, pypa/distutils237), native support for C++ compilers (pypa/distuils228) and removed unused get_msvcr() (pypa/distutils274). (4538) ``` ### 72.1.0 ``` ======= Features -------- - Restore the tests command and deprecate access to the module. (4519) (4520) ``` ### 72.0.0 ``` ======= Deprecations and Removals ------------------------- - The test command has been removed. Users relying on 'setup.py test' will need to migrate to another test runner or pin setuptools before this version. (931) ``` ### 71.1.0 ``` ======= Features -------- - Added return types to typed public functions -- by :user:`Avasam` Marked `pkg_resources` as ``py.typed`` -- by :user:`Avasam` (4409) Misc ---- - 4492 ``` ### 71.0.4 ``` ======= Bugfixes -------- - Removed lingering unused code around Distribution._patched_dist. (4489) ``` ### 71.0.3 ``` ======= Bugfixes -------- - Reset the backports module when enabling vendored packages. (4476) ``` ### 71.0.2 ``` ======= Bugfixes -------- - Include all vendored files in the sdist. (4480) ``` ### 71.0.1 ``` ======= Bugfixes -------- - Restored package data that went missing in 71.0. This change also incidentally causes tests to be installed once again. (4475) ``` ### 71.0.0 ``` ======= Deprecations and Removals ------------------------- - Now setuptools declares its own dependencies in the ``core`` extra. Dependencies are still vendored for bootstrapping purposes, but setuptools will prefer installed dependencies if present. The ``core`` extra is used for informational purposes and should *not* be declared in package metadata (e.g. ``build-requires``). Downstream packagers can de-vendor by simply removing the ``setuptools/_vendor`` directory. Since Setuptools now prefers installed dependencies, those installing to an environment with old, incompatible dependencies will not work. In that case, either uninstall the incompatible dependencies or upgrade them to satisfy those declared in ``core``. (2825) ``` ### 70.3.0 ``` ======= Features -------- - Support for loading distutils from the standard library is now deprecated, including use of SETUPTOOLS_USE_DISTUTILS=stdlib and importing distutils before importing setuptools. (4137) Bugfixes -------- - Bugfix for building Cython extension on Windows (pypa/distutils268). ``` ### 70.2.0 ``` ======= Features -------- - Updated distutils including significant changes to support Cygwin and mingw compilers. (4444) Bugfixes -------- - Fix distribution name normalisation (:pep:`625`) for valid versions that are not canonical (e.g. ``1.0-2``). (4434) ``` ### 70.1.1 ``` ======= Misc ---- - 4429 ``` ### 70.1.0 ``` ======= Features -------- - Adopted the ``bdist_wheel`` command from the ``wheel`` project -- by :user:`agronholm` (1386) - Improve error message when ``pkg_resources.ZipProvider`` tries to extract resources with a missing Egg -- by :user:`Avasam` Added variables and parameter type annotations to ``pkg_resources`` to be nearly on par with typeshed.\* -- by :user:`Avasam` \* Excluding ``TypeVar`` and ``overload``. Return types are currently inferred. (4246) - Migrated Setuptools' own config to pyproject.toml (4310) Bugfixes -------- - Prevent a ``TypeError: 'NoneType' object is not callable`` when ``shutil_rmtree`` is called without an ``onexc`` parameter on Python<=3.11 -- by :user:`Avasam` (4382) - Replace use of mktemp with can_symlink from the stdlib test suite. (4403) - Improvement for ``attr:`` directives in configuration to handle more edge cases related to complex ``package_dir``. (4405) - Fix accidental implicit string concatenation. (4411) Misc ---- - 4365, 4422 ``` ### 70.0.0 ``` ======= Features -------- - Emit a warning when ``[tools.setuptools]`` is present in ``pyproject.toml`` and will be ignored. -- by :user:`SnoopJ` (4150) - Improved `AttributeError` error message if ``pkg_resources.EntryPoint.require`` is called without extras or distribution Gracefully "do nothing" when trying to activate a ``pkg_resources.Distribution`` with a `None` location, rather than raising a `TypeError` -- by :user:`Avasam` (4262) - Typed the dynamically defined variables from `pkg_resources` -- by :user:`Avasam` (4267) - Modernized and refactored VCS handling in package_index. (4332) Bugfixes -------- - In install command, use super to call the superclass methods. Avoids race conditions when monkeypatching from _distutils_system_mod occurs late. (4136) - Fix finder template for lenient editable installs of implicit nested namespaces constructed by using ``package_dir`` to reorganise directory structure. (4278) - Fix an error with `UnicodeDecodeError` handling in ``pkg_resources`` when trying to read files in UTF-8 with a fallback -- by :user:`Avasam` (4348) Improved Documentation ---------------------- - Uses RST substitution to put badges in 1 line. (4312) Deprecations and Removals ------------------------- - Further adoption of UTF-8 in ``setuptools``. This change regards mostly files produced and consumed during the build process (e.g. metadata files, script wrappers, automatically updated config files, etc..) Although precautions were taken to minimize disruptions, some edge cases might be subject to backwards incompatibility. Support for ``"locale"`` encoding is now **deprecated**. (4309) - Remove ``setuptools.convert_path`` after long deprecation period. This function was never defined by ``setuptools`` itself, but rather a side-effect of an import for internal usage. (4322) - Remove fallback for customisations of ``distutils``' ``build.sub_command`` after long deprecated period. Users are advised to import ``build`` directly from ``setuptools.command.build``. (4322) - Removed ``typing_extensions`` from vendored dependencies -- by :user:`Avasam` (4324) - Remove deprecated ``setuptools.dep_util``. The provided alternative is ``setuptools.modified``. (4360) Misc ---- - 4255, 4280, 4282, 4308, 4348 ``` ### 69.5.1 ``` ======= No significant changes. ``` ### 69.5.0 ``` ======= Features -------- - Refresh unpinned vendored dependencies. (4253) - Updated vendored packaging to version 24.0. (4301) ``` ### 69.4.2 ``` ======= Bugfixes -------- - Merged bugfix for pypa/distutils246. ``` ### 69.4.1 ``` ======= No significant changes. ``` ### 69.4.0 ``` ======= Features -------- - Merged with pypa/distutils55982565e, including interoperability improvements for rfc822_escape (pypa/distutils213), dynamic resolution of config_h_filename for Python 3.13 compatibility (pypa/distutils219), added support for the z/OS compiler (pypa/distutils216), modernized compiler options in unixcompiler (pypa/distutils214), fixed accumulating flags bug after compile/link (pypa/distutils207), fixed enconding warnings (pypa/distutils236), and general quality improvements (pypa/distutils234). (4298) ``` ### 69.3.1 ``` ======= Bugfixes -------- - Remove attempt to canonicalize the version. It's already canonical enough. (4302) ``` ### 69.3.0 ``` ======= Features -------- - Support PEP 625 by canonicalizing package name and version in filenames per `the spec <https://packaging.python.org/en/latest/specifications/source-distribution-format/#source-distribution-file-name>`_. Projects whose names contain uppercase characters, dashes, or periods will now see their sdist names normalized to match the standard and the format previously seen in wheels. For example: - ``zope.interface`` -> ``zope_interface`` - ``CherryPy`` -> ``cherrypy`` - ``foo-bar_baz`` -> ``foo_bar_baz`` Projects are encouraged to adopt this change to align with standards and other backend build systems. (3593) ``` ### 69.2.0 ``` ======= Features -------- - Explicitly use ``encoding="locale"`` for ``.pth`` files whenever possible, to reduce ``EncodingWarnings``. This avoid errors with UTF-8 (see discussion in python/cpython77102). (4265) Bugfixes -------- - Clarify some `pkg_resources` methods return `bytes`, not `str`. Also return an empty `bytes` in ``EmptyProvider._get`` -- by :user:`Avasam` (4243) - Return an empty `list` by default in ``pkg_resources.ResourceManager.cleanup_resources`` -- by :user:`Avasam` (4244) - Made ``pkg_resoursces.NullProvider``'s ``has_metadata`` and ``metadata_isdir`` methods return actual booleans like all other Providers. -- by :user:`Avasam` (4254) Misc ---- - 4237, 4238, 4241, 4260, 4261, 4263 ``` ### 69.1.1 ``` ======= Bugfixes -------- - Fix argument order of ``--config-settings["--build-option"]`` arguments. This was broken by <https://github.com/pypa/setuptools/pull/4079>`. (#4217) Misc ---- - 4231 ``` ### 69.1.0 ``` ======= Features -------- - Updated and removed obsolete Python < 3.8 code and comments. -- by :user:`Avasam` (4096) - Updated `pkg_resources` to use stdlib `importlib.machinery` instead of ``importlib_machinery`` -- by :user:`Avasam` (4097) Bugfixes -------- - In tests, rely on pytest-home for reusable fixture. (4072) - Explicitely marked as ``Protocol`` and fixed missing ``self`` argument in interfaces ``pkg_resources.IMetadataProvider`` and ``pkg_resources.IResourceProvider`` -- by :user:`Avasam` (4144) - Restored expectation that egg-link files would be named with dash separators for compatibility with pip prior to version 24. (4167) Improved Documentation ---------------------- - Updated documentation referencing obsolete Python 3.7 code. -- by :user:`Avasam` (4096) - Changed ``versionadded`` for "Type information included by default" feature from ``v68.3.0`` to ``v69.0.0`` -- by :user:`Avasam` (4182) - Described the auto-generated files -- by :user:`VladimirFokow` (4198) - Updated "Quickstart" to describe the current status of ``setup.cfg`` and ``pyproject.toml`` -- by :user:`VladimirFokow` (4200) ``` ### 69.0.3 ``` ======= Bugfixes -------- - Retain valid names with underscores in egg_info. ``` ### 69.0.2 ``` ======= Bugfixes -------- - Added missing estimated date for removing ``setuptools.dep_util`` (deprecated in v69.0.0). (4131) ``` ### 69.0.1 ``` ======= Bugfixes -------- - Fixed imports of ``setuptools.dep_util.newer_group``. A deprecation warning is issued instead of a hard failure. (4126) ``` ### 69.0.0 ``` ======= Features -------- - Include type information (``py.typed``, ``*.pyi``) by default (3136) -- by :user:`Danie-1`, **EXPERIMENTAL**. (3136) - Exported ``distutils.dep_util`` and ``setuptools.dep_util`` through ``setuptools.modified`` -- by :user:`Avasam` (4069) - Merged with pypa/distutils7a04cbda0fc714. Bugfixes -------- - Replaced hardcoded numeric values with :obj:`dis.opmap`, fixing problem with 3.13.0a1. (4094) Deprecations and Removals ------------------------- - Configuring project ``version`` and ``egg_info.tag_*`` in such a way that results in invalid version strings (according to :pep:`440`) is no longer permitted. (4066) - Removed deprecated ``egg_base`` option from ``dist_info``. Note that the ``dist_info`` command is considered internal to the way ``setuptools`` build backend works and not intended for public usage. (4066) - The parsing of the deprecated ``metadata.license_file`` and ``metadata.requires`` fields in ``setup.cfg`` is no longer supported. Users are expected to move to ``metadata.license_files`` and ``options.install_requires`` (respectively). (4066) - Passing ``config_settings`` to ``setuptools.build_meta`` with deprecated values for ``--global-option`` is no longer allowed. (4066) - Removed deprecated ``namespace-packages`` from ``pyproject.toml``. Users are asked to use :doc:`implicit namespace packages <PyPUG:guides/packaging-namespace-packages>` (as defined in :pep:`420`). (4066) - Added strict enforcement for ``project.dynamic`` in ``pyproject.toml``. This removes the transitional ability of users configuring certain parameters via ``setup.py`` without making the necessary changes to ``pyproject.toml`` (as mandated by :pep:`621`). (4066) - Removed handling of ``--config-settings["--build-option"]`` in ``setuptools.build_meta`` from build-backend API hooks *other than* ``build_wheel``. This was motivate by `errors caused when passing this option <https://github.com/pypa/setuptools/issues/2491#issuecomment-1742859314>`_. (4079) ``` ### 68.2.2 ``` ======= Bugfixes -------- - Improve backwards compatibility with deprecated CLI practices. (4048) ``` ### 68.2.1 ``` ======= Bugfixes -------- - Avoid using caching attributes in ``Distribution.metadata`` for requirements. This is done for backwards compatibility with customizations that attempt to modify ``install_requires`` or ``extras_require`` at a late point (still not recommended). (4043) Misc ---- - 4045 ``` ### 68.2.0 ``` ======= Features -------- - Rework how ``setuptools`` internally handles ``dependencies/install_requires`` and ``optional-dependencies/extras_require``. (3903) - Improve the generated ``PKG-INFO`` files, by adding ``Requires-Dist`` fields. Previously, these fields would be omitted in favour of a non-standard ``*.egg-info/requires.txt`` file (which is still generated for the time being). (3904) - Improve atomicity when writing ``PKG-INFO`` files to avoid race conditions with ``importlib.metadata``. (3904) Bugfixes -------- - Fix the name given to the ``*-nspkg.pth`` files in editable installs, ensuring they are unique per distribution. (4041) - Workaround some limitations on ``pkg_resources``-style legacy namespaces in the meta path finder for editable installations. (4041) Misc ---- - 4023, 4027, 4027 ``` ### 68.1.2 ``` ======= Misc ---- - 4022, 4022 ``` ### 68.1.1 ``` ======= Bugfixes -------- - Fix editable install finder handling of nested packages, by only handling 1 level of nesting and relying on ``importlib.machinery`` to find the remaining modules based on the parent package path. (4020) ``` ### 68.1.0 ``` ======= Features -------- - Removed code referencing bdist_wininst in install_scripts. (3525) - Promote ``pyproject.toml``'s ``[tool.setuptools]`` out of beta. Note that some fields are still considered deprecated and/or obsolete, and these might be removed in future versions (i.e., there is no guarantee for long term support and backward compatibility on those fields). (3962) - Automatically add files listed in ``Extension.depends`` to sdists, as long as they are contained in the project directory -- by :user:`RuRo` (4000) - Require Python 3.8 or later. Bugfixes -------- - Made imports in editable installs case-sensitive on case-insensitive filesystems -- by :user:`aganders3` (3995) - Use default encoding to create ``.pth`` files with ``editable_wheel``. (4009) - Detects (and complain about) ``scripts`` and ``gui-scripts`` set via ``setup.py`` when ``pyproject.toml`` does not include them in ``dynamic``. (4012) Misc ---- - 3833, 3960, 4001, 4007 ``` ### 68.0.0 ``` ======= Breaking Changes ---------------- * 3948: Removed verification for existing ``depends.txt`` file (deprecated since v0.5a4). * 3948: Remove autofixing of broken ``.egg-info`` directories containing the ``-`` character in their base name (without suffix). They should no longer be produced by sufficiently new versions of ``setuptools`` (warning introduced in 2005). * 3948: Remove deprecated APIs in ``easy_install``: ``get_script_args``, ``get_script_header`` and ``get_writer``. The direct usage of ``easy_install`` has been deprecated since v58.3.0, and the warnings regarding these APIs predate that version. * 3948: Removed ``egg_info.get_pkg_info_revision`` (deprecated since 2015). * 3948: Removed ``setuptools.dist._get_unpatched`` (deprecated since 2016) * 3948: Removed support for SVN in ``setuptools.package_index`` (deprecated since 2018). * 3948: Removed support for invalid ``pyproject.toml`` files. During the implementation of PEP 621, it was identified that some users were producing invalid files. As a transitional measure, the validation was relaxed for a few use cases. The grace period, however, came to an end. Changes ------- * 3760: Added symlink support to launcher for installed executables -- by :user:`eugene-sevostianov-sc` * 3926: Updated vendored ``packaging`` version from 23.0 to 23.1 -- by :user:`MetRonnie` * 3950: Implemented workaround for old versions of ``vswhere``, which miss the ``-requiresAny`` parameter, such as the ones distributed together with Visual Studio 2017 < 15.6. * 3952: Changed ``DistutilsMetaFinder`` to skip ``spec_for_pip`` on Python >= 3.12. * 3952: Removed ``_distutils_hack.remove_shim`` on Python >= 3.12 (since ``distutils`` was removed from the standard library, ``DistutilsMetaFinder`` cannot be disabled on Python >= 3.12). Misc ---- * 3920: Add a link to deprecation warning in ``pkg_resources`` and improve ``stacklevel`` for better visibility. ``` ### 67.8.0 ``` ======= Changes ------- * 3128: In deprecated easy_install, reload and merge the pth file before saving. Misc ---- * 3915: Adequate tests to the latest changes in ``virtualenv`` for Python 3.12. ``` ### 67.7.2 ``` ======= Misc ---- * 3902: Fixed wrong URLs used in warnings and logs. ``` ### 67.7.1 ``` ======= Misc ---- * 3898: Fixes setuptools.dist:invalid_unless_false when value is false don't raise error -- by :user:`jammarher` ``` ### 67.7.0 ``` ======= 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` ``` ### 67.6.1 ``` ======= 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. ``` ### 67.6.0 ``` ======= Changes ------- * 3804: Added caching for supported wheel tags. * 3846: Added pruning heuristics to ``PackageFinder`` based on ``exclude``. ``` ### 67.5.1 ``` ======= 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. ``` ### 67.5.0 ``` ======= 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. ``` ### 67.4.0 ``` ======= Changes ------- * 3832: Update vendored ``importlib-metadata`` (to 6.0.0) and ``importlib-resources`` (to 5.10.2) ``` ### 67.3.3 ``` ======= Misc ---- * 3820: Restore quoted ``include`` argument to ``has_function``. ``` ### 67.3.2 ``` ======= Misc ---- * 3827: Improve deprecation warning message on ``pkg_resources.declare_namespace`` to display package name. ``` ### 67.3.1 ``` ======= Misc ---- * 3823: Fixes ``egg_info`` code path triggered during integration with ``pip``. ``` ### 67.3.0 ``` ======= Deprecations ------------ * 3434: Added deprecation warning for ``pkg_resources.declare_namespace``. Users that wish to implement namespace packages, are recommended to follow the practice described in PEP 420 and omit the ``__init__.py`` file entirely. Changes ------- * 3792: Reduced usage of ``pkg_resources`` in ``setuptools`` via internal restructuring and refactoring. Misc ---- * 3822: Added debugging tips for "editable mode" and update related docs. Instead of using a custom exception to display the help message to the user, ``setuptools`` will now use a warning and re-raise the original exception. * 3822: Added clarification about ``editable_wheel`` and ``dist_info`` CLI commands: they should not be called directly with ``python setup.py ...``. Instead they are reserved for internal use of ``setuptools`` (effectively as "private" commands). Users are recommended to rely on build backend APIs (:pep:`517` and :pep:`660`) exposed by ``setuptools.build_meta``. ``` ### 67.2.0 ``` ======= Changes ------- * 3809: Merge with distutils8c3c3d29, including fix for ``sysconfig.get_python_inc()`` (pypa/distutils178), fix for segfault on MinGW (pypa/distutils196), and better ``has_function`` support (pypa/distutils195, 3648). ``` ### 67.1.0 ``` ======= Changes ------- * 3795: Ensured that ``__file__`` is an absolute path when executing ``setup.py`` as part of ``setuptools.build_meta``. Misc ---- * 3798: Updated validations for ``pyproject.toml`` using ``validate-pyproject==0.12.1`` to allow stub packages (:pep:`561`) to be listed in ``tool.setuptools.packages`` and ``tool.setuptools.package-dir``. ``` ### 67.0.0 ``` ======= Breaking Changes ---------------- * 3741: Removed patching of ``distutils._msvccompiler.gen_lib_options`` for compatibility with Numpy < 1.11.2 -- by :user:`mgorny` * 3790: Bump vendored version of :pypi:`packaging` to 23.0 (:pypi:`pyparsing` is no longer required and was removed). As a consequence, users will experience a more strict parsing of requirements. Specifications that don't comply with :pep:`440` and :pep:`508` will result in build errors. ``` ### 66.1.1 ``` ======= Misc ---- * 3782: Fixed problem with ``file`` directive in ``tool.setuptools.dynamic`` (``pyproject.toml``) when value is a simple string instead of list. ``` ### 66.1.0 ``` ======= Changes ------- * 3685: Fix improper usage of deprecated/removed ``pkgutil`` APIs in Python 3.12+. * 3779: Files referenced by ``file:`` in ``setup.cfg`` and by ``project.readme.file``, ``project.license.file`` or ``tool.setuptools.dynamic.*.file`` in ``pyproject.toml`` are now automatically included in the generated sdists. Misc ---- * 3776: Added note about using the ``--pep-517`` flag with ``pip`` to workaround ``InvalidVersion`` errors for packages that are already installed in the system. ``` ### 66.0.0 ``` ======= Breaking Changes ---------------- * 2497: Support for PEP 440 non-conforming versions has been removed. Environments containing packages with non-conforming versions may fail or the packages may not be recognized. Changes ------- * 3769: Replace 'appdirs' with 'platformdirs'. ``` ### 65.7.0 ``` ======= Changes ------- * 3594: Added ``htmlcov`` to FlatLayoutModuleFinder.DEFAULT_EXCLUDE -- by :user:`demianbrecht` * 3667: Added a human-readable error description when ``.egg-info`` directory is not writeable -- by :user:`droodev` Misc ---- * 3713: Fixed incomplete ``getattr`` statement that caused problems when accessing undefined attribute. ``` ### 65.6.3 ``` ======= Misc ---- * 3709: Fix condition to patch ``distutils.dist.log`` to only apply when using ``distutils`` from the stdlib. ``` ### 65.6.2 ``` ======= No significant changes. ``` ### 65.6.1 ``` ======= Documentation changes --------------------- * 3689: Documented that ``distutils.cfg`` might be ignored unless ``SETUPTOOLS_USE_DISTUTILS=stdlib``. Misc ---- * 3678: Improve clib builds reproducibility by sorting sources -- by :user:`danigm` * 3684: Improved exception/traceback when invalid entry-points are specified. * 3690: Fixed logging errors: 'underlying buffer has been detached' (issue 1631). * 3693: Merge pypa/distutils3e9d47e with compatibility fix for distutils.log.Log. * 3695, 3697, 3698, 3699: Changed minor text details (spelling, spaces ...) * 3696: Removed unnecessary ``coding: utf-8`` annotations * 3704: Fixed temporary build directories interference with auto-discovery. ``` ### 65.6.0 ``` ======= Changes ------- * 3674: Sync with pypa/distutilse0787fa, including pypa/distutils183 updating distutils to use the Python logging framework. ``` ### 65.5.1 ``` ======= Misc ---- * 3638: Drop a test dependency on the ``mock`` package, always use :external+python:py:mod:`unittest.mock` -- by :user:`hroncok` * 3659: Fixed REDoS vector in package_index -- by :user:`SCH227` ``` ### 65.5.0 ``` ======= Changes ------- * 3624: Fixed editable install for multi-module/no-package ``src``-layout projects. * 3626: Minor refactorings to support distutils using stdlib logging module. Documentation changes --------------------- * 3419: Updated the example version numbers to be compliant with PEP-440 on the "Specifying Your Project’s Version" page of the user guide. Misc ---- * 3569: Improved information about conflicting entries in the current working directory and editable install (in documentation and as an informational warning). * 3576: Updated version of ``validate_pyproject``. ``` ### 65.4.1 ``` ======= Misc ---- * 3613: Fixed encoding errors in ``expand.StaticModule`` when system default encoding doesn't match expectations for source files. * 3617: Merge with pypa/distutils6852b20 including fix for pypa/distutils181. ``` ### 65.4.0 ``` ======= Changes ------- * 3609: Merge with pypa/distutilsd82d926 including support for DIST_EXTRA_CONFIG in pypa/distutils177. ``` ### 65.3.0 ``` ======= Changes ------- * 3547: Stop ``ConfigDiscovery.analyse_name`` from splatting the ``Distribution.name`` attribute -- by :user:`jeamland` Documentation changes --------------------- * 3554: Changed requires to requests in the pyproject.toml example in the :doc:`Dependency management section of the Quickstart guide <userguide/quickstart>` -- by :user:`mfbutner` Misc ---- * 3561: Fixed accidental name matching in editable hooks. ``` ### 65.2.0 ``` ======= Changes ------- * 3553: Sync with pypa/distutils22b9bcf, including fixed cross-compiling support and removing deprecation warning per pypa/distutils169. ``` ### 65.1.1 ``` ======= Misc ---- * 3551: Avoided circular imports in meta path finder for editable installs when a missing module has the same name as its parent. ``` ### 65.1.0 ``` ======= Changes ------- * 3536: Remove monkeypatching of msvc9compiler. Documentation changes --------------------- * 3538: Corrected documentation on how to use the ``legacy-editable`` mode. ``` ### 65.0.2 ``` ======= Misc ---- * 3505: Restored distutils msvccompiler and msvc9compiler modules and marked as deprecated (pypa/distutilsc802880). ``` ### 65.0.1 ``` ======= Documentation changes --------------------- * 3529: Added clarification to :doc:`/userguide/quickstart` about support to ``setup.py``. Misc ---- * 3526: Fixed backward compatibility of editable installs and custom ``build_ext`` commands inheriting directly from ``distutils``. * 3528: Fixed ``buid_meta.prepare_metadata_for_build_wheel`` when given ``metadata_directory`` is ``"."``. ``` ### 65.0.0 ``` ======= Breaking Changes ---------------- * 3505: Removed 'msvccompiler' and 'msvc9compiler' modules from distutils. * 3521: Remove bdist_msi and bdist_wininst commands, which have been deprecated since Python 3.9. Use older Setuptools for these behaviors if needed. Documentation changes --------------------- * 3519: Changed the note in ``keywords`` documentation regarding editable installations to specify which ``setuptools`` version require a minimal ``setup.py`` file or not. ``` ### 64.0.3 ``` ======= Misc ---- * 3515: Fixed "inline" file copying for editable installations and optional extensions. * 3517: Fixed ``editable_wheel`` to ensure other commands are finalized before using them. This should prevent errors with plugins trying to use different commands or reinitializing them. * 3517: Augmented filter to prevent transient/temporary source files from being considered ``package_data`` or ``data_files``. ``` ### 64.0.2 ``` ======= Misc ---- * 3506: Suppress errors in custom ``build_py`` implementations when running editable installs in favor of a warning indicating what is the most appropriate migration path. This is a *transitional* measure. Errors might be raised in future versions of ``setuptools``. * 3512: Added capability of handling namespace packages created accidentally/purposefully via discovery configuration during editable installs. This should emulate the behaviour of a non-editable installation. ``` ### 64.0.1 ``` ======= Misc ---- * 3497: Fixed ``editable_wheel`` for legacy namespaces. * 3502: Fixed issue with editable install and single module distributions. * 3503: Added filter to ignore external ``.egg-info`` files in manifest. Some plugins might rely on the fact that the ``.egg-info`` directory is produced inside the project dir, which may not be the case in editable installs (the ``.egg-info`` directory is produced inside the metadata directory given by the build frontend via PEP 660 hooks). ``` ### 64.0.0 ``` ======= Deprecations ------------ * 3380: Passing some types of parameters via ``--global-option`` to setuptools PEP 517/PEP 660 backend is now considered deprecated. The user can pass the same arbitrary parameter via ``--build-option`` (``--global-option`` is now reserved for flags like ``--verbose`` or ``--quiet``). Both ``--build-option`` and ``--global-option`` are supported as a **transitional** effort (a.k.a. "escape hatch"). In the future a proper list of allowed ``config_settings`` may be created. Breaking Changes ---------------- * 3265: Added implementation for *editable install* hooks (PEP 660). By default the users will experience a *lenient* behavior which prioritises the ability of the users of changing the distributed packages (e.g. adding new files or removing old ones). But they can also opt into a *strict* mode, which will try to replicate as much as possible the behavior of the package as if it would be normally installed by end users. The *strict* editable installation is not able to detect if files are added or removed from the project (a new installation is required). This implementation might also affect plugins and customizations that assume certain ``build`` subcommands don't run during editable installs or that they always copy files to the temporary build directory. .. important:: The *editable* aspect of the *editable install* supported this implementation is restricted to the Python modules contained in the distributed package. Changes in binary extensions (e.g. C/C++), entry-point definitions, dependencies, metadata, datafiles, etc may require a new installation. Changes ------- * 3380: Improved the handling of the ``config_settings`` parameter in both PEP 517 and PEP 660 interfaces: - It is possible now to pass both ``--global-option`` and ``--build-option``. As discussed in 1928, arbitrary arguments passed via ``--global-option`` should be placed before the name of the setuptools' internal command, while ``--build-option`` should come after. - Users can pass ``editable-mode=strict`` to select a strict behaviour for the editable installation. * 3392: Exposed ``get_output_mapping()`` from ``build_py`` and ``build_ext`` subcommands. This interface is reserved for the use of ``setuptools`` Extensions and third part packages are explicitly disallowed to calling it. However, any implementation overwriting ``build_py`` or ``build_ext`` are required to honour this interface. * 3412: Added ability of collecting source files from custom build sub-commands to ``sdist``. This allows plugins and customization scripts to automatically add required source files in the source distribution. * 3414: Users can *temporarily* specify an environment variable ``SETUPTOOLS_ENABLE_FEATURES=legacy-editable`` as a escape hatch for the :pep:`660` behavior. This setting is **transitional** and may be removed in the future. * 3484: Added *transient* ``compat`` mode to editable installs. This more will be temporarily available (to facilitate the transition period) for those that want to emulate the behavior of the ``develop`` command (in terms of what is added to ``sys.path``). This mode is provided "as is", with limited support, and will be removed in future versions of ``setuptools``. Documentation changes --------------------- * 3414: Updated :doc:`Development Mode </userguide/development_mode>` to reflect on the implementation of :pep:`660`. ``` ### 63.4.3 ``` ======= Misc ---- * 3496: Update to pypa/distutilsb65aa40 including more robust support for library/include dir handling in msvccompiler (pypa/distutils153) and test suite improvements. ``` ### 63.4.2 ``` ======= Misc ---- * 3453: Bump vendored version of :pypi:`pyparsing` to 3.0.9. * 3481: Add warning for potential ``install_requires`` and ``extras_require`` misconfiguration in ``setup.cfg`` * 3487: Modified ``pyproject.toml`` validation exception handling to make relevant debugging information easier to spot. ``` ### 63.4.1 ``` ======= Misc ---- * 3482: Sync with pypa/distutils274758f1c02048d295efdbc13d2f88d9923547f8, restoring compatibility shim in bdist.format_commands. ``` ### 63.4.0 ``` ======= Changes ------- * 2971: ``upload_docs`` command is deprecated once again. Documentation changes --------------------- * 3443: Installed ``sphinx-hoverxref`` extension to show tooltips on internal an external references. -- by :user:`humitos` * 3444: Installed ``sphinx-notfound-page`` extension to generate nice 404 pages. -- by :user:`humitos` Misc ---- * 3480: Merge with pypa/distutilsc397f4c ``` ### 63.3.0 ``` ======= Changes ------- * 3475: Merge with pypa/distutils129480b, including substantial delinting and cleanup, some refactoring around compiler logic, better messaging in cygwincompiler (pypa/distutils161). ``` ### 63.2.0 ``` ======= Changes ------- * 3395: Included a performance optimization: ``setuptools.build_meta`` no longer tries to :func:`compile` the setup script code before :func:`exec`-ing it. Misc ---- * 3435: Corrected issue in macOS framework builds on Python 3.9 not installed by homebrew (pypa/distutils158). ``` ### 63.1.0 ``` ======= 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). ``` ### 63.0.0 ``` ======= 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` ``` ### 62.6.0 ``` ======= 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` ``` ### 62.5.0 ``` ======= 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. ``` ### 62.4.0 ``` ======= 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). ``` ### 62.3.4 ``` ======= 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. ``` ### 62.3.3 ``` ======= Documentation changes --------------------- * 3331: Replaced single backticks with double ones in ``CHANGES.rst`` -- by :user:`codeandfire` * 3332: Fixed grammar/typos, modified example directory trees for src-layout and flat-layout -- by :user:`codeandfire` * 3335: Changes to code snippets and other examples in the Data Files page of the User Guide -- by :user:`codeandfire` Misc ---- * 3336: Modified ``test_setup_install_includes_dependencies`` to work with custom ``PYTHONPATH`` –- by :user:`hroncok` ``` ### 62.3.2 ``` ======= Misc ---- * 3328: Include a first line summary to some of the existing multi-line warnings. ``` ### 62.3.1 ``` ======= Misc ---- * 3320: Fixed typo which causes ``namespace_packages`` to raise an error instead of warning. ``` ### 62.3.0 ``` ======= Deprecations ------------ * 3262: Formally added deprecation messages for ``namespace_packages``. The methodology that uses ``pkg_resources`` and ``namespace_packages`` for creating namespaces was already discouraged by the :doc:`setuptools docs </userguide/package_discovery>` and the :doc:`Python Packaging User Guide <PyPUG:guides/packaging-namespace-packages>`, therefore this change just make the deprecation more official. Users can consider migrating to native/implicit namespaces (as introduced in :pep:`420`). * 3308: Relying on ``include_package_data`` to ensure sub-packages are automatically added to the build wheel distribution (as "data") is now considered a deprecated practice. This behaviour was controversial and caused inconsistencies (3260). Instead, projects are encouraged to properly configure ``packages`` or use discovery tools. General information can be found in :doc:`userguide/package_discovery`. Changes ------- * 1806: Allowed recursive globs (``**``) in ``package_data``. -- by :user:`nullableVoidPtr` * 3206: Fixed behaviour when both ``install_requires`` (in ``setup.py``) and ``dependencies`` (in ``pyproject.toml``) are specified. The configuration in ``pyproject.toml`` will take precedence over ``setup.py`` (in accordance with PEP 621). A warning was added to inform users. Documentation changes --------------------- * 3307: Added introduction to references/keywords. Added deprecation tags to test kwargs. Moved userguide/keywords to deprecated section. Clarified in deprecated doc what keywords came from distutils and which were added or changed by setuptools. Misc ---- * 3274: Updated version of vendored ``pyparsing`` to 3.0.8 to avoid problems with upcoming deprecation in Python 3.11. * 3292: Added warning about incompatibility with old versions of ``importlib-metadata``. ``` ### 62.2.0 ``` ======= Changes ------- * 3299: Optional metadata fields are now truly optional. Includes merge with pypa/distutilsa7cfb56 per pypa/distutils138. Misc ---- * 3282: Added CI cache for ``setup.cfg`` examples used when testing ``setuptools.config``. ``` ### 62.1.0 ``` ======= Changes ------- * 3258: Merge pypa/distutils5229dad46b. Misc ---- * 3249: Simplified ``package_dir`` obtained via auto-discovery. ``` ### 62.0.0 ``` ======= Breaking Changes ---------------- * 3151: Made ``setup.py develop --user`` install to the user site packages directory even if it is disabled in the current interpreter. Changes ------- * 3153: When resolving requirements use both canonical and normalized names -- by :user:`ldaniluk` * 3167: Honor unix file mode in ZipFile when installing wheel via ``install_as_egg`` -- by :user:`delijati` Misc ---- * 3088: Fixed duplicated tag with the ``dist-info`` command. * 3247: Fixed problem preventing ``readme`` specified as dynamic in ``pyproject.toml`` from being dynamically specified in ``setup.py``. ``` ### 61.3.1 ``` ======= Misc ---- * 3233: Included missing test file ``setupcfg_examples.txt`` in ``sdist``. * 3233: Added script that allows developers to download ``setupcfg_examples.txt`` prior to running tests. By caching these files it should be possible to run the test suite offline. ``` ### 61.3.0 ``` ======= Changes ------- * 3229: Disabled automatic download of ``trove-classifiers`` to facilitate reproducibility. Misc ---- * 3229: Updated ``pyproject.toml`` validation via ``validate-pyproject`` v0.7.1. * 3229: New internal tool made available for updating the code responsible for the validation of ``pyproject.toml``. This tool can be executed via ``tox -e generate-validation-code``. ``` ### 61.2.0 ``` ======= Changes ------- * 3215: Ignored a subgroup of invalid ``pyproject.toml`` files that use the ``[project]`` table to specify only ``requires-python`` (**transitional**). .. warning:: Please note that future releases of setuptools will halt the build process if a ``pyproject.toml`` file that does not match doc:`the PyPA Specification <PyPUG:specifications/section-distribution-metadata>` is given. * 3215: Updated ``pyproject.toml`` validation, as generated by ``validate-pyproject==0.6.1``. * 3218: Prevented builds from erroring if the project specifies metadata via ``pyproject.toml``, but uses other files (e.g. ``setup.py``) to complement it, without setting ``dynamic`` properly. .. important:: This is a **transitional** behaviour. Future releases of ``setuptools`` may simply ignore externally set metadata not backed by ``dynamic`` or even halt the build with an error. * 3224: Merge changes from pypa/distutilse1d5c9b1f6 Documentation changes --------------------- * 3217: Fixed typo in ``pyproject.toml`` example in Quickstart -- by :user:`pablo-cardenas`. Misc ---- * 3223: Fixed missing requirements with environment markers when ``optional-dependencies`` is set in ``pyproject.toml``. ``` ### 61.1.1 ``` ======= Misc ---- * 3212: Fixed missing dependencies when running ``setup.py install``. Note that calling ``setup.py install`` directly is still deprecated and will be removed in future versions of ``setuptools``. Please check the release notes for :ref:`setup_install_deprecation_note`. ``` ### 61.1.0 ``` ======= Deprecations ------------ * 3206: Changed ``setuptools.convert_path`` to an internal function that is not exposed as part of setuptools API. Future releases of ``setuptools`` are likely to remove this function. Changes ------- * 3202: Changed behaviour of auto-discovery to not explicitly expand ``package_dir`` for flat-layouts and to not use relative paths starting with ``./``. * 3203: Prevented ``pyproject.toml`` parsing from overwriting ``dist.include_package_data`` explicitly set in ``setup.py`` with default value. * 3208: Added a warning for non existing files listed with the ``file`` directive in ``setup.cfg`` and ``pyproject.toml``. * 3208: Added a default value for dynamic ``classifiers`` in ``pyproject.toml`` when files are missing and errors being ignored. * 3211: Disabled auto-discovery when distribution class has a ``configuration`` attribute (e.g. when the ``setup.py`` script contains ``setup(..., configuration=...)``). This is done to ensure extension-only packages created with ``numpy.distutils.misc_util.Configuration`` are not broken by the safe guard behaviour to avoid accidental multiple top-level packages in a flat-layout. .. note:: Users that don't set ``packages``, ``py_modules``, or ``configuration`` are still likely to observe the auto-discovery behavior, which may halt the build if the project contains multiple directories and/or multiple Python files directly under the project root. To disable auto-discovery please explicitly set either ``packages`` or ``py_modules``. Alternatively you can also configure :ref:`custom-discovery`. ``` ### 61.0.0 ``` ======= Deprecations ------------ * 3068: Deprecated ``setuptools.config.read_configuration``, ``setuptools.config.parse_configuration`` and other functions or classes from ``setuptools.config``. Users that still need to parse and process configuration from ``setup.cfg`` can import a direct replacement from ``setuptools.config.setupcfg``, however this module is transitional and might be removed in the future (the ``setup.cfg`` configuration format itself is likely to be deprecated in the future). Breaking Changes ---------------- * 2894: If you purposefully want to create an *"empty distribution"*, please be aware that some Python files (or general folders) might be automatically detected and included. Projects that currently don't specify both ``packages`` and ``py_modules`` in their configuration and contain extra folders or Python files (not meant for distribution), might see these files being included in the wheel archive or even experience the build to fail. You can check details about the automatic discovery (and how to configure a different behaviour) in :doc:`/userguide/package_discovery`. * 3067: If the file ``pyproject.toml`` exists and it includes project metadata/config (via ``[project]`` table or ``[tool.setuptools]``), a series of new behaviors that are not backward compatible may take place: - The default value of ``include_package_data`` will be considered to be ``True``. - Setuptools will attempt to validate the ``pyproject.toml`` file according to PEP 621 specification. - The values specified in ``pyproject.toml`` will take precedence over those specified in ``setup.cfg`` or ``setup.py``. Changes ------- * 2887: **[EXPERIMENTAL]** Added automatic discovery for ``py_modules`` and ``packages`` -- by :user:`abravalheri`. Setuptools will try to find these values assuming that the package uses either the *src-layout* (a ``src`` directory containing all the packages or modules), the *flat-layout* (package directories directly under the project root), or the *single-module* approach (an isolated Python file, directly under the project root). The automatic discovery will also respect layouts that are explicitly configured using the ``package_dir`` option. For backward-compatibility, this behavior will be observed **only if both** ``py_modules`` **and** ``packages`` **are not set**. (**Note**: specifying ``ext_modules`` might also prevent auto-discover from taking place) If setuptools detects modules or packages that are not supposed to be in the distribution, please manually set ``py_modules`` and ``packages`` in your ``setup.cfg`` or ``setup.py`` file. If you are using a *flat-layout*, you can also consider switching to *src-layout*. * 2887: **[EXPERIMENTAL]** Added automatic configuration for the ``name`` metadata -- by :user:`abravalheri`. Setuptools will adopt the name of the top-level package (or module in the case of single-module distributions), **only when** ``name`` **is not explicitly provided**. Please note that it is not possible to automatically derive a single name when the distribution consists of multiple top-level packages or modules. * 3066: Added vendored dependencies for :pypi:`tomli`, :pypi:`validate-pyproject`. These dependencies are used to read ``pyproject.toml`` files and validate them. * 3067: **[EXPERIMENTAL]** When using ``pyproject.toml`` metadata, the default value of ``include_package_data`` is changed to ``True``. * 3068: **[EXPERIMENTAL]** Add support for ``pyproject.toml`` configuration (as introduced by :pep:`621`). Configuration parameters not covered by standards are handled in the ``[tool.setuptools]`` sub-table. In the future, existing ``setup.cfg`` configuration may be automatically converted into the ``pyproject.toml`` equivalent before taking effect (as proposed in 1688). Meanwhile users can use automated tools like :pypi:`ini2toml` to help in the transition. Please note that the legacy backend is not guaranteed to work with ``pyproject.toml`` configuration. -- by :user:`abravalheri` * 3125: Implicit namespaces (as introduced in :pep:`420`) are now considered by default during :doc:`package discovery </userguide/package_discovery>`, when ``setuptools`` configuration and project metadata are added to the ``pyproject.toml`` file. To disable this behaviour, use ``namespaces = False`` when explicitly setting the ``[tool.setuptools.packages.find]`` section in ``pyproject.toml``. This change is backwards compatible and does not affect the behaviour of configuration done in ``setup.cfg`` or ``setup.py``. * 3152: **[EXPERIMENTAL]** Added support for ``attr:`` and ``cmdclass`` configurations in ``setup.cfg`` and ``pyproject.toml`` when ``package_dir`` is implicitly found via auto-discovery. * 3178: Postponed importing ``ctypes`` when hiding files on Windows. This helps to prevent errors in systems that might not have ``libffi`` installed. * 3179: Merge with pypa/distutils267dbd25ac Documentation changes --------------------- * 3172: Added initial documentation about configuring ``setuptools`` via ``pyproject.toml`` (using standard project metadata). Misc ---- * 3065: Refactored ``setuptools.config`` by separating configuration parsing (specific to the configuration file format, e.g. ``setup.cfg``) and post-processing (which includes directives such as ``file:`` that can be used across different configuration formats). ``` ### 60.10.0 ``` ======== Changes ------- * 2971: Deprecated upload_docs command, to be removed in the future. * 3137: Use samefile from stdlib, supported on Windows since Python 3.2. * 3170: Adopt nspektr (vendored) to implement Distribution._install_dependencies. Documentation changes --------------------- * 3144: Added documentation on using console_scripts from setup.py, which was previously only shown in setup.cfg -- by :user:`xhlulu` * 3148: Added clarifications about ``MANIFEST.in``, that include links to PyPUG docs and more prominent mentions to using a revision control system plugin as an alternative. * 3148: Removed mention to ``pkg_resources`` as the recommended way of accessing data files, in favour of importlib.resources. Additionally more emphasis was put on the fact that *package data files* reside **inside** the *package directory* (and therefore should be *read-only*). Misc ---- * 3120: Added workaround for intermittent failures of backend tests on PyPy. These tests now are marked with `XFAIL <https://docs.pytest.org/en/stable/how-to/skipping.html>`_, instead of erroring out directly. * 3124: Improved configuration for :pypi:`rst-linker` (extension used to build the changelog). * 3133: Enhanced isolation of tests using virtual environments - PYTHONPATH is not leaking to spawned subprocesses -- by :user:`befeleme` * 3147: Added options to provide a pre-built ``setuptools`` wheel or sdist for being used during tests with virtual environments. Paths for these pre-built distribution files can now be set via the environment variables: ``PRE_BUILT_SETUPTOOLS_SDIST`` and ``PRE_BUILT_SETUPTOOLS_WHEEL``. ``` ### 60.9.3 ``` ======= Misc ---- * 3093: Repaired automated release process. ``` ### 60.9.2 ``` ======= Misc ---- * 3035: When loading distutils from the vendored copy, rewrite ``__name__`` to ensure consistent importing from inside and out. ``` ### 60.9.1 ``` ======= Misc ---- * 3102: Prevent vendored importlib_metadata from loading distributions from older importlib_metadata. * 3103: Fixed issue where string-based entry points would be omitted. * 3107: Bump importlib_metadata to 4.11.1 addressing issue with parsing requirements in egg-info as found in PyPy. ``` ### 60.9.0 ``` ======= Changes ------- * 2876: In the build backend, allow single config settings to be supplied. * 2993: Removed workaround in distutils hack for get-pip now that pypa/get-pip137 is closed. * 3085: Setuptools no longer relies on ``pkg_resources`` for entry point handling. * 3098: Bump vendored packaging to 21.3. * Removed bootstrap script. .. warning:: Users trying to install the unmaintained :pypi:`pathlib` backport from PyPI/``sdist``/source code may find problems when using ``setuptools >= 60.9.0``. This happens because during the installation, the unmaintained implementation of ``pathlib`` is loaded and may cause compatibility problems (it does not expose the same public API defined in the Python standard library). Whenever possible users should avoid declaring ``pathlib`` as a dependency. An alternative is to pre-build a wheel for ``pathlib`` using a separated virtual environment with an older version of setuptools and install the library directly from the pre-built wheel. ``` ### 60.8.2 ``` ======= Misc ---- * 3091: Make ``concurrent.futures`` import lazy in vendored ``more_itertools`` package to a avoid importing threading as a side effect (which caused `gevent/gevent1865 <https://github.com/gevent/gevent/issues/1865>`__). -- by :user:`maciejp-ro` ``` ### 60.8.1 ``` ======= Misc ---- * 3084: When vendoring jaraco packages, ensure the namespace package is converted to a simple package to support zip importer. ``` ### 60.8.0 ``` ======= Changes ------- * 3085: Setuptools now vendors importlib_resources and importlib_metadata and jaraco.text. Setuptools no longer relies on pkg_resources for ensure_directory nor parse_requirements. ``` ### 60.7.1 ``` ======= Misc ---- * 3072: Remove lorem_ipsum from jaraco.text when vendored. ``` ### 60.7.0 ``` ======= Changes ------- * 3061: Vendored jaraco.text and use line processing from that library in pkg_resources. Misc ---- * 3070: Avoid AttributeError in easy_install.create_home_path when sysconfig.get_config_vars values are not strings. ``` ### 60.6.0 ``` ======= Changes ------- * 3043: Merge with pypa/distutilsbb018f1ac3 including consolidated behavior in sysconfig.get_platform (pypa/distutils104). * 3057: Don't include optional ``Home-page`` in metadata if no ``url`` is specified. -- by :user:`cdce8p` * 3062: Merge with pypa/distutilsb53a824ec3 including improved support for lib directories on non-x64 Windows builds. Documentation changes --------------------- * 2897: Added documentation about wrapping ``setuptools.build_meta`` in a in-tree custom backend. This is a :pep:`517`-compliant way of dynamically specifying build dependencies (e.g. when platform, OS and other markers are not enough). -- by :user:`abravalheri` * 3034: Replaced occurrences of the defunct distutils-sig mailing list with pointers to GitHub Discussions. -- by :user:`ashemedai` * 3056: The documentation has stopped suggesting to add ``wheel`` to :pep:`517` requirements -- by :user:`webknjaz` Misc ---- * 3054: Used Py3 syntax ``super().__init__()`` -- by :user:`imba-tjd` ``` ### 60.5.4 ``` ======= Misc ---- * 3009: Remove filtering of distutils warnings. * 3031: Suppress distutils replacement when building or testing CPython. ``` ##