Use intersphinx-registry in docs build (#578)

Author: Schefflera-Arboricola

docs/rtd_environment.yml

@@ -41,4 +41,5 @@ dependencies:
       - types-jinja2  # dev, tests
       - sqlalchemy-stubs  # dev, tests
       - sphinxcontrib-mermaid  # dev, tests, docs
+      - intersphinx-registry  # docs
       - fides==0.7.4  # dev, tests

docs/source/conf.py

@@ -19,6 +19,8 @@
 import os
 from importlib.metadata import version
 
+from intersphinx_registry import get_intersphinx_mapping
+
 year = dt.datetime.now().year
 
 author = "Janos Gabler"
@@ -88,11 +90,9 @@
     "gh": ("https://github.com/optimagic-dev/optimagic/pulls/%s", "#"),
 }
 
-intersphinx_mapping = {
-    "numpy": ("https://docs.scipy.org/doc/numpy", None),
-    "pandas": ("https://pandas.pydata.org/pandas-docs/stable", None),
-    "python": ("https://docs.python.org/3.12", None),
-}
+intersphinx_mapping = get_intersphinx_mapping(
+    packages={"numpy", "scipy", "pandas", "python"}
+)
 
 linkcheck_ignore = [
     r"https://tinyurl\.com/*.",

environment.yml

@@ -30,6 +30,7 @@ dependencies:
   - sphinx-design  # docs
   - sphinx-panels  # docs
   - sphinxcontrib-bibtex  # docs
+  - intersphinx-registry  # docs
   - seaborn  # dev, tests
   - mypy=1.14.1  # dev, tests
   - pyyaml  # dev, tests