依存関係グループ
提供: tknotebook
メインページ>コンピュータの部屋#Python>uv tips
依存関係グループ
python のパッケージの「依存関係グループ」 は 2024年10月にPEP 735 で承認された 比較的新しい機能で、uvがv0.4.27(2024年10月)、Poetryがv2.0.0(2025年1月)、pipがv25.1(2025年4月)に 対応しています。
依存関係グループとは パッケージの開発・テスト・デプロイなどの作業工程ごとに必要なツール をグループ分けして 記述しておくものです。
以前は オプショナル依存関係 の中に記述するのが普通でしたが、
- オプショナル依存関係
- 基本機能だけなら不要だが、特定の追加機能を使いたいなら一緒にインストールしてほしいもの
- 依存関係グループ
- 開発・テスト・デプロイなどの作業工程ごとに必要なツール
つまり、パッケージの利用者向けのオプショナル機能がオプショナル依存関係、開発者向けの開発ツールが依存関係グループ 依存関係です。
pyproject.tomlでは
[dependency-groups]
test = [
"pytest>=8.0.0",
]
lint = [
"ruff>=0.4.0",
]
# 他のグループを含めることも可能(PEP 735の標準機能)
dev = [
{include-group = "test"},
{include-group = "lint"},
]
など、パッケージの階層的にグループ分けが可能です。
uvのサポート
uv は既定でパッケージの dev 依存関係グループ をインストールします。 これは uv が開発ツールであることを意識した仕様でしょう。
dev 依存関係グループ をインストールしたくないときは --no-dev でパッケージをインストールします。
[tool.uv] default-groups = ["dev", "foo"]
と書くことで、既定でインストールする 依存関係グループ を変更できます。 任意個の任意グループを既定でインストールするように uv に指示できます。
依存関係グループを一切インストールしたくないときは、--no-default-groups を付けて パッケージをインストールします。
指定 依存関係グループをインストールしたいときは --group XXXX を付けてパッケージをインストールします。