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 则是指反斜
杠或冒号以外的任何字符。
