# 8. 指令參照

備註

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

## 8.1. 安装模块: install 命令族

install 命令会确保 build 命令已经运行，然后运行子命令 install_lib, install_data 和 install_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 则是指反斜杠或冒号以外的任何字符。