setuptools

setuptoolsの目的

setuptoolsはPython 標準の distutils を拡張しています。 この拡張によってeggを作ったり使ったりできるようになります。 一番有名な利用方法は、easy_installコマンドでしょう。

easy_install を使うために ez_setup.py を実行したことがある人も多いはず。 ez_setup.py を行うと、Pythonのsite-packagesに setuptools がインストール されます。

easy_install コマンドは easy_install aodag.util 等と書くと、 PyPI(Python Package Index)から自動的に aodag.util パッケージを探してきて site-packages にインストールしてくれます。

distribute

setuptoolsはほとんどメンテナンスされていないため、Distributeという互換 パッケージが開発されています。基本的にsetuptoolsとdistributeどちらを使っても かまいませんが、distributeの方が安定しています。 安定というのは、最新のPythonで動作する、環境依存が少ない、エラーが分かりやすい、などです。

setuptoolsをインストール

virtualenvを使っていれば既にインストールされているはずです。 Python本体にインストールするには以下の方法で行います。

  1. http://peak.telecommunity.com/dist/ez_setup.py をダウンロード

  2. ez_setup.pyをどこか(仮に/tmpとする)に置いておく。

  3. インストールする

$ python /tmp/ez_setup.py

distributeをインストール

virtualenv で --distribute オプションを付けるとdistributeが使われます。 後からdistributeに変えたくなったり、Python本体にインストルするには以下 を行います。

  1. http://python-distribute.org/distribute_setup.py をダウンロード

  2. distribute_setup.pyをどこか(仮に/tmpとする)に置いておく。

  3. インストールする

$ python /tmp/distribute_setup.py

これで既存にsetuptoolsがあればそれが使われないように調整してくれます。 使うときはsetuptoolsというライブラリ名で使うことになるので、これ以降は setuptoolsだと思って使って下さい。