“Python/docs/3.9/distutils/index”的版本间差异
来自菜鸟教程
Python/docs/3.9/distutils/index
（autoload） |
小 （Page commit） |
||
| 第1行： | 第1行： | ||
| + | {{DISPLAYTITLE:分发 Python 模块（旧版） — Python 文档}} | ||
<div id="distributing-python-modules-legacy-version" class="section"> | <div id="distributing-python-modules-legacy-version" class="section"> | ||
<span id="distutils-index"></span> | <span id="distutils-index"></span> | ||
| − | = | + | = 分发 Python 模块（旧版） = |
| − | ; | + | ; 作者 |
| − | : | + | : 格雷格·沃德，安东尼·巴克斯特 |
| − | ; | + | ; 电子邮件 |
: [mailto:distutils-sig%40python.org distutils-sig<span>@</span>python<span>.</span>org] | : [mailto:distutils-sig%40python.org distutils-sig<span>@</span>python<span>.</span>org] | ||
<div class="admonition seealso"> | <div class="admonition seealso"> | ||
| − | + | 也可以看看 | |
| − | ; [[../../distributing/index#distributing-index|<span class="std std-ref"> | + | ; [[../../distributing/index#distributing-index|<span class="std std-ref">分发 Python 模块</span>]] |
| − | : | + | : 最新的模块分发文档 |
| 第20行： | 第21行： | ||
<div class="admonition note"> | <div class="admonition note"> | ||
| − | + | 笔记 | |
| − | + | 本文档仅保留到 https://setuptools.readthedocs.io/en/latest/setuptools.html 上的 <code>setuptools</code> 文档独立涵盖当前包含在此处的所有相关信息之前。 | |
| − | |||
| − | |||
| 第30行： | 第29行： | ||
<div class="admonition note"> | <div class="admonition note"> | ||
| − | + | 笔记 | |
| − | + | 本指南仅涵盖作为此版本 Python 的一部分提供的用于构建和分发扩展的基本工具。 第三方工具提供更易于使用和更安全的替代方案。 有关更多信息，请参阅 Python Packaging User Guide 中的 [https://packaging.python.org/guides/tool-recommendations/ 快速建议部分] 。 | |
| − | |||
| − | |||
| − | |||
| − | |||
</div> | </div> | ||
| − | + | 本文档从模块开发人员的角度描述了 Python 分发实用程序（“Distutils”），描述了 <code>setuptools</code> 构建的基础功能，以允许 Python 开发人员使 Python 模块和扩展对更广泛的受众易于使用。 | |
| − | |||
| − | |||
| − | |||
<div class="toctree-wrapper compound"> | <div class="toctree-wrapper compound"> | ||
| − | * [[../introduction|1. | + | * [[../introduction|1. Distutils 简介]] |
| − | ** [[../introduction#concepts-terminology|1.1. | + | ** [[../introduction#concepts-terminology|1.1. 概念和术语]] |
| − | ** [[../introduction#a-simple-example|1.2. | + | ** [[../introduction#a-simple-example|1.2. 一个简单的例子]] |
| − | ** [[../introduction#general-python-terminology|1.3. | + | ** [[../introduction#general-python-terminology|1.3. 通用 Python 术语]] |
| − | ** [[../introduction#distutils-specific-terminology|1.4. Distutils | + | ** [[../introduction#distutils-specific-terminology|1.4. Distutils 特定术语]] |
| − | * [[../setupscript|2. | + | * [[../setupscript|2. 编写安装脚本]] |
| − | ** [[../setupscript#listing-whole-packages|2.1. | + | ** [[../setupscript#listing-whole-packages|2.1. 列出整个包]] |
| − | ** [[../setupscript#listing-individual-modules|2.2. | + | ** [[../setupscript#listing-individual-modules|2.2. 列出单个模块]] |
| − | ** [[../setupscript#describing-extension-modules|2.3. | + | ** [[../setupscript#describing-extension-modules|2.3. 描述扩展模块]] |
| − | ** [[../setupscript#relationships-between-distributions-and-packages|2.4. | + | ** [[../setupscript#relationships-between-distributions-and-packages|2.4. 发行版和包之间的关系]] |
| − | ** [[../setupscript#installing-scripts|2.5. | + | ** [[../setupscript#installing-scripts|2.5. 安装脚本]] |
| − | ** [[../setupscript#installing-package-data|2.6. | + | ** [[../setupscript#installing-package-data|2.6. 安装包数据]] |
| − | ** [[../setupscript#installing-additional-files|2.7. | + | ** [[../setupscript#installing-additional-files|2.7. 安装附加文件]] |
| − | ** [[../setupscript#additional-meta-data|2.8. | + | ** [[../setupscript#additional-meta-data|2.8. 附加元数据]] |
| − | ** [[../setupscript#debugging-the-setup-script|2.9. | + | ** [[../setupscript#debugging-the-setup-script|2.9. 调试安装脚本]] |
| − | * [[../configfile|3. | + | * [[../configfile|3. 编写设置配置文件]] |
| − | * [[../sourcedist|4. | + | * [[../sourcedist|4. 创建源代码分发]] |
| − | ** [[../sourcedist#specifying-the-files-to-distribute|4.1. | + | ** [[../sourcedist#specifying-the-files-to-distribute|4.1. 指定要分发的文件]] |
| − | ** [[../sourcedist#manifest-related-options|4.2. | + | ** [[../sourcedist#manifest-related-options|4.2. 清单相关选项]] |
| − | * [[../builtdist|5. | + | * [[../builtdist|5. 创建内置分布]] |
| − | ** [[../builtdist#creating-rpm-packages|5.1. | + | ** [[../builtdist#creating-rpm-packages|5.1. 创建 RPM 包]] |
| − | ** [[../builtdist#creating-windows-installers|5.2. | + | ** [[../builtdist#creating-windows-installers|5.2. 创建 Windows 安装程序]] |
| − | ** [[../builtdist#cross-compiling-on-windows|5.3. | + | ** [[../builtdist#cross-compiling-on-windows|5.3. Windows 上的交叉编译]] |
| − | ** [[../builtdist#vista-user-access-control-uac|5.4. Vista | + | ** [[../builtdist#vista-user-access-control-uac|5.4. Vista 用户访问控制 (UAC)]] |
| − | * [[../examples|6. Distutils | + | * [[../examples|6. Distutils 示例]] |
| − | ** [[../examples#pure-python-distribution-by-module|6.1. | + | ** [[../examples#pure-python-distribution-by-module|6.1. 纯 Python 发行版（按模块）]] |
| − | ** [[../examples#pure-python-distribution-by-package|6.2. | + | ** [[../examples#pure-python-distribution-by-package|6.2. 纯 Python 发行版（按包）]] |
| − | ** [[../examples#single-extension-module|6.3. | + | ** [[../examples#single-extension-module|6.3. 单扩展模块]] |
| − | ** [[../examples#checking-a-package|6.4. | + | ** [[../examples#checking-a-package|6.4. 检查包裹]] |
| − | ** [[../examples#reading-the-metadata|6.5. | + | ** [[../examples#reading-the-metadata|6.5. 读取元数据]] |
| − | * [[../extending|7. | + | * [[../extending|7. 扩展 Distutils]] |
| − | ** [[../extending#integrating-new-commands|7.1. | + | ** [[../extending#integrating-new-commands|7.1. 集成新命令]] |
| − | ** [[../extending#adding-new-distribution-types|7.2. | + | ** [[../extending#adding-new-distribution-types|7.2. 添加新的分发类型]] |
| − | * [[../commandref|8. | + | * [[../commandref|8. 命令参考]] |
| − | ** [[commandref | + | ** [[../commandref#installing-modules-the-install-command-family|8.1. 安装模块：'''install''' 命令系列]] |
| − | ** [[commandref | + | ** [[../commandref#creating-a-source-distribution-the-sdist-command|8.2. 创建源代码分发：'''sdist''' 命令]] |
| − | * [[../apiref|9. API | + | * [[../apiref|9. API 参考]] |
| − | ** [[../apiref#module-distutils|9.1. <code>distutils.core</code> | + | ** [[../apiref#module-distutils|9.1. <code>distutils.core</code> — 核心 Distutils 功能]] |
| − | ** [[../apiref#module-distutils|9.2. <code>distutils.ccompiler</code> | + | ** [[../apiref#module-distutils|9.2. <code>distutils.ccompiler</code> — CCompiler 基类]] |
| − | ** [[../apiref#module-distutils|9.3. <code>distutils.unixccompiler</code> | + | ** [[../apiref#module-distutils|9.3. <code>distutils.unixccompiler</code> — Unix C 编译器]] |
| − | ** [[../apiref#module-distutils|9.4. <code>distutils.msvccompiler</code> | + | ** [[../apiref#module-distutils|9.4. <code>distutils.msvccompiler</code> — 微软编译器]] |
| − | ** [[../apiref#module-distutils|9.5. <code>distutils.bcppcompiler</code> | + | ** [[../apiref#module-distutils|9.5. <code>distutils.bcppcompiler</code> — Borland 编译器]] |
| − | ** [[../apiref#module-distutils|9.6. <code>distutils.cygwincompiler</code> | + | ** [[../apiref#module-distutils|9.6. <code>distutils.cygwincompiler</code> — Cygwin 编译器]] |
| − | ** [[../apiref#module-distutils|9.7. <code>distutils.archive_util</code> | + | ** [[../apiref#module-distutils|9.7. <code>distutils.archive_util</code> — 归档实用程序]] |
| − | ** [[../apiref#module-distutils|9.8. <code>distutils.dep_util</code> | + | ** [[../apiref#module-distutils|9.8. <code>distutils.dep_util</code> — 依赖检查]] |
| − | ** [[../apiref#module-distutils|9.9. <code>distutils.dir_util</code> | + | ** [[../apiref#module-distutils|9.9. <code>distutils.dir_util</code> — 目录树操作]] |
| − | ** [[../apiref#module-distutils|9.10. <code>distutils.file_util</code> | + | ** [[../apiref#module-distutils|9.10. <code>distutils.file_util</code> — 单文件操作]] |
| − | ** [[../apiref#module-distutils|9.11. <code>distutils.util</code> | + | ** [[../apiref#module-distutils|9.11. <code>distutils.util</code> — 其他实用函数]] |
| − | ** [[../apiref#module-distutils|9.12. <code>distutils.dist</code> | + | ** [[../apiref#module-distutils|9.12. <code>distutils.dist</code> — 分布类]] |
| − | ** [[../apiref#module-distutils|9.13. <code>distutils.extension</code> | + | ** [[../apiref#module-distutils|9.13. <code>distutils.extension</code> — 扩展类]] |
| − | ** [[../apiref#module-distutils|9.14. <code>distutils.debug</code> | + | ** [[../apiref#module-distutils|9.14. <code>distutils.debug</code> — Distutils 调试模式]] |
| − | ** [[../apiref#module-distutils|9.15. <code>distutils.errors</code> | + | ** [[../apiref#module-distutils|9.15. <code>distutils.errors</code> — Distutils 异常]] |
| − | ** [[../apiref#module-distutils|9.16. <code>distutils.fancy_getopt</code> | + | ** [[../apiref#module-distutils|9.16. <code>distutils.fancy_getopt</code> — 标准 getopt 模块的包装器]] |
| − | ** [[../apiref#module-distutils|9.17. <code>distutils.filelist</code> | + | ** [[../apiref#module-distutils|9.17. <code>distutils.filelist</code> — FileList 类]] |
| − | ** [[../apiref#module-distutils|9.18. <code>distutils.log</code> | + | ** [[../apiref#module-distutils|9.18. <code>distutils.log</code> — 简单的 '''PEP 282''' 式日志记录]] |
| − | ** [[../apiref#module-distutils|9.19. <code>distutils.spawn</code> | + | ** [[../apiref#module-distutils|9.19. <code>distutils.spawn</code> — 产生一个子进程]] |
| − | ** [[../apiref#module-distutils|9.20. <code>distutils.sysconfig</code> | + | ** [[../apiref#module-distutils|9.20. <code>distutils.sysconfig</code> — 系统配置信息]] |
| − | ** [[../apiref#module-distutils|9.21. <code>distutils.text_file</code> | + | ** [[../apiref#module-distutils|9.21. <code>distutils.text_file</code> — TextFile 类]] |
| − | ** [[../apiref#module-distutils|9.22. <code>distutils.version</code> | + | ** [[../apiref#module-distutils|9.22. <code>distutils.version</code> — 版本号类]] |
| − | ** [[../apiref#module-distutils|9.23. <code>distutils.cmd</code> | + | ** [[../apiref#module-distutils|9.23. <code>distutils.cmd</code> — Distutils 命令的抽象基类]] |
| − | ** [[../apiref#creating-a-new-distutils-command|9.24. | + | ** [[../apiref#creating-a-new-distutils-command|9.24. 创建一个新的 Distutils 命令]] |
| − | ** [[../apiref#module-distutils|9.25. <code>distutils.command</code> | + | ** [[../apiref#module-distutils|9.25. <code>distutils.command</code> — 单个 Distutils 命令]] |
| − | ** [[../apiref#module-distutils.command|9.26. <code>distutils.command.bdist</code> | + | ** [[../apiref#module-distutils.command|9.26. <code>distutils.command.bdist</code> — 构建二进制安装程序]] |
| − | ** [[../apiref#module-distutils.command|9.27. <code>distutils.command.bdist_packager</code> | + | ** [[../apiref#module-distutils.command|9.27. <code>distutils.command.bdist_packager</code> — 打包程序的抽象基类]] |
| − | ** [[../apiref#module-distutils.command|9.28. <code>distutils.command.bdist_dumb</code> | + | ** [[../apiref#module-distutils.command|9.28. <code>distutils.command.bdist_dumb</code> — 构建一个“愚蠢”的安装程序]] |
| − | ** [[../apiref#module-distutils.command|9.29. <code>distutils.command.bdist_msi</code> | + | ** [[../apiref#module-distutils.command|9.29. <code>distutils.command.bdist_msi</code> — 构建 Microsoft 安装程序二进制包]] |
| − | ** [[../apiref#module-distutils.command|9.30. <code>distutils.command.bdist_rpm</code> | + | ** [[../apiref#module-distutils.command|9.30. <code>distutils.command.bdist_rpm</code> — 构建一个二进制发行版作为 Redhat RPM 和 SRPM]] |
| − | ** [[../apiref#module-distutils.command|9.31. <code>distutils.command.bdist_wininst</code> | + | ** [[../apiref#module-distutils.command|9.31. <code>distutils.command.bdist_wininst</code> — 构建 Windows 安装程序]] |
| − | ** [[../apiref#module-distutils.command|9.32. <code>distutils.command.sdist</code> | + | ** [[../apiref#module-distutils.command|9.32. <code>distutils.command.sdist</code> — 构建源代码分发]] |
| − | ** [[../apiref#module-distutils.command|9.33. <code>distutils.command.build</code> | + | ** [[../apiref#module-distutils.command|9.33. <code>distutils.command.build</code> — 构建包的所有文件]] |
| − | ** [[../apiref#module-distutils.command|9.34. <code>distutils.command.build_clib</code> | + | ** [[../apiref#module-distutils.command|9.34. <code>distutils.command.build_clib</code> — 在包中构建任何 C 库]] |
| − | ** [[../apiref#module-distutils.command|9.35. <code>distutils.command.build_ext</code> | + | ** [[../apiref#module-distutils.command|9.35. <code>distutils.command.build_ext</code> — 在包中构建任何扩展]] |
| − | ** [[../apiref#module-distutils.command|9.36. <code>distutils.command.build_py</code> | + | ** [[../apiref#module-distutils.command|9.36. <code>distutils.command.build_py</code> — 构建包的 .py/.pyc 文件]] |
| − | ** [[../apiref#module-distutils.command|9.37. <code>distutils.command.build_scripts</code> | + | ** [[../apiref#module-distutils.command|9.37. <code>distutils.command.build_scripts</code> — 构建包的脚本]] |
| − | ** [[../apiref#module-distutils.command|9.38. <code>distutils.command.clean</code> | + | ** [[../apiref#module-distutils.command|9.38. <code>distutils.command.clean</code> — 清洁包构建区域]] |
| − | ** [[../apiref#module-distutils.command|9.39. <code>distutils.command.config</code> | + | ** [[../apiref#module-distutils.command|9.39. <code>distutils.command.config</code> — 执行包配置]] |
| − | ** [[../apiref#module-distutils.command|9.40. <code>distutils.command.install</code> | + | ** [[../apiref#module-distutils.command|9.40. <code>distutils.command.install</code> — 安装包]] |
| − | ** [[../apiref#module-distutils.command|9.41. <code>distutils.command.install_data</code> | + | ** [[../apiref#module-distutils.command|9.41. <code>distutils.command.install_data</code> — 从包安装数据文件]] |
| − | ** [[../apiref#module-distutils.command|9.42. <code>distutils.command.install_headers</code> | + | ** [[../apiref#module-distutils.command|9.42. <code>distutils.command.install_headers</code> — 从包安装 C/C++ 头文件]] |
| − | ** [[../apiref#module-distutils.command|9.43. <code>distutils.command.install_lib</code> | + | ** [[../apiref#module-distutils.command|9.43. <code>distutils.command.install_lib</code> — 从包安装库文件]] |
| − | ** [[../apiref#module-distutils.command|9.44. <code>distutils.command.install_scripts</code> | + | ** [[../apiref#module-distutils.command|9.44. <code>distutils.command.install_scripts</code> — 从包安装脚本文件]] |
| − | ** [[../apiref#module-distutils.command|9.45. <code>distutils.command.register</code> | + | ** [[../apiref#module-distutils.command|9.45. <code>distutils.command.register</code> — 使用 Python 包索引注册一个模块]] |
| − | ** [[../apiref#module-distutils.command|9.46. <code>distutils.command.check</code> | + | ** [[../apiref#module-distutils.command|9.46. <code>distutils.command.check</code> — 检查包的元数据]] |
| 第135行： | 第127行： | ||
</div> | </div> | ||
| + | <div class="clearer"> | ||
| − | [[Category:Python 3.9 | + | |
| + | |||
| + | </div> | ||
| + | |||
| + | [[Category:Python 3.9 文档]] | ||
2021年10月31日 (日) 04:50的最新版本
分发 Python 模块（旧版）
- 作者
- 格雷格·沃德，安东尼·巴克斯特
- 电子邮件
- distutils-sig@python.org
笔记
本文档仅保留到 https://setuptools.readthedocs.io/en/latest/setuptools.html 上的 setuptools 文档独立涵盖当前包含在此处的所有相关信息之前。
笔记
本指南仅涵盖作为此版本 Python 的一部分提供的用于构建和分发扩展的基本工具。 第三方工具提供更易于使用和更安全的替代方案。 有关更多信息，请参阅 Python Packaging User Guide 中的 快速建议部分 。
本文档从模块开发人员的角度描述了 Python 分发实用程序（“Distutils”），描述了 setuptools 构建的基础功能，以允许 Python 开发人员使 Python 模块和扩展对更广泛的受众易于使用。
- 1. Distutils 简介
- 2. 编写安装脚本
- 3. 编写设置配置文件
- 4. 创建源代码分发
- 5. 创建内置分布
- 6. Distutils 示例
- 7. 扩展 Distutils
- 8. 命令参考
- 9. API 参考
- 9.1.
distutils.core— 核心 Distutils 功能 - 9.2.
distutils.ccompiler— CCompiler 基类 - 9.3.
distutils.unixccompiler— Unix C 编译器 - 9.4.
distutils.msvccompiler— 微软编译器 - 9.5.
distutils.bcppcompiler— Borland 编译器 - 9.6.
distutils.cygwincompiler— Cygwin 编译器 - 9.7.
distutils.archive_util— 归档实用程序 - 9.8.
distutils.dep_util— 依赖检查 - 9.9.
distutils.dir_util— 目录树操作 - 9.10.
distutils.file_util— 单文件操作 - 9.11.
distutils.util— 其他实用函数 - 9.12.
distutils.dist— 分布类 - 9.13.
distutils.extension— 扩展类 - 9.14.
distutils.debug— Distutils 调试模式 - 9.15.
distutils.errors— Distutils 异常 - 9.16.
distutils.fancy_getopt— 标准 getopt 模块的包装器 - 9.17.
distutils.filelist— FileList 类 - 9.18.
distutils.log— 简单的 PEP 282 式日志记录 - 9.19.
distutils.spawn— 产生一个子进程 - 9.20.
distutils.sysconfig— 系统配置信息 - 9.21.
distutils.text_file— TextFile 类 - 9.22.
distutils.version— 版本号类 - 9.23.
distutils.cmd— Distutils 命令的抽象基类 - 9.24. 创建一个新的 Distutils 命令
- 9.25.
distutils.command— 单个 Distutils 命令 - 9.26.
distutils.command.bdist— 构建二进制安装程序 - 9.27.
distutils.command.bdist_packager— 打包程序的抽象基类 - 9.28.
distutils.command.bdist_dumb— 构建一个“愚蠢”的安装程序 - 9.29.
distutils.command.bdist_msi— 构建 Microsoft 安装程序二进制包 - 9.30.
distutils.command.bdist_rpm— 构建一个二进制发行版作为 Redhat RPM 和 SRPM - 9.31.
distutils.command.bdist_wininst— 构建 Windows 安装程序 - 9.32.
distutils.command.sdist— 构建源代码分发 - 9.33.
distutils.command.build— 构建包的所有文件 - 9.34.
distutils.command.build_clib— 在包中构建任何 C 库 - 9.35.
distutils.command.build_ext— 在包中构建任何扩展 - 9.36.
distutils.command.build_py— 构建包的 .py/.pyc 文件 - 9.37.
distutils.command.build_scripts— 构建包的脚本 - 9.38.
distutils.command.clean— 清洁包构建区域 - 9.39.
distutils.command.config— 执行包配置 - 9.40.
distutils.command.install— 安装包 - 9.41.
distutils.command.install_data— 从包安装数据文件 - 9.42.
distutils.command.install_headers— 从包安装 C/C++ 头文件 - 9.43.
distutils.command.install_lib— 从包安装库文件 - 9.44.
distutils.command.install_scripts— 从包安装脚本文件 - 9.45.
distutils.command.register— 使用 Python 包索引注册一个模块 - 9.46.
distutils.command.check— 检查包的元数据
- 9.1.
