Add mktestdocs

Author: domna

docs/tutorial/simple_fit.md

@@ -23,6 +23,7 @@ We'll also import the function `fit` from pyEllis fitting module.
 This is a function decorator, which we will use to display our interactive fitting widget.
 
 ```python
+import numpy as np
 import elli
 from elli.fitting import ParamsHist, fit
 ```
@@ -105,6 +106,7 @@ In the last step we just need to evaluate our model for a set of wavelengths (`l
 Additionally, we need the specify the solver (`elli.Solver2x2` in this case).
 
 ```python
+lbda = np.linspace(210, 800, 100)
 structure.evaluate(lbda, ANGLE, solver=elli.Solver2x2)
 ```
 

pyproject.toml

@@ -51,6 +51,7 @@ dev = [
     "nbmake",
     "ruff==0.8.5",
     "pre-commit",
+    "mktestdocs>=0.2.5",
 ]
 docs = [
     "mkdocs-material",

tests/test_docs.py

@@ -0,0 +1,11 @@
+import os
+import pathlib
+
+from mktestdocs import check_md_file
+
+
+def test_simple_fit():
+    proj_dir = pathlib.Path(__file__).resolve().parent / ".."
+    os.chdir(proj_dir / "examples" / "Basic Usage")
+    fpath = proj_dir / "docs" / "tutorial" / "simple_fit.md"
+    check_md_file(fpath=fpath, memory=True)