Pythonのバージョン管理：pyenvの導入と使い方
Pythonのプロジェクト開発において、Pythonのバージョンは非常に重要な要素です。特定のライブラリが特定のPythonバージョンに依存していたり、チームメンバー間で同じ環境を共有する必要があったりする場合、複数のPythonバージョンを管理できるツールは不可欠となります。
pyenvとは？
pyenvは、複数のPythonバージョンを簡単にインストールし、切り替えることができるコマンドラインユーティリティです。ユーザーごとに、あるいはディレクトリごとに、使用するPythonのバージョンを指定できるため、プロジェクトごとに異なるPython環境を独立して管理することが可能になります。
pyenvの主な機能
* 複数バージョンのインストール：公式リポジトリから、あるいはカスタムビルドで、指定したPythonバージョンを簡単にインストールできます。
* グローバル・ローカル・シェルでのバージョン指定：
* グローバル：システム全体でデフォルトとして使用されるPythonバージョンを設定します。
* ローカル：特定のプロジェクトディレクトリで有効となるPythonバージョンを設定します。`.python-version`というファイルが生成され、そのディレクトリとそのサブディレクトリで有効になります。
* シェル：一時的に現在のシェルセッションでのみ有効となるPythonバージョンを設定します。
* 仮想環境との連携：`pyenv-virtualenv`プラグインと連携することで、Pythonバージョンごとに独立した仮想環境を作成・管理できます。
* pipの分離：各Pythonバージョンに紐づく`pip`が自動的に管理されるため、バージョン間の依存関係の衝突を防ぎます。
pyenvの導入
pyenvの導入は、オペレーティングシステムによって手順が異なります。ここでは、macOSとLinuxを例に説明します。Windowsの場合は、WSL (Windows Subsystem for Linux) を利用するか、pyenv-winなどの代替ツールを検討するのが一般的です。
macOSでの導入 (Homebrewを使用)
Homebrewがインストールされている場合、最も簡単な導入方法です。
1. Homebrewのインストール（未導入の場合）
ターミナルを開き、以下のコマンドを実行します。
“`bash
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”
“`
2. pyenvのインストール
“`bash
brew update
brew install pyenv
“`
3. シェル設定の追加
pyenvを正しく動作させるために、シェルの設定ファイル（`.zshrc`や`.bash_profile`など）にpyenvの初期化コマンドを追加する必要があります。お使いのシェルに合わせて、以下のいずれかのコマンドをターミナルで実行してください。
* **zsh (macOS Catalina以降のデフォルトシェル)**:
“`bash
echo ‘eval “$(pyenv init –path)”‘ >> ~/.zshrc
echo ‘eval “$(pyenv init -)”‘ >> ~/.zshrc
“`
* **bash**:
“`bash
echo ‘eval “$(pyenv init –path)”‘ >> ~/.bash_profile
echo ‘eval “$(pyenv init -)”‘ >> ~/.bash_profile
“`
設定ファイルを変更したら、ターミナルを再起動するか、以下のコマンドで設定を読み込みます。
“`bash
# zshの場合
source ~/.zshrc
# bashの場合
source ~/.bash_profile
“`
Linuxでの導入 (Gitを使用)
Gitがインストールされている環境であれば、以下の手順で導入できます。
1. pyenvのインストールスクリプトの実行
最新のインストールスクリプトを実行します。
“`bash
curl https://pyenv.run | bash
“`
2. シェル設定の追加
インストールスクリプトの実行後、ターミナルに表示される指示に従って、シェルの設定ファイル（`.bashrc`や`.zshrc`など）にpyenvのパスと初期化コマンドを追加します。一般的には以下のようになります。
“`bash
echo ‘export PYENV_ROOT=”$HOME/.pyenv”‘ >> ~/.bashrc
echo ‘command -v pyenv >/dev/null || export PATH=”$PYENV_ROOT/bin:$PATH”‘ >> ~/.bashrc
echo ‘eval “$(pyenv init -)”‘ >> ~/.bashrc
“`
設定ファイルを変更したら、ターミナルを再起動するか、以下のコマンドで設定を読み込みます。
“`bash
source ~/.bashrc
“`
pyenvの使い方
pyenvの導入が完了したら、実際にPythonバージョンをインストールし、切り替えてみましょう。
Pythonバージョンのインストール
まず、インストール可能なPythonバージョンのリストを確認します。
“`bash
pyenv install –list
“`
次に、使用したいバージョンをインストールします。例えば、Python 3.9.10をインストールする場合：
“`bash
pyenv install 3.9.10
“`
インストールには時間がかかることがあります。また、ビルドに必要な開発ツール（`gcc`, `make`, `openssl-devel`, `zlib-devel`など）がシステムにインストールされていない場合、ビルドエラーが発生することがあります。その場合は、お使いのOSのパッケージマネージャーでこれらの開発ツールをインストールしてください。
Pythonバージョンの切り替え
* グローバルバージョンの設定
システム全体でデフォルトとなるPythonバージョンを設定します。
“`bash
pyenv global 3.9.10
“`
* ローカルバージョンの設定
特定のプロジェクトディレクトリで有効となるPythonバージョンを設定します。プロジェクトのルートディレクトリに移動してから実行します。
“`bash
cd my_project_directory
pyenv local 3.9.10
“`
これにより、`my_project_directory`内に`.python-version`というファイルが作成され、その中に`3.9.10`と記述されます。
* シェルバージョンの設定
現在のシェルセッションでのみ一時的に有効なPythonバージョンを設定します。
“`bash
pyenv shell 3.9.10
“`
現在のPythonバージョンの確認
現在どのPythonバージョンが有効になっているかを確認するには、以下のコマンドを実行します。
“`bash
python –version
“`
あるいは、pyenvが管理しているバージョンを確認するには：
“`bash
pyenv version
“`
インストール済みバージョンの確認
現在pyenvでインストールされているPythonバージョンを確認するには：
“`bash
pyenv versions
“`
現在有効なバージョンはアスタリスク(*)で表示されます。
pyenv-virtualenvプラグイン
pyenvは、仮想環境を管理する`pyenv-virtualenv`プラグインと連携することで、さらに強力な環境管理を実現します。
pyenv-virtualenvのインストール
pyenvと同様に、Gitを使ってインストールできます。
“`bash
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
“`
インストール後、シェル設定ファイルに以下の行を追加し、シェルを再読み込みします。
“`bash
eval “$(pyenv virtualenv-init -)”
“`
仮想環境の作成・管理
* 仮想環境の作成
指定したPythonバージョンに基づいた仮想環境を作成します。
“`bash
pyenv virtualenv 3.9.10 my-project-env
“`
これにより、Python 3.9.10をベースにした`my-project-env`という名前の仮想環境が作成されます。
* 仮想環境の有効化
作成した仮想環境を有効にするには、`pyenv activate`コマンドを使用します。
“`bash
pyenv activate my-project-env
“`
ターミナルのプロンプトが`(my-project-env)`のように仮想環境名でプレフィックスされるようになります。
* 仮想環境の無効化
“`bash
pyenv deactivate
“`
* 仮想環境のリスト表示
“`bash
pyenv virtualenvs
“`
* 仮想環境の削除
“`bash
pyenv uninstall -v my-project-env
“`
プロジェクトでの仮想環境の利用
プロジェクトディレクトリで`pyenv local my-project-env`と設定することで、そのディレクトリに入った際に自動的に仮想環境が有効になるように設定することも可能です。
まとめ
pyenvは、Python開発者にとって非常に強力で、かつ使いやすいバージョン管理ツールです。複数のPythonバージョンをプロジェクトごとに、あるいはグローバルに管理できるため、開発環境の構築や維持が格段に容易になります。pyenv-virtualenvプラグインとの組み合わせは、依存関係の衝突を防ぎ、クリーンな開発ワークフローを確立するための鍵となります。
特に、複数のプロジェクトを並行して開発している場合や、最新のPythonバージョンでライブラリの互換性をテストしたい場合などに、その真価を発揮します。導入の手順は、お使いのOSに合わせて一度行えば、その後の運用は非常にシンプルです。Python開発においては、このpyenvを積極的に活用することを強く推奨します。
