add testbook to automate re-running jupyter notebooks and see if they…

… still seem to work

pyproject.toml

@@ -66,6 +66,7 @@ hypothesis = "^6.58.0"
 frozendict = "^2.3.4"
 # somesy = {path = "../somesy", develop = true}
 notebook = "^7.0.2"
+testbook = "^0.4.2"
 
 [tool.poetry.group.docs.dependencies]
 mkdocs = "^1.4.2"

tests/zz_docs/test_notebooks.py

@@ -0,0 +1,24 @@
+import os
+from pathlib import Path
+
+import pytest
+from testbook import testbook
+
+
+@pytest.fixture(scope="module")
+def nb_cwd():
+    """Fixture to change CWD to location of notebooks."""
+    old = os.getcwd()
+    nb_dir = Path("./docs/notebooks")
+    assert nb_dir.is_dir()
+    os.chdir(nb_dir)
+    yield None
+    os.chdir(old)
+
+
+def test_notebooks_execute(nb_cwd):
+    """Test that all tutorial notebooks run through without exceptions."""
+    for nb_file in Path(".").glob("*.ipynb"):
+        with testbook(nb_file, execute=True):
+            # just check it runs fine
+            print(f"Notebook {nb_file} run complete.")