分发 Python 模块（遗留版本）
****************************

作者:
   Greg Ward ， Anthony Baxter

电子邮箱:
   distutils-sig@python.org

参见:

  分发 Python 模块
     最新的模块分发文档

本文档从模块开发人员的角度描述了 Python Distribution Utilities（
“Distutils” ，描述了如何使用 Distutils 轻松地为更广泛的受众提供 Python
模块和扩展，而构建/发布/安装机制的开销很小。

注解:

  This guide only covers the basic tools for building and distributing
  extensions that are provided as part of this version of Python.
  Third party tools offer easier to use and more secure alternatives.
  Refer to the quick recommendations section in the Python Packaging
  User Guide for more information.

* 1. Distutils 模块介绍

  * 1.1. 概念和术语

  * 1.2. 一个简单的例子

  * 1.3. 通用的 Python 术语

  * 1.4. Distutils 特定的术语

* 2. 编写安装脚本

  * 2.1. Listing whole packages

  * 2.2. Listing individual modules

  * 2.3. Describing extension modules

  * 2.4. Relationships between Distributions and Packages

  * 2.5. Installing Scripts

  * 2.6. Installing Package Data

  * 2.7. Installing Additional Files

  * 2.8. Additional meta-data

  * 2.9. Debugging the setup script

* 3. 编写设置脚本的配置文件

* 4. Creating a Source Distribution

  * 4.1. Specifying the files to distribute

  * 4.2. Manifest-related options

* 5. Creating Built Distributions

  * 5.1. 创建RPM软件包

  * 5.2. Creating Windows Installers

  * 5.3. Cross-compiling on Windows

  * 5.4. Vista User Access Control (UAC)

* 6. Python 包索引（PyPI）

  * 6.1. PyPI overview

  * 6.2. Distutils commands

  * 6.3. PyPI package display

* 7. 例子

  * 7.1. 纯 Python 分发（通过 module）

  * 7.2. 纯 Python 分发（通过 包）

  * 7.3. 单个扩展模块

  * 7.4. 检查一个包

  * 7.5. 读取元数据

* 8. 扩展 Distutils

  * 8.1. 集成新的命令

  * 8.2. 添加新的发布类型

* 9. 命令参考

  * 9.1. 安装模块: **install** 命令族

  * 9.2. 创建源码发行包: **sdist** 命令

* 10. API参考引用

  * 10.1. "distutils.core" --- 分发包功能的核心

  * 10.2. "distutils.ccompiler" --- CCompiler基类

  * 10.3. "distutils.unixccompiler" --- Unix C Compiler

  * 10.4. "distutils.msvccompiler" --- Microsoft Compiler

  * 10.5. "distutils.bcppcompiler" --- Borland Compiler

  * 10.6. "distutils.cygwincompiler" --- Cygwin Compiler

  * 10.7. "distutils.archive_util" ---  Archiving utilities

  * 10.8. "distutils.dep_util" --- Dependency checking

  * 10.9. "distutils.dir_util" --- Directory tree operations

  * 10.10. "distutils.file_util" --- Single file operations

  * 10.11. "distutils.util" --- Miscellaneous other utility functions

  * 10.12. "distutils.dist" --- The Distribution class

  * 10.13. "distutils.extension" --- The Extension class

  * 10.14. "distutils.debug" --- Distutils debug mode

  * 10.15. "distutils.errors" --- Distutils exceptions

  * 10.16. "distutils.fancy_getopt" --- Wrapper around the standard
    getopt module

  * 10.17. "distutils.filelist" --- The FileList class

  * 10.18. "distutils.log" --- Simple PEP 282-style logging

  * 10.19. "distutils.spawn" --- Spawn a sub-process

  * 10.20. "distutils.sysconfig" --- System configuration information

  * 10.21. "distutils.text_file" --- The TextFile class

  * 10.22. "distutils.version" --- Version number classes

  * 10.23. "distutils.cmd" --- Abstract base class for Distutils
    commands

  * 10.24. Creating a new Distutils command

  * 10.25. "distutils.command" --- Individual Distutils commands

  * 10.26. "distutils.command.bdist" --- Build a binary installer

  * 10.27. "distutils.command.bdist_packager" --- Abstract base class
    for packagers

  * 10.28. "distutils.command.bdist_dumb" --- Build a "dumb" installer

  * 10.29. "distutils.command.bdist_msi" --- Build a Microsoft
    Installer binary package

  * 10.30. "distutils.command.bdist_rpm" --- Build a binary
    distribution as a Redhat RPM and SRPM

  * 10.31. "distutils.command.bdist_wininst" --- Build a Windows
    installer

  * 10.32. "distutils.command.sdist" --- Build a source distribution

  * 10.33. "distutils.command.build" --- Build all files of a package

  * 10.34. "distutils.command.build_clib" --- Build any C libraries in
    a package

  * 10.35. "distutils.command.build_ext" --- Build any extensions in a
    package

  * 10.36. "distutils.command.build_py" --- Build the .py/.pyc files
    of a package

  * 10.37. "distutils.command.build_scripts" --- Build the scripts of
    a package

  * 10.38. "distutils.command.clean" --- Clean a package build area

  * 10.39. "distutils.command.config" --- Perform package
    configuration

  * 10.40. "distutils.command.install" --- Install a package

  * 10.41. "distutils.command.install_data" --- Install data files
    from a package

  * 10.42. "distutils.command.install_headers" --- Install C/C++
    header files from a package

  * 10.43. "distutils.command.install_lib" --- Install library files
    from a package

  * 10.44. "distutils.command.install_scripts" --- Install script
    files from a package

  * 10.45. "distutils.command.register" --- Register a module with the
    Python Package Index

  * 10.46. "distutils.command.check" --- Check the meta-data of a
    package
