?HAMA

Edit File Size: 2.38 KB

//opt/alt/python312/share/doc/alt-python312-setuptools/docs/deprecated/distutils-legacy.rst

Text Base64

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 60.0.0 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 environment variable:

SETUPTOOLS_USE_DISTUTILS=stdlib

.. warning::
   Please note that this also affects how ``distutils.cfg`` files inside stdlib's ``distutils``
   package directory are processed.
   Unless ``SETUPTOOLS_USE_DISTUTILS=stdlib``, they will have no effect on the build process.

You can still use a global user config file, ``~/.pydistutils.cfg`` (POSIX) or ``%USERPROFILE%/pydistutils.cfg`` (Windows),
   or use the environment variable :ref:`DIST_EXTRA_CONFIG <setup-config>` to point to another
   supplementary configuration file.

Prefer Setuptools
-----------------

As Distutils is deprecated, any usage of functions or objects from distutils is similarly discouraged, and Setuptools aims to replace or deprecate all such uses. This section describes the recommended replacements.

``distutils.core.setup`` → ``setuptools.setup``

``distutils.cmd.Command`` or ``distutils.core.Command`` → ``setuptools.Command``

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

``distutils.dep_util`` → ``setuptools.modified``

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

``distutils.version.*`` → :doc:`packaging.version.* <packaging:version>`

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

Migration advice is also provided by :pep:`PEP 632 <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.

.. [#errors] Please notice errors related to the command line usage of
   ``setup.py``, such as ``DistutilsArgError``, are intentionally not exposed
   by setuptools, since this is considered a deprecated practice.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
distutils DIR	-	drwxr-xr-x	2026-02-10 08:06:45	Edit Download recursive recursive
changed_keywords.rst	2.13 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
commands.rst	28.98 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
dependency_links.rst	2.79 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
distutils-legacy.rst	2.38 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
easy_install.rst	50.79 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
functionalities.rst	1.42 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
index.rst	863 B	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
python_eggs.rst	30.22 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
resource_extraction.rst	2.98 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive
zip_safe.rst	3.56 KB	lrw-r--r--	2023-11-21 19:00:33	Edit Download recursive recursive

Directory Contents