27.1. distutils —构建和安装 Python 模块

distutils软件包提供了将其他模块构建和安装到 Python 安装中的支持。新模块可以是 100%纯的 Python,也可以是用 C 编写的扩展模块,也可以是 Python 软件包的集合,其中包括以 Python 和 C 编码的模块。

大多数 Python 用户不会希望直接使用此模块,而是使用 Python 包装规范维护的跨版本工具。特别是setuptoolsdistutils的增强替代方案,它提供:

  • 支持语句项目依赖项

  • 用于配置要包含在源版本中的文件的其他机制(包括用于与版本控制系统集成的插件)

  • 语句项目“入口点”的能力,可以用作应用程序插件系统的基础

  • 在安装时自动生成 Windows 命令行可执行文件的能力,而无需预先构建它们

  • 所有受支持的 Python 版本之间的行为一致

推荐的pip安装程序使用setuptools运行所有setup.py脚本,即使脚本本身仅导入distutils。有关更多信息,请参考Python 打包用户指南

为了使打包工具的作者和用户寻求对当前打包和分发系统的详细信息的深入了解,仍然可以使用基于distutils的旧版用户文档和 API 参考: