🐣

uv の依存グループは自身で定義できる

に公開

(下準備)

% mkdir sample-project && cd sample-project
% uv init
% uv add fastapi
% git add .

通常用意されている --dev グループもあるが,

% uv add --dev pytest
Resolved 14 packages in 98ms
Prepared 2 packages in 51ms
Installed 2 packages in 3ms
 + gunicorn==23.0.0
 + packaging==25.0
pyproject.toml
diff --git a/pyproject.toml b/pyproject.toml
index be7c450..6005ec7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -7,3 +7,8 @@ requires-python = ">=3.13"
 dependencies = [
     "fastapi>=0.121.1",
 ]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.0",
+]

次のように, 自身でグループを定義することも可能.

% uv add --group prod gunicorn
pyproject.toml
diff --git a/pyproject.toml b/pyproject.toml
index 6005ec7..b55b40a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,3 +12,6 @@ dependencies = [
 dev = [
     "pytest>=9.0.0",
 ]
+prod = [
+    "gunicorn>=23.0.0",
+]

本番用の依存関係を Dockerfile で RUN uv add gunicorn する, みたいなことをしなくてよいのです. 🎉
(↑の pyproject.toml であれば, デプロイ時は uv sync --no-dev でいいですね 👌
CI 環境では --no-group prod をつけるとよいでしょうか 💡)

ぜひ公式ドキュメントを確認してください.
See: https://docs.astral.sh/uv/concepts/projects/dependencies/#dependency-groups

Discussion