Enable doctests

Author: dstansby

pyproject.toml

@@ -68,6 +68,7 @@ test = [
     "pytest-cov",
     "s3fs",
     "pytest-asyncio",
+    "pytest-doctestplus",
     "moto[s3]",
     "requests",
     "mypy",
@@ -136,7 +137,7 @@ numpy = ["1.25", "2.1"]
 features = ["gpu"]
 
 [tool.hatch.envs.test.scripts]
-run-coverage = "pytest --cov-config=pyproject.toml --cov=pkg --cov=src"
+run-coverage = "pytest --cov-config=pyproject.toml --cov=pkg --cov=src --doctest-rst"
 run-coverage-gpu = "pip install cupy-cuda12x && pytest -m gpu --cov-config=pyproject.toml --cov=pkg --cov=src"
 run = "run-coverage --no-cov"
 run-verbose = "run-coverage --verbose"