| Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 1 | :mod:`distutils` --- Building and installing Python modules |
| 2 | =========================================================== |
| 3 | |
| 4 | .. module:: distutils |
| Georg Brandl | 71515ca | 2009-05-17 12:29:12 +0000 | [diff] [blame] | 5 | :synopsis: Support for building and installing Python modules into an |
| 6 | existing Python installation. |
| Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 7 | .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> |
| 8 | |
| 9 | |
| 10 | The :mod:`distutils` package provides support for building and installing |
| 11 | additional modules into a Python installation. The new modules may be either |
| 12 | 100%-pure Python, or may be extension modules written in C, or may be |
| 13 | collections of Python packages which include modules coded in both Python and C. |
| 14 | |
| Larry Hastings | 3732ed2 | 2014-03-15 21:13:56 -0700 | [diff] [blame] | 15 | Most Python users will *not* want to use this module directly, but instead |
| 16 | use the cross-version tools maintained by the Python Packaging Authority. |
| 17 | Refer to the `Python Packaging User Guide <http://packaging.python.org>`_ |
| 18 | for more information. |
| Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 19 | |
| Larry Hastings | 3732ed2 | 2014-03-15 21:13:56 -0700 | [diff] [blame] | 20 | For the benefits of packaging tool authors and users seeking a deeper |
| 21 | understanding of the details of the current packaging and distribution |
| 22 | system, the legacy :mod:`distutils` based user documentation and API |
| 23 | reference remain available: |
| Éric Araujo | 55729fe | 2011-06-02 15:45:25 +0200 | [diff] [blame] | 24 | |
| Larry Hastings | 3732ed2 | 2014-03-15 21:13:56 -0700 | [diff] [blame] | 25 | * :ref:`install-index` |
| 26 | * :ref:`distutils-index` |