Skip to content

Commit 722e1fd

Browse files
committed
[Docs] Improve documentation about migration from distutils
1 parent ba25a5f commit 722e1fd

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

docs/deprecated/distutils-legacy.rst

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,10 @@ Porting from Distutils
33

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

6-
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:
6+
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:
77

8-
SETUPTOOLS_USE_DISTUTILS=local
8+
SETUPTOOLS_USE_DISTUTILS=stdlib
99

10-
This behavior is planned to become the default.
1110

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

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

23-
``distutils.log`` → (no replacement yet)
22+
``distutils.log`` → :mod:`logging` (standard library)
2423

2524
``distutils.version.*`` → ``packaging.version.*``
2625

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

28+
29+
Migration is also provided by :pep:`632#migration-advice`.
30+
2931
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.
3032

3133

0 commit comments

Comments
 (0)