pyenv とは何ですか? なぜそれが必要なのでしょうか?

pyenv は、システム上の複数の Python バージョンを管理できるシンプルかつ強力なツールです。 Python 開発者は、多くの場合、異なる Python バージョンを必要とするさまざまなプロジェクトに取り組む必要があります。これらのバージョンを手動で管理するのは面倒で、エラーが発生しやすい場合があります。ここで pyenv が登場します。これにより、Python のバージョン間の切り替えが簡単になり、プロジェクトが常に正しいバージョンで実行されるようになります。

pyenv を使用する理由

• バージョン管理: 異なる Python バージョンのインストールと切り替えが簡単に行えます。

• プロジェクトの分離: 互換性の問題を回避するために、各プロジェクトが正しい Python バージョンを使用していることを確認します。

• 柔軟性: 複数の Python バージョンでコードを簡単にテストできます。

バージョンの競合の問題に直面したことがある場合、または同じマシン上で Python 2.x と 3.x の両方を使用する必要があった場合は、pyenv が開発ワークフローをいかに簡素化するかが分かるでしょう。

pyenv と詩の統合

pyenv は、依存関係と Python 環境を管理するツールである Poetry と非常によく連携します。すでに Poetry に精通している場合 (そうでない場合は、Poetry の入門に関する私の記事を参照してください)、pyenv と組み合わせることで、プロジェクトをさらに細かく制御できることがわかるでしょう。

Poetry で新しいプロジェクトを作成すると、pyenv がディレクトリに設定した Python バージョンが自動的に使用されます。これにより、プロジェクトの依存関係がプロジェクトの要件に一致する環境で管理されるようになります。

pyenvのインストール

まずはpyenvをインストールしましょう。インストールプロセスはオペレーティングシステムによって異なります。

macOS の場合

自作の使用:

brew update
brew install pyenv

Pyenv が提供する Python に対して誤ってリンクしないようにするには、対話型シェルの設定に次の行を追加します。

• Bash/Zsh:

alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'

• 魚：

alias brew="env PATH=(string replace (pyenv root)/shims '' \"\$PATH\") brew"

Linux の場合

• カールの使用:

curl https://pyenv.run | bash

インストール後、シェル構成ファイル (.bashrc、.zshrc など) に次の内容を追加します。

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

• パッケージマネージャーの使用 Arch Linux では、pacman を使用してインストールできます。

sudo pacman -S pyenv

ターミナルで次のコマンドを実行して、~/.bashrc にコマンドを追加します:

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

Zsh の場合:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

魚の場合:
Fish 3.2.0 以降を使用している場合は、これを対話的に実行します:

set -Ux PYENV_ROOT $HOME/.pyenv
fish_add_path $PYENV_ROOT/bin

それ以外の場合は、以下のスニペットを実行します:

set -Ux PYENV_ROOT $HOME/.pyenv
set -U fish_user_paths $PYENV_ROOT/bin $fish_user_paths

次に、これを ~/.config/fish/config.fish:
に追加します。

pyenv init - | source

詳細については、GitHub をご覧ください。

Pyenvの使用

1) Python のバージョンを確認する

現在使用している Python のバージョンを確認するには:

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)

2) Python バージョンのインストール

pyenv を使用すると、Python の任意のバージョンを簡単にインストールできます:

❯ pyenv install 3.11.9

Python バージョンをインストールした後、プロジェクトに対してグローバルまたはローカルに設定できます

3) グローバル Python バージョンの設定

推奨されません。システムに問題が発生する可能性があります
システム全体でデフォルトで使用されるグローバル Python バージョンを設定できます:

pyenv global 3.10.6 

4) ローカル Python バージョンの設定

特定のプロジェクト ディレクトリにローカル Python バージョンを設定することもできます。そのディレクトリにいるとき、このバージョンはグローバル バージョンをオーバーライドします:

❯ pyenv local 3.8.10

❯ pyenv versions
  system
* 3.11.9 (set by /home/shanu/test_folder/.python-version)

❯ python -V
Python 3.11.9 (my global version is 3.12.5)

設定を解除するには、次を実行するだけです:

❯ pyenv local --unset

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)
  3.11.9

❯ python -V
Python 3.12.5

5) Python バージョンのアンインストール

不要になった Python バージョンをアンインストールするには:

pyenv uninstall 3.11.9

結論

Pyenv は、Python 開発者にとって、特に Poetry と組み合わせて使用​​する場合に非常に貴重なツールです。 Python のバージョンを簡単に管理できるため、バージョンの競合を心配することなく、コードの作成に集中できます。次の Python プロジェクトで試してみてください!