Update setuptools to 69.5.1

[pyup-bot]

This PR updates setuptools from 65.5.0 to 69.5.1.

Changelog

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 (27489545)

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. (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`

Links

• PyPI: https://pypi.org/project/setuptools
• Changelog: https://data.safetycli.com/changelogs/setuptools/
• Repo: https://github.com/pypa/setuptools