Store documentation requirements in requirements-docs.txt

Author: smokestacklightnin

.github/workflows/cd-docs.yml

@@ -39,7 +39,7 @@ jobs:
             mkdocs-material-
 
       - name: Install Dependencies
-        run: pip install mkdocs mkdocs-material mkdocstrings[python] griffe-inherited-docstrings mkdocs-autorefs black mkdocs-jupyter mkdocs-caption
+        run: pip install -r requirements-docs.txt
 
       - name: Deploy to GitHub Pages
         run: mkdocs gh-deploy --force

requirements-docs.txt

@@ -0,0 +1,8 @@
+mkdocs
+mkdocs-material
+mkdocstrings[python]
+griffe-inherited-docstrings
+mkdocs-autorefs
+black
+mkdocs-jupyter
+mkdocs-caption

setup.py

@@ -129,6 +129,11 @@ def run(self):
 with open('README.md') as fp:
   _LONG_DESCRIPTION = fp.read()
 
+# Get documentation build requirements
+with open("requirements-docs.txt", "r") as fp:
+  docs_reqs = fp.readlines()
+docs_reqs = [req.replace("\n", "") for req in docs_reqs]
+
 setup(
     name='ml-metadata',
     version=__version__,
@@ -167,15 +172,7 @@ def run(self):
         'six>=1.10,<2',
     ],
     # TODO: Pin versions for docs
-    extras_require={"docs": ["mkdocs",
-                             "mkdocs-material",
-                             "mkdocstrings[python]",
-                             "griffe-inherited-docstrings",
-                             "mkdocs-autorefs",
-                             "black",
-                             "mkdocs-caption"
-                             ]
-    }
+    extras_require={"docs": docs_reqs}
     python_requires='>=3.9,<4',
     packages=find_packages(),
     include_package_data=True,