add support for testing .md notebooks

Author: Conengmo

requirements-dev.txt

@@ -14,6 +14,7 @@ gpxpy
 ipykernel
 jenkspy
 jupyter
+jupytext
 matplotlib
 mypy
 nbconvert

tests/selenium/test_selenium.py

@@ -18,6 +18,7 @@ def find_notebooks():
     pattern = os.path.join(path, "..", "..", "examples", "*.ipynb")
     files = glob.glob(pattern)
     files = [f for f in files if not f.endswith(".nbconvert.ipynb")]
+    files.extend(glob.glob(os.path.join(path, "..", "..", "docs", "*.md")))
     if files:
         return files
     else:
@@ -42,18 +43,29 @@ def test_notebook(filepath, driver):
 
 def get_notebook_html(filepath_notebook):
     """Store iframes from a notebook in html files, remove them when done."""
-    # run the notebook to make sure the output is up-to-date
-    subprocess.run(
-        [
-            "jupyter",
-            "nbconvert",
-            "--to",
-            "notebook",
-            "--execute",
-            filepath_notebook,
-        ]
-    )
-    filepath_notebook = filepath_notebook.replace(".ipynb", ".nbconvert.ipynb")
+    if filepath_notebook.endswith(".ipynb"):
+        subprocess.run(
+            [
+                "jupyter",
+                "nbconvert",
+                "--to",
+                "notebook",
+                "--execute",
+                filepath_notebook,
+            ]
+        )
+        filepath_notebook = filepath_notebook.replace(".ipynb", ".nbconvert.ipynb")
+    else:
+        subprocess.run(
+            [
+                "jupytext",
+                "--to",
+                "notebook",
+                "--execute",
+                filepath_notebook,
+            ]
+        )
+        filepath_notebook = filepath_notebook.replace(".md", ".ipynb")
 
     html_exporter = nbconvert.HTMLExporter()
     body, _ = html_exporter.from_filename(filepath_notebook)