openstack
/
metalsmith
Code Issues Proposed changes

Install all dependencies when building docs 

RTD cannot install several requirements files (SIGH), not does it use
pip to install projects (SIGH#2). This change creates a new requirement
file doc/joined-requirements.txt and links to both doc/requirements.txt
and root requirements.txt from it.

Note that we cannot put -r instructions to doc/requirements.txt since
it's managed by global-requirements.

Change-Id: Iaebf5917dc20d063e506a055d9f5af4daee0415b
This commit is contained in:
Dmitry Tantsur 2018-05-18 17:57:08 +02:00
parent 5fffc7ae2b
commit 9a2fd614ca
2 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/joined-requirements.txt Normal file
View File

@ -0,0 +1,4 @@
# This file is needed because readthedocs people refuse to support several
# requirements files at once, and using autodoc requires installing both.
-r requirements.txt
-r ../requirements.txt

3
tox.ini
View File

@ -31,8 +31,7 @@ commands =
[testenv:docs]
deps =
-c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt}
-r{toxinidir}/requirements.txt
-r{toxinidir}/doc/requirements.txt
-r{toxinidir}/doc/joined-requirements.txt
commands =
sphinx-build -a -E -W -b html doc/source doc/build/html