Python を使って開発や実験を行うときは、用途に応じて専用の実行環境を作成し、切り替えて使用するのが一般的です。こういった、一時的に作成する実行環境を、「仮想環境」 と言います。
仮想環境は、次のような目的で使われます。
システム全体で使うPython環境に影響を与えずにモジュールの追加・入れ替えをしたい。
異なるバージョンの Python を使いわけたり、同じモジュールの、複数のバージョンを使い分けたい。
例えば、開発中のWebアプリケーション開発では、Python 3.7 で Webアプリケーションフレームワークとして Django の 1.10 を使い、新しいプロジェクトでは Python 3.8 とDjango バージョン 1.11 を使用したい場合など、簡単に切り替えられるようにしたい。
ここでは、ここでは、Python3 の標準ライブラリである venv で仮想環境を作成する方法を紹介します。
Virtualenvのコマンド¶
Virtualenvは、pipコマンド でインストールできます。
$ pip3 install virtualenv
仮想環境の作成¶
では、最初の仮想環境を作成しましょう。適当なディレクトリで、次のコマンドを実行します。
$ virtualenv py3env
./py3env/ に Python3.6 用の仮想環境が作成されました。
仮想環境の切り替え¶
作成した仮想環境の bin/activate を実行します
$ . ./py3env/bin/activate
(py3env) $
コマンド プロンプトの先頭に (py3env) と表示され、仮想環境が設定されたことを示します。
仮想環境に切り替えると、環境変数 PATH が設定され、python コマンド で仮想環境の bin ディレクトリから実行されるようになります。
通常、python コマンドは Python2.7を実行し、Python 3.x を実行する場合は``python3`` コマンドを使用しますが、仮想環境中では、python コマンドは仮想環境を作成した Python を起動します。
Python 3.x 用の仮想環境では、python コマンドで Python 3.x が実行されます。
(py3env) $ python
Python 3.6.1 (default, Apr 4 2017, 09:40:21)
[GCC 4.2.1 Compatible Apple LLVM 8.1.0 (clang-802.0.38)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>
bin ディレクトリには pip などのコマンドもインストールされており、コマンドラインから実行できるようになります。
(py3env) $ pip
Usage:
pip <command> [options]
Commands:
install Install packages.
download Download packages.
…
パッケージのインストール¶
仮想環境を利用中も、通常通り pip コマンドを使ってパッケージをインストールできます。
(py3env) $ pip install tse
Collecting tse
Downloading tse-0.0.15.tar.gz
Collecting argparse (from tse)
Downloading argparse-1.4.0-py2.py3-none-any.whl
Collecting six (from tse)
Using cached six-1.10.0-py2.py3-none-any.whl
…
インストールしたパッケージは、仮想環境内にのみ書き込まれ、元の Python や他の仮想環境からは利用できません。
仮想環境の終了¶
仮想環境の使用を終え、通常の状態に復帰するときは、deactivate コマンドを実行します。
(py3env) $ deactivate
$
Pythonを指定した仮想環境¶
複数のバージョンの Python をインストールしていれば、使用する Python を指定して仮想環境を作成できます。
異なるバージョンの Python 用に仮想環境を作成する場合、そちらの環境にも virtualenv をインストールしておくと簡単です。
次のコマンドは、Python2.7 に virtualenv をインストールします。
$ python2.7 -m pip install virtualenv
Python2.7 を使って、仮想環境を作成します。
$ python2.7 -m virtualenv py27env
ここで作成した py27env を使用すると、python2.7 環境に切り替わります。
$ . py27env/bin/activate
(py27env) $ python
Python 2.7.13 (default, Apr 4 2017, 08:47:57)
[GCC 4.2.1 Compatible Apple LLVM 8.1.0 (clang-802.0.38)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>
Virtualenvwrapper¶
Virtualenvwrapper は、広く使われている仮想環境の管理ツールで、仮想環境の生成・削除・切り替えなど行うコマンド集です。
Virtualenvwrapperのインストール¶
pip コマンドでインストールできます。
$ pip3 install Virtualenvwrapper
Shell環境設定ファイルの修正¶
~/.bashrc などのShell環境設定ファイルに、以下の設定を追加します。
export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/projects
source `which virtualenvwrapper.sh`
ファイルを修正したら、次のコマンドで修正を適用します。
$ . ~/.bashrc
Virtualenvwrapperのコマンド¶
Virtualenvwrapper をインストールすると、次のようなコマンドを使えます。
mkvirtualenv¶
仮想環境を作成します。-p オプションで、使用する Python を指定できます。
$ mkvirtualenv testenv -p /usr/local/bin/python3.6
(testenv) $
この例では、Python 3.6 を指定して仮想環境 testenv を作成しています。testenv は、.bashrc に指定した ~/=$HOME/.virtualenvs に作成されます。
workon¶
指定した仮想環境に切り替えます。
$ workon testenv
(testenv) $
rmvirtualenv¶
指定した仮想環境を削除します。
$ rmvirtualenv testenv