Handle mock imports for non-platform-agnostic modules

doc/requirements.txt

@@ -1,3 +1,6 @@
 Sphinx
 sphinxcontrib-httpdomain
-sphinx_rtd_theme
+sphinx_rtd_theme
+openflexure-stage
+Pillow
+pyyaml

doc/source/conf.py

@@ -12,10 +12,26 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
+import os
-# import sys
+import sys
-# sys.path.insert(0, os.path.abspath('.'))
 
+# Load module from relative imports
+
+module_path = os.path.abspath('../..')
+sys.path.insert(0, module_path)
+
+# Handle mock imports for non-platform-agnostic modules
+
+from unittest.mock import MagicMock
+
+class Mock(MagicMock):
+    @classmethod
+    def __getattr__(cls, name):
+        return MagicMock()
+
+mock_imports = ['picamera', 'picamera.array', 'picamera.mmalobj']
+
+sys.modules.update((mod_name, Mock()) for mod_name in mock_imports)
 
 # -- Project information -----------------------------------------------------