From 431e31c6bce582cf41b186a3838734757971d336 Mon Sep 17 00:00:00 2001
From: M Bussonnier <bussonniermatthias@gmail.com>
Date: Mon, 27 May 2024 15:27:36 +0200
Subject: [PATCH] Use and depend on intersphinx_registry for doc building.

We try to still work if intersphinx_registry is not importable as it
might not be packaged yet, but it is now avail on conda forge, so it
should not be too hard.
---
 docs/requirements.txt |  2 +-
 docs/source/conf.py   | 32 ++++++++++++++++++++++++++++----
 pyproject.toml        |  2 +-
 3 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 15be4264537..9ffcdb18fed 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -9,4 +9,4 @@ matplotlib
 docrepr
 prompt_toolkit
 ipykernel
-stack_data
+intersphinx_registry
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 0f22e547bca..1c1bc2166c6 100755
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -92,12 +92,36 @@
 
 locals().update(config["sphinx"])
 
-intersphinx_mapping = config["intersphinx_mapping"]
-for k, v in intersphinx_mapping.items():
-    intersphinx_mapping[k] = tuple(
-        [intersphinx_mapping[k]["url"], intersphinx_mapping[k]["fallback"]]
+try:
+    from intersphinx_registry import get_intersphinx_mapping
+
+    intersphinx_mapping = get_intersphinx_mapping(
+        packages={
+            "python",
+            "rpy2",
+            "jupyterclient",
+            "jupyter",
+            "jedi",
+            "traitlets",
+            "ipykernel",
+            "prompt_toolkit",
+            "ipywidgets",
+            "ipyparallel",
+            "pip",
+        }
     )
 
+except ModuleNotFoundError:
+    # In case intersphinx_registry is not yet packages on current plaform
+    # as it is quite recent.
+    print("/!\\ intersphinx_registry not installed, relying on local mapping.")
+    intersphinx_mapping = config["intersphinx_mapping"]
+    for k, v in intersphinx_mapping.items():
+        intersphinx_mapping[k] = tuple(
+            [intersphinx_mapping[k]["url"], intersphinx_mapping[k]["fallback"]]
+        )
+
+
 # numpydoc config
 numpydoc_show_class_members = config["numpydoc"][
     "numpydoc_show_class_members"
diff --git a/pyproject.toml b/pyproject.toml
index 671fc2119ba..84bd8a376fa 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -63,6 +63,7 @@ black = [
 doc = [
     "docrepr",
     "exceptiongroup",
+    "intersphinx_registry",
     "ipykernel",
     "ipython[test]",
     "matplotlib",
@@ -70,7 +71,6 @@ doc = [
     "sphinx-rtd-theme",
     "sphinx>=1.3",
     "sphinxcontrib-jquery",
-    "stack_data",
     "tomli ; python_version<'3.11'",
     "typing_extensions",
 ]