blob: 53a69aecd7c40c2d6568336327f4cd068a13bcf3 [file] [log] [blame]
Georg Brandl116aa622007-08-15 14:28:22 +00001:mod:`distutils` --- Building and installing Python modules
2===========================================================
3
4.. module:: distutils
Georg Brandl71515ca2009-05-17 12:29:12 +00005 :synopsis: Support for building and installing Python modules into an
6 existing Python installation.
Georg Brandl116aa622007-08-15 14:28:22 +00007.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
8
9
10The :mod:`distutils` package provides support for building and installing
11additional modules into a Python installation. The new modules may be either
12100%-pure Python, or may be extension modules written in C, or may be
13collections of Python packages which include modules coded in both Python and C.
14
Éric Araujo55729fe2011-06-02 15:45:25 +020015.. deprecated:: 3.3
16 :mod:`packaging` replaces Distutils. See :ref:`packaging-index` and
17 :ref:`packaging-install-index`.
Georg Brandl116aa622007-08-15 14:28:22 +000018
19
Éric Araujo55729fe2011-06-02 15:45:25 +020020User documentation and API reference are provided in another document:
21
Georg Brandl116aa622007-08-15 14:28:22 +000022.. seealso::
23
24 :ref:`distutils-index`
Georg Brandl71515ca2009-05-17 12:29:12 +000025 The manual for developers and packagers of Python modules. This describes
26 how to prepare :mod:`distutils`\ -based packages so that they may be
Éric Araujo55729fe2011-06-02 15:45:25 +020027 easily installed into an existing Python installation. If also contains
28 instructions for end-users wanting to install a distutils-based package,
29 :ref:`install-index`.
Georg Brandl116aa622007-08-15 14:28:22 +000030
Georg Brandl116aa622007-08-15 14:28:22 +000031
Éric Araujo55729fe2011-06-02 15:45:25 +020032.. trick to silence a Sphinx warning
Éric Araujo3a9f58f2011-06-01 20:42:49 +020033
34.. toctree::
35 :hidden:
36
37 ../distutils/index