Fix for readthedocs

docs/Makefile

@@ -23,11 +23,10 @@ test:	Makefile
 
 clean:	Makefile
 	rm -f api.rst
-	rm -rf api/*
+	rm -rf api/*.rst
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	python gen_api.py
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/conf.py

@@ -17,6 +17,11 @@
 
 import pyaml
 
+# Generate reference API
+from pyaml.apidoc.gen_api import gen_doc
+
+gen_doc()
+
 # -- Project information -----------------------------------------------------
 
 project = "Python Accelerator Middle Layer"

docs/gen_api.py → pyaml/apidoc/gen_api.py

@@ -153,16 +153,17 @@ def generate_toctree(filename: str, title: str, level: int, module: str):
 
 
 # Generate toctrees
-sys.stdout.write("Generating API")
-sys.stdout.flush()
-paths = generate_toctree("api.rst", "API Reference", 0, "pyaml")
-level = 1
-while len(paths) > 0:
-    npaths = []
-    for p in paths:
-        npaths.extend(
-            generate_toctree(f"api/{'pyaml.' + p}.rst", f"{p}", level, "pyaml." + p)
-        )
-    paths = npaths
-    level += 1
-print("done")
+def gen_doc():
+    sys.stdout.write("Generating API")
+    sys.stdout.flush()
+    paths = generate_toctree("api.rst", "API Reference", 0, "pyaml")
+    level = 1
+    while len(paths) > 0:
+        npaths = []
+        for p in paths:
+            npaths.extend(
+                generate_toctree(f"api/{'pyaml.' + p}.rst", f"{p}", level, "pyaml." + p)
+            )
+        paths = npaths
+        level += 1
+    print("done")