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

著者:
   Greg Ward, Anthony Baxter

Email:
   distutils-sig@python.org

参考:

  Python モジュールの配布
     最新のモジュール配布ドキュメンテーション

このドキュメントでは、 Python 配布ユーティリティ (Python Distribution
Utilities, "Distutils") について、 モジュール開発者の視点に立ち、多く
の人々がビルド/リリース/インストール の手間をほとんどかけずに Python
モジュールや拡張モジュールを入手できるようにする方法について述べます。

注釈: このガイドは、Python のバージョンの一部として提供される拡張の
  ビルド と配布についての基礎的なツールについてのみをカバーします。サ
  ードパー ティによるツールが、容易に使えてもっと安全な代替として使え
  るでしょう 。もっと詳しい情報は quick recommendations section にある
  Python パ ッケージングユーザガイドから得られます。

* 1. Distutilsの紹介

  * 1.1. 概念と用語

  * 1.2. 簡単な例

  * 1.3. Python 一般の用語

  * 1.4. Distutils 固有の用語

* 2. setup スクリプトを書く

  * 2.1. パッケージを全て列挙する

  * 2.2. 個々のモジュールを列挙する

  * 2.3. 拡張モジュールについて記述する

  * 2.4. パッケージと配布物の関係

  * 2.5. スクリプトをインストールする

  * 2.6. パッケージデータをインストールする

  * 2.7. 追加のファイルをインストールする

  * 2.8. 追加のメタデータ

  * 2.9. setup スクリプトをデバッグする

* 3. setup 設定ファイル (setup configuration file) を書く

* 4. ソースコード配布物を作成する

  * 4.1. 配布するファイルを指定する

  * 4.2. マニフェスト (manifest) 関連のオプション

* 5. ビルド済み配布物を作成する

  * 5.1. RPM パッケージを作成する

  * 5.2. Windows インストーラを作成する

  * 5.3. Windows でのクロスコンパイル

  * 5.4. Vista のユーザアカウント制御 (UAC)

* 6. Python Package Index (PyPI)

  * 6.1. PyPI の概要

  * 6.2. Distutils コマンド

  * 6.3. PyPI パッケージ表示

* 7. 使用例

  * 7.1. pure Python 配布物 (モジュール形式)

  * 7.2. pure Python 配布物 (パッケージ形式)

  * 7.3. 単体の拡張モジュール

  * 7.4. パッケージのチェック

  * 7.5. メタデータの読み込み

* 8. Distutilsの拡張

  * 8.1. 新しいコマンドの統合

  * 8.2. 配布物の種類を追加する

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

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

  * 9.2. ソース配布物を生成する: **sdist** コマンド

* 10. API リファレンス

  * 10.1. "distutils.core" --- Distutils のコア機能

  * 10.2. "distutils.ccompiler" --- CCompiler ベースクラス

  * 10.3. "distutils.unixccompiler" --- Unix C コンパイラ

  * 10.4. "distutils.msvccompiler" --- Microsoft コンパイラ

  * 10.5. "distutils.bcppcompiler" --- Borland コンパイラ

  * 10.6. "distutils.cygwincompiler" --- Cygwin コンパイラ

  * 10.7. "distutils.archive_util" --- アーカイブユーティリティ

  * 10.8. "distutils.dep_util" --- 依存関係のチェック

  * 10.9. "distutils.dir_util" --- ディレクトリツリーの操作

  * 10.10. "distutils.file_util" --- 1ファイルの操作

  * 10.11. "distutils.util" --- その他のユーティリティ関数

  * 10.12. "distutils.dist" --- Distribution クラス

  * 10.13. "distutils.extension" --- Extension クラス

  * 10.14. "distutils.debug" --- Distutils デバッグモード

  * 10.15. "distutils.errors" --- Distutils 例外

  * 10.16. "distutils.fancy_getopt" --- 標準 getopt モジュールのラッ
    パ

  * 10.17. "distutils.filelist" --- FileList クラス

  * 10.18. "distutils.log" --- シンプルな PEP 282 スタイルのロギング

  * 10.19. "distutils.spawn" --- サブプロセスの生成

  * 10.20. "distutils.sysconfig" --- システム設定情報

  * 10.21. "distutils.text_file" --- TextFile クラス

  * 10.22. "distutils.version" --- バージョン番号クラス

  * 10.23. "distutils.cmd" --- Distutils コマンドの抽象クラス

  * 10.24. 新しいDistutilsコマンドの作成

  * 10.25. "distutils.command" --- Distutils 各コマンド

  * 10.26. "distutils.command.bdist" --- バイナリインストーラの構築

  * 10.27. "distutils.command.bdist_packager" --- パッケージの抽象ベ
    ー スクラス

  * 10.28. "distutils.command.bdist_dumb" --- "ダム"インストーラを構
    築

  * 10.29. "distutils.command.bdist_msi" --- Microsoft Installer バ
    イ ナリパッケージをビルドする

  * 10.30. "distutils.command.bdist_rpm" --- Redhat RPMとSRPM形式の
    バ イナリディストリビューションを構築

  * 10.31. "distutils.command.bdist_wininst" --- Windowsインストーラ
    の 構築

  * 10.32. "distutils.command.sdist" --- ソース配布物の構築

  * 10.33. "distutils.command.build" --- パッケージ中の全ファイルを
    構 築

  * 10.34. "distutils.command.build_clib" --- パッケージ中のCライブ
    ラ リを構築

  * 10.35. "distutils.command.build_ext" --- パッケージ中の拡張を構
    築

  * 10.36. "distutils.command.build_py" --- パッケージ中の.py/.pyc
    フ ァイルを構築

  * 10.37. "distutils.command.build_scripts" --- パッケージ中のスク
    リ プトを構築

  * 10.38. "distutils.command.clean" --- パッケージのビルドエリアを
    消 去

  * 10.39. "distutils.command.config" --- パッケージの設定

  * 10.40. "distutils.command.install" --- パッケージのインストール

  * 10.41. "distutils.command.install_data" --- パッケージ中のデータ
    フ ァイルをインストール

  * 10.42. "distutils.command.install_headers" --- パッケージから
    C/C++ ヘッダファイルをインストール

  * 10.43. "distutils.command.install_lib" --- パッケージからライブ
    ラ リファイルをインストール

  * 10.44. "distutils.command.install_scripts" --- パッケージからス
    ク リプトファイルをインストール

  * 10.45. "distutils.command.register" --- モジュールをPython
    Package Indexに登録する

  * 10.46. "distutils.command.check" --- パッケージのメタデータをチ
    ェ ックする
