目的

最近Pythonに興味があるので環境構築をしたい
とはいえPythonの環境ってバージョン毎の互換性やらパッケージやらが複雑なイメージ
できる限りシンプルで綺麗な環境作るにはどうしたら良いかを学びつつ自分なりの答えをメモ書き

目標

やりたいことは「バージョン管理」と「パッケージ管理」

本記事での「バージョン管理」はPython自体のバージョン管理のこと
「パッケージ管理」はpipで入れるライブラリを指します
(そういう呼び方が正しいかはわかりませんが)

実施環境

CPU: Apple M1 Pro
OS: 13.3.1 (a)
shell: fish

Brew導入済み
https://brew.sh/index_ja

Pythonはpython3.11っていうコマンドが叩ける状態

環境構築

使うのは venvとpyenvだけにした
Anacondaとかいうのがあるらしいけど、pipと競合するとかライブラリが少ないとかややこしいので使わない

venv

パッケージ管理ができるやつ

以下の記事を参考にしました

venvにした理由は

公式推奨機能
Python導入後にさらに追加ライブラリを入れずに実行できるので特に導入作業は無し
簡単に環境を作れる
- 使い方は後述

pyenv

バージョン管理ができるやつ

本当はBrewで入れられるPythonのみで済む方がシンプルですが、使いたいライブラリによっては古いバージョンも必要になったので導入

ちなみにBrewではマイナーバージョンまでは指定できるが、パッチバージョン指定はできず最新のパッチがインストールされる
※ 3.11.1だと3がメジャー、11がマイナー、1がパッチバージョン
(詳しくはセマンティックバージョニングで検索)

公式のREADMEを参考にインストール

$ brew update
$ brew install pyenv

自分はfish shellで作業しているため、インストール後に以下のコマンドを実行

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

その後　~/.config/fish/config.fish に以下を追記

pyenv init - | source

つまづいたところ

configファイルは汚したくなかったし、| sourceの意味もわかっていなかたので勝手にアレンジして以下のコマンドをshellで実施
しかしエラーが発生

$ pyenv init

Add pyenv executable to PATH by running
# the following interactively:

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

# Load pyenv automatically by appending
# the following to ~/.config/fish/config.fish:

pyenv init - | source


# Restart your shell for the changes to take effect.

さらに焦ってconfigにpyenv initを追加したら、エンター押すだけでエラーが出るようになった

理由

pyenv initとpyenv init -は全然違う結果になる

pyenv init はヘルプメッセージを出す役割だった
pyenv init -は実行するpythonコマンドへのPATHを通すための設定を表示する

$ pyenv init - 
while set pyenv_index (contains -i -- "/Users/republicofkorokke/.pyenv/shims" $PATH)
set -eg PATH[$pyenv_index]; end; set -e pyenv_index
set -gx PATH '/Users/republicofkorokke/.pyenv/shims' $PATH
set -gx PYENV_SHELL fish
source '/opt/homebrew/Cellar/pyenv/2.3.17/libexec/../completions/pyenv.fish'
command pyenv rehash 2>/dev/null
function pyenv
  set command $argv[1]
  set -e argv[1]

  switch "$command"
  case rehash shell
    source (pyenv "sh-$command" $argv|psub)
  case '*'
    command pyenv "$command" $argv
  end
end

これを| sourceによって現在のshellに適用していた

使い方

準備は終わり
実質追加で導入が必要なのはpyenvだけだった

実際これらをどう使うかというと

Pythonを使うプロジェクトディレクトリを作成 & 移動

$ mkdir python_test
$ cd python_test

使いたいPythonバージョンを決めてpyenvでインストール
その後そのディレクトリで使うバージョンをpyev localで指定
(こだわりがなければBrewで入れたやつそのままでいいのでこの作業は不要)

$ pyenv install 3.11.0
$ pyenv local 3.11.0

Pythonのバージョンが指定のものになっているか、pathがPYENV_ROOT以下になっているかかチェック
(もしpythonコマンドが叩けない場合はpyenv init - | sourceを実行していないかも?)

$ which python
/Users/republicofkorokke/.pyenv/shims/python

$ python -V
Python 3.11.0

ライブラリ管理のためにvenv作成
その後venvを有効化

$ python -m venv .venv
$ source .venv/bin/activate.fish 

※venvから抜け出すには
$ deactivate

あとはpipで好きなライブラリ入れて遊ぶ
もしvenvを作り直したかったら rm -rfv .venvで削除してから作り直せばOK

注意

一度venvまで作ってからPythonのバージョンを変更したい場合にはvenvも作り直す必要があります

※venvに入ってない状態で
$ python -V
Python 3.11.0

$ pyenv local 3.10.11
$ python -V
Python 3.10.11

$ source .venv/bin/activate.fish 
$ python -V
Python 3.11.0

どうやらvenv自体が作成した際のpythonへのリンクを持っているようで、バージョン変更しても追従してくれません

〆

割と簡単にセットアップできるけど、やりたかったことは実現できました。
とりあえずこのセットで暫く遊ぼうと思います。
もし不満が出たり他にいい方法が見つかったらまた記事にするかも