Skip to content

Commit

Permalink
[Docs] Improve documentation about migration from distutils
Browse files Browse the repository at this point in the history
  • Loading branch information
abravalheri committed Mar 13, 2022
1 parent ba25a5f commit 722e1fd
Showing 1 changed file with 6 additions and 4 deletions.
10 changes: 6 additions & 4 deletions docs/deprecated/distutils-legacy.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,10 @@ Porting from Distutils

Setuptools and the PyPA have a `stated goal <https://github.com/pypa/packaging-problems/issues/127>`_ to make Setuptools the reference API for distutils.

Since the 49.1.2 release, Setuptools includes a local, vendored copy of distutils (from late copies of CPython) that is disabled by default. To enable the use of this copy of distutils when invoking setuptools, set the enviroment variable:
Since the 49.1.2 release, Setuptools includes a local, vendored copy of distutils (from late copies of CPython) that is enabled by default. To disable the use of this copy of distutils when invoking setuptools, set the enviroment variable:

SETUPTOOLS_USE_DISTUTILS=local
SETUPTOOLS_USE_DISTUTILS=stdlib

This behavior is planned to become the default.

Prefer Setuptools
-----------------
Expand All @@ -20,12 +19,15 @@ As Distutils is deprecated, any usage of functions or objects from distutils is

``distutils.command.{build_clib,build_ext,build_py,sdist}`` → ``setuptools.command.*``

``distutils.log`` → (no replacement yet)
``distutils.log`` → :mod:`logging` (standard library)

``distutils.version.*`` → ``packaging.version.*``

``distutils.errors.*`` → ``setuptools.errors.*`` [#errors]_


Migration is also provided by :pep:`632#migration-advice`.

If a project relies on uses of ``distutils`` that do not have a suitable replacement above, please search the `Setuptools issue tracker <https://github.com/pypa/setuptools/issues/>`_ and file a request, describing the use-case so that Setuptools' maintainers can investigate. Please provide enough detail to help the maintainers understand how distutils is used, what value it provides, and why that behavior should be supported.


Expand Down

0 comments on commit 722e1fd

Please sign in to comment.