#53 another experiment to get autodoc working

Author: drbenvincent

.isort.cfg

@@ -1,2 +1,2 @@
 [settings]
-known_third_party = arviz,matplotlib,mock,numpy,pandas,patsy,pymc,scipy,seaborn,setuptools,sklearn,statsmodels,xarray
+known_third_party = arviz,matplotlib,numpy,pandas,patsy,pymc,scipy,seaborn,setuptools,sklearn,statsmodels,xarray

.readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.9"
+    python: "3.10"
     # You can also specify other tool versions:
     # nodejs: "16"
     # rust: "1.55"

docs/conf.py

@@ -16,16 +16,33 @@
 
 
 # Need to mock the package dependencies in order for autodoc to work when docs are remotely built on readthedocs
-from mock import Mock as MagicMock
+# from mock import Mock as MagicMock
 
 
-class Mock(MagicMock):
-    @classmethod
-    def __getattr__(cls, name):
-        return MagicMock()
+# class Mock(MagicMock):
+#     @classmethod
+#     def __getattr__(cls, name):
+#         return MagicMock()
 
 
-MOCK_MODULES = [
+# MOCK_MODULES = [
+#     "arviz",
+#     "matplotlib",
+#     "numpy",
+#     "pandas",
+#     "patsy",
+#     "pymc",
+#     "scipy",
+#     "seaborn",
+#     "sklearn",
+#     "xarray",
+# ]
+# sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
+
+# autodoc_mock_imports
+# This avoids autodoc breaking when it can't find packages imported in the code.
+# https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autodoc_mock_imports
+autodoc_mock_imports = [
     "arviz",
     "matplotlib",
     "numpy",
@@ -37,7 +54,6 @@ def __getattr__(cls, name):
     "sklearn",
     "xarray",
 ]
-sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
 
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
@@ -96,19 +112,3 @@ def __getattr__(cls, name):
     "github_version": "master",  # Version
     "conf_py_path": "/docs/",  # Path in the checkout to the docs root
 }
-
-# # autodoc_mock_imports
-# # This avoids autodoc breaking when it can't find packages imported in the code.
-# # https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autodoc_mock_imports
-# autodoc_mock_imports = [
-#     "arviz",
-#     "matplotlib",
-#     "numpy",
-#     "pandas",
-#     "patsy",
-#     "pymc",
-#     "scipy",
-#     "seaborn",
-#     "sklearn",
-#     "xarray",
-# ]

requirements-docs.txt

@@ -1,6 +1,6 @@
 ipykernel
 linkify-it-py
-mock
+# mock
 myst_parser
 nbsphinx
 pathlib