Move from extras to dependency-groups (#240)

* Move from extras to dependency-groups

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: gaborbernat

.readthedocs.yml

@@ -1,15 +1,8 @@
 version: 2
 build:
-  os: ubuntu-22.04
-  tools:
-    python: "3"
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
-sphinx:
-  builder: html
-  configuration: docs/conf.py
-  fail_on_warning: true
+  os: ubuntu-lts-latest
+  tools: {}
+  commands:
+    - curl -LsSf https://astral.sh/uv/install.sh | sh
+    - ~/.local/bin/uv tool install tox --with tox-uv -p 3.14 --managed-python
+    - ~/.local/bin/tox run -e docs -- $READTHEDOCS_OUTPUT/html

pyproject.toml

@@ -49,21 +49,43 @@ dependencies = [
   "packaging>=25",
   "tomli>=2.3; python_version<'3.11'",
 ]
-optional-dependencies.docs = [
-  "furo>=2025.9.25",
-  "sphinx-autodoc-typehints>=3.5.1",
-]
-optional-dependencies.testing = [
+urls.Changelog = "https://github.com/tox-dev/pyproject-api/releases"
+urls.Homepage = "https://pyproject-api.readthedocs.io"
+urls.Source = "https://github.com/tox-dev/pyproject-api"
+urls.Tracker = "https://github.com/tox-dev/pyproject-api/issues"
+
+[dependency-groups]
+dev = [
+  { include-group = "docs" },
+  { include-group = "lint" },
+  { include-group = "pkg-meta" },
+  { include-group = "test" },
+  { include-group = "type" },
+]
+test = [
   "covdefaults>=2.3",
   "pytest>=8.4.2",
   "pytest-cov>=7",
   "pytest-mock>=3.15.1",
   "setuptools>=80.9",
 ]
-urls.Changelog = "https://github.com/tox-dev/pyproject-api/releases"
-urls.Homepage = "https://pyproject-api.readthedocs.io"
-urls.Source = "https://github.com/tox-dev/pyproject-api"
-urls.Tracker = "https://github.com/tox-dev/pyproject-api/issues"
+type = [
+  "ty>=0.0.17",
+  { include-group = "docs" },
+  { include-group = "test" },
+]
+docs = [
+  "furo>=2025.9.25",
+  "sphinx-autodoc-typehints>=3.5.1",
+]
+lint = [
+  "pre-commit-uv>=4.1.5",
+]
+pkg-meta = [
+  "check-wheel-contents>=0.6.3",
+  "twine>=6.2",
+  "uv>=0.9",
+]
 
 [tool.hatch]
 build.hooks.vcs.version-file = "src/pyproject_api/_version.py"

tox.toml

@@ -6,7 +6,7 @@ skip_missing_interpreters = true
 description = "run the unit tests with pytest under {env_name}"
 package = "wheel"
 wheel_build_env = ".pkg"
-extras = [ "testing" ]
+dependency_groups = [ "test" ]
 pass_env = [ "DIFF_AGAINST", "PYTEST_*" ]
 set_env.COVERAGE_FILE = { replace = "env", name = "COVERAGE_FILE", default = "{work_dir}{/}.coverage.{env_name}" }
 set_env.COVERAGE_PROCESS_START = "{tox_root}/pyproject.toml"
@@ -37,26 +37,25 @@ commands = [
 
 [env.docs]
 description = "build documentation"
-extras = [ "docs" ]
+dependency_groups = [ "docs" ]
 commands = [
   [
     "sphinx-build",
     "-d",
     "{env_tmp_dir}{/}doc_tree",
     "docs",
-    "{work_dir}{/}docs_out",
     "--color",
     "-b",
     "html",
-    { replace = "posargs", extend = true, default = [ "-W" ] },
+    { replace = "posargs", extend = true, default = [ "-W", "{work_dir}{/}docs_out" ] },
   ],
   [ "python", "-c", 'print(r"documentation available under file://{work_dir}{/}docs_out{/}index.html")' ],
 ]
 
 [env.fix]
 description = "run static analysis and style check using flake8"
 package = "skip"
-deps = [ "pre-commit-uv>=4.1.5" ]
+dependency_groups = [ "lint" ]
 pass_env = [ "HOMEPATH", "PROGRAMDATA" ]
 commands = [
   [ "pre-commit", "run", "--all-files", "--show-diff-on-failure" ],
@@ -66,7 +65,7 @@ commands = [
 [env.pkg_meta]
 description = "check that the long description is valid"
 skip_install = true
-deps = [ "check-wheel-contents>=0.6.3", "twine>=6.2", "uv>=0.9" ]
+dependency_groups = [ "pkg-meta" ]
 commands = [
   [ "uv", "build", "--sdist", "--wheel", "--out-dir", "{env_tmp_dir}", "." ],
   [ "twine", "check", "{env_tmp_dir}{/}*" ],
@@ -75,14 +74,13 @@ commands = [
 
 [env.type]
 description = "run type check on code base"
-deps = [ "ty>=0.0.17" ]
-extras = [ "docs", "testing" ]
+dependency_groups = [ "type" ]
 commands = [ [ "ty", "check", "--output-format", "concise", "--error-on-warning", "." ] ]
 
 [env.dev]
 description = "generate a DEV environment"
 package = "editable"
-extras = [ "testing" ]
+dependency_groups = [ "dev" ]
 commands = [
   [ "uv", "pip", "tree" ],
   [ "python", "-c", "import sys; print(sys.executable)" ],