MNT: Sync doc-requirements with pyproject.toml

Author: effigies

doc-requirements.txt

@@ -1,6 +1,7 @@
-# Requirements for building docs
+# Auto-generated by tools/update_requirements.py
 -r requirements.txt
-sphinx<3
+matplotlib >= 1.5.3
 numpydoc
+sphinx ~= 5.3
 texext
-matplotlib >=1.3.1
+tomli; python_version < "3.11"

tools/update_requirements.py

@@ -11,10 +11,12 @@
 pyproject_toml = repo_root / "pyproject.toml"
 reqs = repo_root / "requirements.txt"
 min_reqs = repo_root / "min-requirements.txt"
+doc_reqs = repo_root / "doc-requirements.txt"
 
 with open(pyproject_toml, 'rb') as fobj:
     config = tomli.load(fobj)
 requirements = config["project"]["dependencies"]
+doc_requirements = config["project"]["optional-dependencies"]["doc"]
 
 script_name = Path(__file__).relative_to(repo_root)
 
@@ -27,3 +29,7 @@
 # Write minimum requirements
 lines[1:-1] = [req.replace(">=", "==").replace("~=", "==") for req in requirements]
 min_reqs.write_text("\n".join(lines))
+
+# Write documentation requirements
+lines[1:-1] = ["-r requirements.txt"] + doc_requirements
+doc_reqs.write_text("\n".join(lines))