replace nbsphinx with myst-nb and remove pin on ipython (#2838)

Author: valeriupredoi

.circleci/config.yml

@@ -34,6 +34,7 @@ commands:
             pip check
             pytest -n 4 --junitxml=test-reports/report.xml << parameters.args >>
             esmvaltool version
+            esmvaltool -- --help
       - store_test_results:
           path: test-reports/report.xml
       - store_artifacts:

doc/conf.py

@@ -57,7 +57,7 @@
 # ones.
 extensions = [
     'autodocsumm',
-    'nbsphinx',
+    'myst_nb',
     'sphinx.ext.autodoc',
     'sphinx.ext.doctest',
     'sphinx.ext.extlinks',
@@ -78,6 +78,9 @@
     'autosummary': True,
 }
 
+# Don't execute notebooks
+nb_execution_mode = "off"
+
 # Show type hints in function signature AND docstring
 autodoc_typehints = 'both'
 

environment.yml

@@ -52,9 +52,9 @@ dependencies:
   - zarr >3
   # Python packages needed for building docs
   - autodocsumm >=0.2.2
-  - ipython <9.0  # github.com/ESMValGroup/ESMValCore/issues/2680
-  - nbsphinx >=0.9.7  # github.com/ESMValGroup/ESMValCore/issues/2669
-  - sphinx >=6.1.3,<8.2  # Upper pin is a requirement of nbsphinx 0.9.7
+  - ipython
+  - myst-nb
+  - sphinx >=6.1.3
   - pydata-sphinx-theme
   # Python packages needed for testing
   - pre-commit

pyproject.toml

@@ -91,8 +91,8 @@ test = [
 ]
 doc = [
     "autodocsumm>=0.2.2",
-    "ipython<9.0",  # github.com/ESMValGroup/ESMValCore/issues/2680
-    "nbsphinx>=0.9.7",  # github.com/ESMValGroup/ESMValCore/issues/2669
+    "ipython",
+    "myst-nb",
     "sphinx>=6.1.3",
     "pydata_sphinx_theme",
 ]