refactor: use dependency groups (#195)

* refactor: use dependency groups

Signed-off-by: nstarman <nstarman@users.noreply.github.com>

* docs: fix building

Signed-off-by: nstarman <nstarman@users.noreply.github.com>

---------

Signed-off-by: nstarman <nstarman@users.noreply.github.com>

Author: nstarman

.github/workflows/ci.yml

@@ -48,7 +48,8 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install --upgrade --no-cache-dir -e '.[dev]'
+          python -m pip install --no-cache-dir --group dev
+          python -m pip install --no-cache-dir -e .
           ${{ matrix.value.extra-install }}
       - name: Test linter assertions
         run: |

.pre-commit-config.yaml

@@ -11,7 +11,7 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.16
+    rev: v0.23
     hooks:
       - id: validate-pyproject
 

.readthedocs.yaml

@@ -4,16 +4,17 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.12"
+    nodejs: "20"
   jobs:
+    install:
+        # Since the install step is overridden, pip is no longer updated automatically.
+        - pip install --upgrade pip
+        - pip install --group 'docs' .
+
     pre_build:
       # Generate the Sphinx configuration for this Jupyter Book, so it builds.
       - "jupyter-book config sphinx docs/"
 
-python:
-  install:
-    - method: pip
-      path: ".[dev]"
-
 sphinx:
   builder: html
   fail_on_warning: true

pyproject.toml

@@ -23,31 +23,36 @@ dependencies = [
     "rich>=10.0"
 ]
 
-[project.optional-dependencies]
-dev = [
-    "numpy",
-    "pytest>=6",
-    "pytest-cov",
-    "coveralls",
-    "pre-commit",
-    "IPython",
-    "black==23.9.0",
-    "ghp-import",
-    "wheel",
-    "build",
-    "tox",
-    "jupyter-book",
-    "mypy",
-    "pyright>=1.1.331",
-    "ruff>=0.2.1",
-    "sybil",
-]
-
 [project.urls]
 repository = "https://github.com/beartype/plum"
 documentation = "https://beartype.github.io/plum"
 
 
+[dependency-groups]
+dev = [
+    { include-group = "docs" },
+    { include-group = "lint" },
+    { include-group = "test" },
+]
+docs = [
+    "jupyter-book>=1.0.0,<2.0.0",
+]
+lint = [
+    "pre-commit>=4.3.0",
+]
+test = [
+    "coveralls>=4.0.1",
+    "ipython>=8.18.1",
+    "mypy>=1.18.2",
+    "numpy>=2.0.2",
+    "pyright>=1.1.331",
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
+    "sybil[pytest]>=9.2.0",
+    "tox>=4.30.3",
+]
+
+
 [build-system]
 requires = ["hatchling>=1.8.0", "hatch-vcs"]
 build-backend = "hatchling.build"