chore: use dependency-groups (#624)

Using dependency groups.

---------

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

.github/workflows/ci.yml

@@ -28,6 +28,7 @@ jobs:
   checks:
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         python-version:
         - "3.9"
@@ -54,17 +55,17 @@ jobs:
 
     - name: Install package
       if: matrix.python-version == '3.14'
-      run: uv pip install -e ".[test]"
+      run: uv pip install -e. --group test
 
     - name: Install package (dask)
       if: matrix.python-version != '3.14'
-      run: uv pip install -e ".[test,dask]"
+      run: uv pip install -e ".[dask]" --group test
 
     - name: Test package
       run: .venv/bin/python -m pytest
 
     - name: Install plotting requirements too
-      run: uv pip install -e ".[test,plot]"
+      run: uv pip install -e ".[plot]"
 
     - name: Test plotting too
       run: .venv/bin/python -m pytest --mpl

.readthedocs.yml

@@ -14,5 +14,5 @@ build:
     - asdf install uv latest
     - asdf global uv latest
     - uv venv
-    - uv pip install -e .[docs]
+    - uv pip install -e. --group docs
     - . .venv/bin/activate && sphinx-build -T -b html -d docs/_build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html

noxfile.py

@@ -43,7 +43,7 @@ def tests(session):
     """
     Run the unit and regular tests.
     """
-    session.install("-e", ".[test,plot]")
+    session.install("-e.[plot]", "--group=test")
     args = ["--mpl"] if sys.platform.startswith("linux") else []
     session.run("pytest", *args, *session.posargs)
 
@@ -54,7 +54,7 @@ def minimums(session):
     Run with the minimum dependencies.
     """
 
-    session.install("-e", ".[test]", "--resolution=lowest-direct")
+    session.install("-e.", "--group=test", "--resolution=lowest-direct")
     session.run("pytest", *session.posargs)
 
 
@@ -63,7 +63,7 @@ def regenerate(session):
     """
     Regenerate MPL images.
     """
-    session.install("-e", ".[test,plot]")
+    session.install("-e.[plot]", "--group=test")
     if not sys.platform.startswith("linux"):
         session.error(
             "Must be run from Linux, images will be slightly different on macOS"
@@ -85,7 +85,7 @@ def docs(session: nox.Session) -> None:
 
     serve = args.builder == "html" and session.interactive
     extra_installs = ["sphinx-autobuild"] if serve else []
-    session.install("-e.[docs]", *extra_installs)
+    session.install("-e.", "--group=docs", *extra_installs)
 
     session.chdir("docs")
 
@@ -107,7 +107,12 @@ def docs(session: nox.Session) -> None:
 @nox.session(reuse_venv=True, default=False)
 def build_api_docs(session: nox.Session) -> None:
     """
-    Build (regenerate) API docs.
+    Build (regenerate) API docs. Requires Linux.
+
+    For example:
+
+        docker run -v $PWD:/histogram -w /histogram -it quay.io/pypa/manylinux_2_28_x86_64
+        uvx nox -s regenerate
     """
 
     session.install("sphinx")

pyproject.toml

@@ -54,6 +54,7 @@ Discussions = "https://github.com/scikit-hep/hist/discussions"
 Changelog = "https://hist.readthedocs.io/en/latest/changelog.html"
 
 [project.optional-dependencies]
+# Keep in sync with dependency-groups below
 mpl = [
     "matplotlib >=3.3.3",
     "mplhep >=0.3.17",
@@ -63,32 +64,51 @@ plot = [
     "mplhep >=0.3.17",
 ]
 fit = [
-    "scipy >=1.4",
+    "scipy >=1.5.4",
     "iminuit >=2",
 ]
 dask = [
     "dask[dataframe] >=2022,<2025",
     "dask_histogram >=2023.1",
 ]
+
+[dependency-groups]
+plot = [
+    "matplotlib >=3.3.3",
+    "mplhep >=0.3.17",
+]
+fit = [
+    "scipy >=1.5.4",
+    "iminuit >=2; python_version<'3.14'",
+]
+dask = [
+    "dask[dataframe] >=2022,<2025",
+    "dask_histogram >=2023.1",
+]
 test = [
+    { include-group = "test-core" },
+    { include-group = "fit" },
+]
+test-core = [
     "pytest >=8",
     "pytest-mpl >=0.12",
-    "hist[plot]",
+    { include-group = "plot" },
 ]
 dev = [
-    "hist[mpl,fit,test,dask]",
     "ipykernel",
+    { include-group = "test" },
+    { include-group = "plot" },
+    { include-group = "dask" },
 ]
 docs = [
-    "hist[test,plot,fit,dask]",
+    { include-group = "dev" },
     "ipython_genutils",
     "nbsphinx",
     "sphinx >=3.0.0",
     "sphinx_copybutton",
     "sphinx_book_theme >=0.0.38",
     "sphinxcontrib-programoutput",
     "ipython",
-    "ipykernel",
     "pillow",
     "uncertainties>=3",
     "myst_parser>=0.14",