8. コマンドリファレンス
***********************

注釈:

  このドキュメントは、
  https://setuptools.readthedocs.io/en/latest/setuptools.html にある
  "setuptools" のドキュメントが現時点でここにある関連情報を全て網羅す
  るまで、単独でここに載せておかれます。


8.1. モジュールをインストールする: **install** コマンド群
=========================================================

**install** コマンドは最初にビルドコマンドを実行しておいてから、サブコ
マンド **install_lib** を実行します。 **install_data** and
**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" パターンです。 "*" は通
常のファイル名文字の任意のシーケンスにマッチします。 "?" は通常のファ
イル名文字の1文字にマッチします。 "[range]" は *range* に含まれる全て
の文字にマッチします (例: "a-z", "a-zA-Z", "a-f0-9_.") 通常のファイル
名文字は、プラットフォーム依存になります。 Unix ではスラッシュ以外の全
ての文字で、 Windows ではコロンとバックスラッシュ以外の全ての文字です
。
