From 77d0b112cb8211d3e033c502f35c96d230b78647 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 16 Dec 2024 12:43:18 +0000
Subject: [PATCH] Clean up optional dependency groups (#2541)

* Clean up optional dependency groups

* Fix hatch envs

* Remove jupyter extra

* Drop upath and tree dependency groups

* Change fsspec group to remote group

* Add a v3 what's new

* Fix optional group

* Fix spelling

---------

Co-authored-by: Joe Hamman <joe@earthmover.io>
---
 docs/guide/index.rst       |  1 +
 docs/guide/whatsnew_v3.rst | 14 ++++++++++++++
 pyproject.toml             | 33 ++++++++++-----------------------
 3 files changed, 25 insertions(+), 23 deletions(-)
 create mode 100644 docs/guide/whatsnew_v3.rst

diff --git a/docs/guide/index.rst b/docs/guide/index.rst
index f841dbb85d..e532a13e20 100644
--- a/docs/guide/index.rst
+++ b/docs/guide/index.rst
@@ -4,5 +4,6 @@ Guide
 .. toctree::
     :maxdepth: 1
 
+    whatsnew_v3
     storage
     consolidated_metadata
diff --git a/docs/guide/whatsnew_v3.rst b/docs/guide/whatsnew_v3.rst
new file mode 100644
index 0000000000..302c3cf20c
--- /dev/null
+++ b/docs/guide/whatsnew_v3.rst
@@ -0,0 +1,14 @@
+What's new in v3
+================
+
+This page gives an overview of major changes and additions in version 3.
+
+
+Dependencies
+------------
+- The new ``remote`` dependency group can be used to install a supported version of
+  ``fsspec``, required for remote data access.
+- The new ``gpu`` dependency group can be used to install a supported version of
+  ``cuda``, required for GPU functionality.
+- The ``jupyter`` optional dependency group has been removed, since v3 contains no
+  jupyter specific functionality.
diff --git a/pyproject.toml b/pyproject.toml
index 5f2d7569b9..b438a2c292 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -53,9 +53,14 @@ license = {text = "MIT License"}
 keywords = ["Python", "compressed", "ndimensional-arrays", "zarr"]
 
 [project.optional-dependencies]
-fsspec = [
+# User extras
+remote = [
     "fsspec>=2023.10.0",
 ]
+gpu = [
+    "cupy-cuda12x",
+]
+# Development extras
 test = [
     "coverage",
     "pytest",
@@ -68,15 +73,7 @@ test = [
     "hypothesis",
     "universal-pathlib",
 ]
-
-jupyter = [
-    'notebook',
-    'ipytree>=0.2.2',
-    'ipywidgets>=8.0.0',
-]
-gpu = [
-    "cupy-cuda12x",
-]
+optional = ["rich", "universal-pathlib"]
 docs = [
     'sphinx==8.1.3',
     'sphinx-autobuild>=2021.3.14',
@@ -87,19 +84,9 @@ docs = [
     'pydata-sphinx-theme',
     'numpydoc',
     'numcodecs[msgpack]',
-    'msgpack',
-]
-extra = [
-    'msgpack',
-]
-optional = [
-    'universal-pathlib>=0.0.22',
-    'rich'
-]
-tree = [
-    'rich',
 ]
 
+
 [project.urls]
 "Bug Tracker" = "https://github.com/zarr-developers/zarr-python/issues"
 Changelog = "https://zarr.readthedocs.io/en/stable/release.html"
@@ -129,7 +116,7 @@ dependencies = [
     "numpy~={matrix:numpy}",
     "universal_pathlib",
 ]
-features = ["test", "extra"]
+features = ["test"]
 
 [[tool.hatch.envs.test.matrix]]
 python = ["3.11", "3.12", "3.13"]
@@ -160,7 +147,7 @@ dependencies = [
     "numpy~={matrix:numpy}",
     "universal_pathlib",
 ]
-features = ["test", "extra", "gpu"]
+features = ["test", "gpu"]
 
 [[tool.hatch.envs.gputest.matrix]]
 python = ["3.11", "3.12", "3.13"]