27.1. "distutils" --- Python モジュールの構築とインストール
***********************************************************

"distutils" パッケージは、現在インストールされている Python に追加する
ためのモジュール構築、および実際のインストールを支援します。新規のモジ
ュールは 100%-pure Python でも、C で書かれた拡張モジュールでも、あるい
は Python と C 両方のコードが入っているモジュールからなる Python パッ
ケージでもかまいません。

Python ユーザの大半はこのパッケージを直接使い *たくはない* でしょうが
、代わりに Python Packaging Authority が保守しているクロスバージョンツ
ールを使うでしょう。特に、setuptools は "distutils" の改良された代替品
で、以下を提供しています:

* プロジェクトの依存性の宣言のサポート

* ソースのリリースの際どのファイルを含めるか指定する追加の機構 (バー
  ジ ョン管理システムとの統合のためのプラグインも含む)

* プロジェクトの "エントリーポイント" を宣言する機能、アプリケーショ
  ン プラグインシステムとして使うことができます

* インストール時に事前にビルドすることなく、Windows コマンドライン実
  行 ファイルを自動的に生成する機能

* サポートしている Python の全バージョンで一貫性のある挙動

たとえスクリプト自身が "distutils" のみをインポートしていても、推奨さ
れる pip インストーラは "setuptools" で全 "setup.py" スクリプトを実行
します。詳細は Python Packaging User Guide を参照してください。

現在のパッケージと配布システムへの理解を深めようとしている著者やユーザ
のために、レガシーな "distutils" に基づくユーザドキュメントと API のリ
ファレンスは利用可能なままになっています。

* Python モジュールのインストール (旧版)

* Python モジュールの配布 (レガシーバージョン)
