blob: 1f72a25542494abd0861372e9f2aa9b098bda893 [file] [log] [blame]
Georg Brandl116aa622007-08-15 14:28:22 +00001.. _distutils-index:
2
Larry Hastings3732ed22014-03-15 21:13:56 -07003##############################################
4 Distributing Python Modules (Legacy version)
5##############################################
Georg Brandl116aa622007-08-15 14:28:22 +00006
7:Authors: Greg Ward, Anthony Baxter
8:Email: distutils-sig@python.org
Georg Brandl116aa622007-08-15 14:28:22 +00009
Ned Deily8f5798e2016-06-05 17:38:48 -070010.. seealso::
11
12 :ref:`distributing-index`
13 The up to date module distribution documentations
14
Nick Coghlandae12292019-05-14 22:04:30 +100015.. include:: ./_setuptools_disclaimer.rst
Georg Brandl116aa622007-08-15 14:28:22 +000016
Nick Coghlanb5c4fd02013-12-10 21:24:55 +100017.. note::
18
19 This guide only covers the basic tools for building and distributing
Benjamin Petersonc2f01212015-11-03 22:42:02 -080020 extensions that are provided as part of this version of Python. Third party
21 tools offer easier to use and more secure alternatives. Refer to the `quick
Sanyam Khurana338cd832018-01-20 05:55:37 +053022 recommendations section <https://packaging.python.org/guides/tool-recommendations/>`__
Nick Coghlanb5c4fd02013-12-10 21:24:55 +100023 in the Python Packaging User Guide for more information.
24
Nick Coghlandae12292019-05-14 22:04:30 +100025This document describes the Python Distribution Utilities ("Distutils") from
26the module developer's point of view, describing the underlying capabilities
27that ``setuptools`` builds on to allow Python developers to make Python modules
28and extensions readily available to a wider audience.
29
Georg Brandl116aa622007-08-15 14:28:22 +000030.. toctree::
31 :maxdepth: 2
Benjamin Peterson5879d412009-03-30 14:51:56 +000032 :numbered:
Georg Brandl116aa622007-08-15 14:28:22 +000033
34 introduction.rst
35 setupscript.rst
36 configfile.rst
37 sourcedist.rst
38 builtdist.rst
Georg Brandl116aa622007-08-15 14:28:22 +000039 examples.rst
40 extending.rst
41 commandref.rst
42 apiref.rst