「依存関係グループ」の版間の差分

提供: tknotebook
移動: 案内、 検索
(ページの作成:「Category:コンピュータCategory:Python メインページ>コンピュータの部屋#Python>uv tips ==依存関係グループ== python ...」)
 
(→‎依存関係グループ)
 
(1人の利用者による、間の1版が非表示)
18行: 18行:
 
:開発・テスト・デプロイなどの作業工程ごとに必要なツール
 
:開発・テスト・デプロイなどの作業工程ごとに必要なツール
  
−
つまり、パッケージの利用者向けのオプショナル機能がオプショナル依存関係、開発者向けの開発ツールが依存関係グループ
+
つまり、パッケージの利用者向けのオプショナル機能がオプショナル依存関係、開発者向けの開発ツールが依存関係グループです。
−
依存関係です。
+
  
 
pyproject.tomlでは
 
pyproject.tomlでは
35行: 34行:
 
  ]
 
  ]
  
−
など、パッケージの階層的にグループ分けが可能です。
+
など、パッケージを階層的にグループ分けすることが可能です。
  
 
==uvのサポート==
 
==uvのサポート==

2026年11月17日 (火) 10:00時点における最新版

メインページ>コンピュータの部屋#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 を付けてパッケージをインストールします。