ci: switch to dependency groups (#149)

Author: flying-sheep

.readthedocs.yml

@@ -1,14 +1,18 @@
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
 version: 2
 build:
   os: ubuntu-24.04
   tools:
-    python: "3.12"
-sphinx:
-  configuration: docs/conf.py
-  fail_on_warning: true
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+    python: '3.14'
+  jobs:
+    post_checkout:
+    # unshallow so version can be derived from tag
+    - git fetch --unshallow || true
+    create_environment:
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    build:
+      html:
+      - uvx hatch run docs:build
+      - mv docs/_build $READTHEDOCS_OUTPUT

pyproject.toml

@@ -24,49 +24,54 @@ classifiers = [
 ]
 dynamic = [ "description", "version" ]
 dependencies = [  ]
-optional-dependencies.docs = [
-  "click!=8.3",
+optional-dependencies.jupyter = [ "ipywidgets" ]
+urls.Documentation = "https://session-info2.readthedocs.io/"
+urls.Issues = "https://github.com/flying-sheep/session-info2/issues"
+urls.Source = "https://github.com/flying-sheep/session-info2"
+scripts.session-info = "session_info2.cli:main"
+scripts.session-info2 = "session_info2.cli:main" # So `uvx session-info2` works
+
+[dependency-groups]
+test = [
+  "coverage[toml]>=6.5",
+  "ipykernel",
+  "jupyter-client",
+  "pytest",
+  "pytest-asyncio",
+  "pytest-md",               # For GitHub report
+  "pytest-subprocess",
+  "testing-common-database", # Example package as “test data”
+]
+docs = [
+  "click>=8.3.1",
   "furo",
   "hatch",
-  "myst-nb",
+  "ipywidgets",
+  "myst-nb>=1.3",
   "session-info2[notebook]",
   "sphinx",
   "sphinx-autodoc-typehints",
   "sphinx-codeautolink",
 ]
-optional-dependencies.jupyter = [ "ipywidgets" ]
 # Dependencies needed to run the notebook
-optional-dependencies.notebook = [
+notebook = [
   "numpy",
   "session-info",
   "session-info2[jupyter]",
 ]
-optional-dependencies.test = [
-  "coverage[toml]>=6.5",
-  "ipykernel",
-  "jupyter-client",
-  "pytest",
-  "pytest-asyncio",
-  "pytest-md",               # For GitHub report
-  "pytest-subprocess",
-  "testing-common-database", # Example package as “test data”
-]
-urls.Documentation = "https://github.com/flying-sheep/session-info2#readme"
-urls.Issues = "https://github.com/flying-sheep/session-info2/issues"
-urls.Source = "https://github.com/flying-sheep/session-info2"
-scripts.session-info = "session_info2.cli:main"
-scripts.session-info2 = "session_info2.cli:main" # So `uvx session-info2` works
 
-[tool.hatch.envs.docs]
+[tool.hatch.envs.default]
 installer = "uv"
-features = [ "docs" ]
+
+[tool.hatch.envs.docs]
+dependency-groups = [ "docs" ]
 scripts.build = "sphinx-build -W --keep-going -b html docs docs/_build/html {args}"
 scripts.open = "python3 -m webbrowser -t docs/_build/html/index.html"
 scripts.clean = "git clean -fdX -- {args:docs}"
 
 [tool.hatch.envs.hatch-test]
 default-args = [  ]
-features = [ "test" ]
+dependency-groups = [ "test" ]
 extra-dependencies = [ "pyinstrument" ]
 overrides.matrix.deps.features = [
   { if = [ "all" ], value = "jupyter" },
@@ -77,8 +82,7 @@ python = [ "3.14", "3.10" ]
 deps = [ "all", "min" ]
 
 [tool.hatch.envs.notebook]
-# installer = "uv"  # https://github.com/astral-sh/uv/issues/6032
-features = [ "notebook" ]
+dependency-groups = [ "notebook" ]
 extra-dependencies = [ "ipykernel" ]
 scripts.install-kernel = "python -m ipykernel install --user --name=session-info2 --display-name=session-info2 --env COLUMNS 110"