パッケージ管理したい（`pipx`）

$ pipx install パッケージ名
$ pipx upgrade パッケージ名
$ pipx uninstall パッケージ名

pipxは実行ファイルをローカルな仮想環境にインストールするツールです。 Homebrewでインストールできます。

注意

pipxでインストールできるのはコマンドラインツールとして利用できるパッケージのみです。 pandasなどライブラリとして利用するパッケージはインストールできません。

設定したい（`ensurepath`）

$ brew install pipx
$ brew link pipx
$ pipx ensurepath

pipxをインストールしたら、初回のみ、パスの設定が必要です。 pipx ensurepathで、シェルによらず、PATHに$HOME/.local/binが追加されます。

シェル補完したい

$ register-python-argcomplete --shell fish pipx >~/.config/fish/completions/pipx.fish

register-python-argcompleteでシェル補完機能を追加できます。シェル上でpipxコマンドが補完されるようになるのでとても便利です。

パッケージを一覧したい（`list`）

$ pipx list
venvs are in ~/.local/pipx/venvs
apps are exposed on your $PATH at ~/.local/bin
manual pages are exposed at ~/.local/share/man
   package commitizen 3.29.0, installed using Python 3.12.2
    - cz
    - git-cz
   package mystmd 1.3.4, installed using Python 3.12.5
    - myst
   package poetry 1.8.3, installed using Python 3.12.3
    - poetry

pipx listでインストールしたパッケージを一覧できます。仮想環境（venv）のパスや、インストールに使ったPythonのバージョン、一緒にインストールされた依存パッケージの名前なども確認できます。

一括で更新したい（`upgrade-all`）

$ pipx upgrade-all
upgraded package ruff from 0.1.4 to 0.1.5 (location: ~/.local/pipx/venvs/ruff)
upgraded package streamlit from 1.28.1 to 1.28.2 (location: ~/.local/pipx/venvs/streamlit)
upgraded package poetry from 1.7.0 to 1.7.1 (location: ~/.local/pipx/venvs/poetry)
upgraded package mypy from 1.6.1 to 1.7.0 (location: ~/.local/pipx/venvs/mypy)
upgraded package pyright from 1.1.335 to 1.1.336 (location: ~/.local/pipx/venvs/pyright)

upgrade-allオプションを使って、すべてのパッケージを更新できます。定期的に実行しておくとよいと思います。

一括で再インストールしたい（`reinstall-all`）

$ pipx reinstall-all

Python本体を更新した場合、パッケージの再インストールが必要です。 reinstall-allを使って、すべてのパッケージを再インストールできます。

インストールしたパッケージ

$ pipx install commitizen
$ pipx install jupyter --include-deps
$ pipx install jupytext
$ pipx install mystmd
$ pipx install poetry
$ pipx install pytest
$ pipx install ruff
$ pipx install sphinx
$ pipx install sphinx-autobuild
$ pipx install streamlit

jupyterは、いろいろなサブパッケージに分割されているようです。必要なサブパッケージがわかっていたら、そちらを直接指定すればよいです。とりあえず全部でよい場合は--include-depsでインストールできます。

環境変数をしりたい（`environment`）

$ pipx environment
Environment variables (set by user):

PIPX_HOME=
PIPX_BIN_DIR=
PIPX_MAN_DIR=
PIPX_SHARED_LIBS=
PIPX_DEFAULT_PYTHON=
PIPX_FETCH_MISSING_PYTHON=
USE_EMOJI=

Derived values (computed by pipx):

PIPX_HOME=~/.local/pipx
PIPX_BIN_DIR=~/.local/bin
PIPX_MAN_DIR=~/.local/share/man
PIPX_SHARED_LIBS=~/.local/pipx/shared
PIPX_LOCAL_VENVS=~/.local/pipx/venvs
PIPX_LOG_DIR=~/.local/pipx/logs
PIPX_TRASH_DIR=~/.local/pipx/trash
PIPX_VENV_CACHEDIR=~/.local/pipx/.cache
PIPX_STANDALONE_PYTHON_CACHEDIR=~/.local/pipx/py
PIPX_DEFAULT_PYTHON=/opt/homebrew/opt/python@3.12/libexec/bin/python
USE_EMOJI=true

environmentコマンドで、pipxで有効な環境変数を確認できます。 Python環境は、マシンによって異なる場合があります。ツールがうまく動かない場合の確認作業に役立つかもしれません。

パッケージ管理したい（pipx）

設定したい（ensurepath）

シェル補完したい

パッケージを一覧したい（list）

一括で更新したい（upgrade-all）

一括で再インストールしたい（reinstall-all）