docs: isolate docs requirements and add API server dependencies

This will allow us to build the docs properly for hosting on
readthedocs.

Change-Id: I6770146239350c1b4e0bed880a3bc9c7239eaa79

doc/requirements.txt

@@ -0,0 +1,14 @@
+sphinx>=1.4
+sphinx-rtd-theme
+sphinxcontrib-programoutput
+
+# For programoutput, we need to include server extra dependencies from setup.cfg
+Django>=2.1.5
+djangorestframework>=3.9.1
+django-cors-headers
+django-filter
+django-health-check
+dynaconf[yaml]
+tzlocal
+whitenoise
+pygments

test-requirements.txt

@@ -2,8 +2,7 @@ factory-boy
 bandit>=1.1.0 # Apache-2.0
 coverage
 flake8
-sphinx>=1.4
-sphinx-rtd-theme
-sphinxcontrib-programoutput
 black==19.3b0 # Exact version for prerelease
 isort
+
+# requirements for docs are in doc/requirements.txt

tox.ini

@@ -16,9 +16,11 @@ extras = server
 commands = {posargs}
 
 [testenv:docs]
+deps = -r{toxinidir}/doc/requirements.txt
 commands =
   sphinx-build -W -b html doc/source doc/build/html
 setenv =
+  # programoutput might end up creating things, don't pollute outside of tov envtmpdir
   ARA_BASE_DIR={env:ARA_BASE_DIR:{envtmpdir}}
 
 [testenv:linters]