Workaround for LMDB import.

docs/Makefile

@@ -4,8 +4,9 @@
 # You can set these variables from the command line.
 SPHINXOPTS    =
 # Workaround to prevent lmdb from throwing an exception when loaded from Sphinx
-SPHINXBUILD   = python -m sphinx
-#SPHINXBUILD   = sphinx-build
+# Does not work with readthedocs unfortunately.
+#SPHINXBUILD   = python -m sphinx
+SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = lakesuperior
 SOURCEDIR     = .
 BUILDDIR      = _build

docs/conf.py

@@ -24,8 +24,20 @@
 
 #sys.path.insert(0, os.path.abspath('../'))
 sys.path.append(os.path.abspath('../'))
+
+class MockModule(MagicMock):
+    @classmethod
+    def __getattr__(cls, name):
+        return MagicMock()
+
+# LMDB raises an issue if imported by Sphinx. This bypasses the issue.
+# https://github.com/dw/py-lmdb/issues/172
+MOCK_MODULES = ['lmdb']
+sys.modules.update((mod_name, MockModule()) for mod_name in MOCK_MODULES)
+
 import lakesuperior.env_setup
 
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -174,17 +186,6 @@
      'Miscellaneous'),
 ]
 
-
-
-
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {'https://docs.python.org/': None}
 
-class Mock(MagicMock):
-    @classmethod
-    def __getattr__(cls, name):
-        return MagicMock()
-
-MOCK_MODULES = ['lmdb']
-sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
-