Fix broken readthedocs workflow (#1539)

.github/workflows/docs.yml

@@ -14,12 +14,9 @@ jobs:
       uses: actions/setup-python@v4
       with:
         python-version: '3.10'
-    - name: Install asreview
+    - name: Install ASReview with docs dependencies
       run: |
-        python -m pip install .
-    - name: Install docs dependencies
-      run: |
-        python -m pip install -r docs/requirements.txt
+        python -m pip install .[docs]
     - name: Build HTML
       run: |
         python -m sphinx -W --keep-going --color docs/source/ build/html/

.readthedocs.yaml

@@ -13,5 +13,7 @@ formats:
    - htmlzip
 
 python:
-   install:
-   - requirements: docs/requirements.txt
+  install:
+    - path: .
+      extra_requirements:
+        - docs

DEVELOPMENT.md

@@ -282,7 +282,7 @@ or PDF files.
 Install the dependencies for rendering the documentation with
 
 ```
-pip install -r docs/requirements.txt
+pip install .[docs]
 ```
 
 Navigate into the `docs` folder and render the documentation (the HTML version) with

docs/source/conf.py

@@ -30,36 +30,18 @@
 
 # -- Mock
 autodoc_mock_imports = [
-    "numpy",
-    "modAL",
-    "modAL.models",
-    "modAL.utils.data",
-    "modAL.utils.selection",
-    "rispy",
-    "pandas",
     "tensorflow",
     "tensorflow.keras",
     "tensorflow.keras.wrappers.scikit_learn",
     "tensorflow.keras.models",
     "tensorflow.keras.models.layers",
     "tensorflow.keras.optimizers",
     "tensorflow.keras.constraints",
-    "tqdm",
-    "sklearn",
-    "sklearn.naive_bayes",
-    "sklearn.svm",
-    "sklearn.base",
-    "sklearn.exceptions",
-    "scipy",
-    "fuzzywuzzy",
-    "dill",
-    "PyInquirer",
     "gensim",
-    "gensim.utils" "gensim.models.doc2vec",
+    "gensim.utils",
+    "gensim.models.doc2vec",
     "sentence_transformers",
     "sentence_transformers.SentenceTransformer",
-    "jsonschema",
-    "filelock",
 ]
 
 

setup.py

@@ -83,6 +83,14 @@ def get_long_description():
     "tensorflow": ["tensorflow~=2.0"],
     "dev": ["black", "check-manifest", "flake8", "flake8-isort", "isort"],
     "test": ["coverage", "pytest", "pytest-random-order"],
+    "docs": [
+        "ipython",
+        "sphinx",
+        "sphinx_rtd_theme",
+        "sphinx-reredirects",
+        "sphinxcontrib-youtube",
+        "nbsphinx",
+    ],
 }
 DEPS["all"] = DEPS["sbert"] + DEPS["doc2vec"]
 DEPS["all"] += DEPS["tensorflow"]
@@ -113,12 +121,12 @@ def run(self):
         subprocess.check_call(
             ["npm", "install"],
             cwd=str(path_webapp),
-            shell=(platform.system() == "Windows")
+            shell=(platform.system() == "Windows"),
         )
         subprocess.check_call(
             ["npm", "run-script", "build"],
             cwd=str(path_webapp),
-            shell=(platform.system() == 'Windows')
+            shell=(platform.system() == "Windows"),
         )
 
 
@@ -194,7 +202,7 @@ def get_cmdclass():
         "asreview.datasets": [
             "benchmark = asreview.datasets:BenchmarkDataGroup",
             "benchmark-nature = asreview.datasets:NaturePublicationDataGroup",
-            "synergy = asreview.datasets:SynergyDataGroup"
+            "synergy = asreview.datasets:SynergyDataGroup",
         ],
         "asreview.models.classifiers": [
             "svm = asreview.models.classifiers:SVMClassifier",