virtualenv, virtualenvwrapper, pip を使う方法

あるプロジェクトの依存は特定なバージョンじゃないとダメな場合が結構多いと思いますけど、最近、pythonの仮想環境を簡単に作れるようになりました。virtualenvとvirtualenvwrapperとpipの組み合わせを紹介します。

virtualenvは環境を作ってくれるライブラリで、virtualenvwrapperはその作った環境を簡単に管理してくれるツールになります。

まず、virtualenvとvirtualenvwrapperをインストール

easy_install virtualenv
easy_install virtualenvwrapper

これで、virtualenvwrapperのコマンドを使うには、bashスクリプトを設定しないといけない。以下の行を.bashrcに追加

export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper_bashrc

Update: virtualenvwrapper 2.0+の場合ですと、Bash意外の端末シェルにも対応しているので、virtualenvwrapper_bashrcはvirtualenvwrapper.shにかわりました。PATHには入るので、

以下を.bashrcに追加してください。

export WORKON_HOME=$HOME/.virtualenvs
source `which virtualenvwrapper.sh`

コンソールを再起動して終わり。仮想環境を作りましょう。

mkvirtualenv myproj

これで、プロジェクトの仮想環境ができました。これで、pythonのバージョンも確定し、仮想環境にインストールするライブラリのバージョンも確定になる。mkvirtualenvを実行すると、作った環境に入る。また、次に使う時はworkon myprojを実行して、環境に入る。

しかし、よく使われてるeasy_installはvirtualenvと連携できなくて、どうしても、システムのpythonディレクトリにパッケージをインストールしてしまう。

pip が助かる

easy_installが簡単すぎて、分けわかんないメッセージも出したりして、virtualenvと相性悪くて、何とかできませんか？って話があったきかっけ、pipが生まれた。pipをインストールすればvirtualenvにすいすいとパッケージをインストールできる。virtualenvを使っている間にインストールする。

wget http://pypi.python.org/packages/source/p/pip/pip-0.4.tar.gz
tar xzf pip-0.4.tar.gz
cd pip-0.4
python setup.py install

Update: pipはちゃんと、virtualenvに入ってくれるので、easy_installでもインストールできる。

workon myproject
easy_install pip

Update: pipをグローバルにインストールしたい場合は、環境変数PIP_RESPECT_VIRTUALENVを設定すると、今使っているvirtualenvをpipも使ってくれる。

export PIP_RESPECT_VIRTUALENV=true

pip -Eでも、virtualenvの環境パスを指定できます。

pip -E /path/to/my/virtualenv install mymod

これで、pipが仮想環境にインストールする。これから、pip installで仮想環境にパッケージをインストールできるようになった。それで、プロジェクトに必要なパッケージをインストールし、pythonのsite-packagesが汚くならないので、安心