「依存関係グループ」の版間の差分
(→uvのサポート) |
(→uvのサポート) |
||
| 41行: | 41行: | ||
==uvのサポート== | ==uvのサポート== | ||
| + | |||
| + | ===uv add=== | ||
| + | |||
| + | uv は | ||
| + | uv add --dev <パッケージ名> | ||
| + | や | ||
| + | uv add --group グループ名 パッケージ名 | ||
| + | で、パッケージを依存関係グループのパッケージとしてプロジェクトに追加できます。 | ||
| + | |||
| + | ===依存関係グループを持つパッケージのインストール=== | ||
| + | |||
uv は既定でパッケージの dev 依存関係グループ をインストールします。 | uv は既定でパッケージの dev 依存関係グループ をインストールします。 | ||
これは uv が開発ツールであることを意識した仕様でしょう。 | これは uv が開発ツールであることを意識した仕様でしょう。 | ||
2026年11月18日 (水) 10:32時点における版
メインページ>コンピュータの部屋#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 add
uv は
uv add --dev <パッケージ名>
や
uv add --group グループ名 パッケージ名
で、パッケージを依存関係グループのパッケージとしてプロジェクトに追加できます。
依存関係グループを持つパッケージのインストール
uv は既定でパッケージの dev 依存関係グループ をインストールします。 これは uv が開発ツールであることを意識した仕様でしょう。
PEP735 以降 パッケージの開発ツールは dev依存関係グループに収めるのが習慣化しつつあるからです。
dev 依存関係グループ をインストールしたくないときは --no-dev でパッケージをインストールします。
pyproject.toml に
[tool.uv] default-groups = ["dev", "foo"]
と書くことで、uv が既定でインストールする 依存関係グループ を変更できます。 任意個の任意グループを既定でインストールするように uv に指示できます。
これに逆らって依存関係グループを一切インストールしたくないときは、--no-default-groups を付けて パッケージをインストールします。
指定 依存関係グループをインストールしたいときは、pip と同様 --group XXXX を付けてパッケージをインストールします。