8. 指令參照

備註

这篇文档只有在 https://setuptools.readthedocs.io/en/latest/setuptools.html 上的 setuptools 文档独立涵盖此处包含的所有相关信息之前,才会单独保留。

8.1. 安装模块: install 命令族

install 命令会确保 build 命令已经运行,然后运行子命令 install_lib, install_datainstall_scripts

8.1.1. install_data

此命令会安装随发行包一同提供的所有数据文件。

8.1.2. install_scripts

此命令会安装发行包中的所有(Python)脚本。

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

列出的模板命令有:

命令

描述

include pat1 pat2 ...

包括与列出的模式匹配的所有文件

exclude pat1 pat2 ...

排除与列出的模式匹配的所有文件

recursive-include dir pat1 pat2 ...

包括 dir 下与列出的模式匹配的所有文件

recursive-exclude dir pat1 pat2 ...

排除 dir 下与列出的模式匹配的所有文件

global-include pat1 pat2 ...

包括与源树匹配的所有文件---和任何列出的模式

global-exclude pat1 pat2 ...

排除与源树匹配的所有文件---和任何列出的模式

prune dir

排除 dir 下的所有文件

graft dir

包括 dir 下的所有文件

此处的模式是 Unix 风格的 "glob" 模式: * 匹配任意的常规文件名字符序列,? 匹配任意单个常规文件名字符,而 [range] 匹配 range 范围内的任意字符 (例如 a-z, a-zA-Z, a-f0-9_.)。 “常规文件名字符”的定义取决于具体平台:在 Unix 上是指正斜杠以外的任何字符;在 Windows 则是指反斜杠或冒号以外的任何字符。