1.. _distutils-index:
2
3##############################################
4  Distributing Python Modules (Legacy version)
5##############################################
6
7:Authors: Greg Ward, Anthony Baxter
8:Email: [email protected]
9
10.. seealso::
11
12   :ref:`distributing-index`
13      The up to date module distribution documentations
14
15.. note::
16
17   The entire ``distutils`` package has been deprecated and will be
18   removed in Python 3.12. This documentation is retained as a
19   reference only, and will be removed with the package. See the
20   :ref:`What's New <distutils-deprecated>` entry for more information.
21
22.. include:: ./_setuptools_disclaimer.rst
23
24.. note::
25
26   This guide only covers the basic tools for building and distributing
27   extensions that are provided as part of this version of Python. Third party
28   tools offer easier to use and more secure alternatives. Refer to the `quick
29   recommendations section <https://packaging.python.org/guides/tool-recommendations/>`__
30   in the Python Packaging User Guide for more information.
31
32This document describes the Python Distribution Utilities ("Distutils") from
33the module developer's point of view, describing the underlying capabilities
34that ``setuptools`` builds on to allow Python developers to make Python modules
35and extensions readily available to a wider audience.
36
37.. toctree::
38   :maxdepth: 2
39   :numbered:
40
41   introduction.rst
42   setupscript.rst
43   configfile.rst
44   sourcedist.rst
45   builtdist.rst
46   examples.rst
47   extending.rst
48   commandref.rst
49   apiref.rst
50