ci: Run doctests

Signed-off-by: John Andersen <[email protected]>

Author: pdxjohnny

.ci/run.sh

@@ -127,6 +127,9 @@ function run_docs() {
   "${PYTHON}" -m pip install --prefix=~/.local -U -e "${SRC_ROOT}[dev]"
   "${PYTHON}" -m dffml service dev install -user
 
+  # Doctests
+  ./scripts/doctest.sh
+
   # Make master docs
   master_docs="$(mktemp -d)"
   TEMP_DIRS+=("${master_docs}")

.gitignore

@@ -23,3 +23,4 @@ examples/shouldi/response.json
 docs/plugins/service/http
 *pip-wheel-metadata/
 *.gz
+doctest/

CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   are a list or a dict where the values are of the `spec` type. Rather than the
   list or dict itself being of the `spec` type.
 - Fixed the URL mentioned in example to configure a model.
+- Sphinx doctests are now run in the CI in the DOCS task.
 ### Removed
 - Unused imports
 

scripts/doctest.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+set -e
+
+rm -rf doctest
+python3.7 -c 'import os, pkg_resources; [e.load() for e in pkg_resources.iter_entry_points("console_scripts") if e.name.startswith("sphinx-build")][0]()' -b doctest docs doctest