Merge "Follow the new PTI for document build"

doc/requirements.txt

@@ -0,0 +1,13 @@
+# The order of packages is significant, because pip processes them in the order
+# of appearance. Changing the order has an impact on the overall integration
+# process, which may cause wedges in the gate later.
+# Order matters to the pip dependency resolver, so sorting this file
+# changes how packages are installed.  New dependencies should be
+# added in alphabetical order, however, some dependencies may need to
+# be installed in a specific order.
+openstackdocstheme>=1.18.1 # Apache-2.0
+reno>=2.5.0 # Apache-2.0
+sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD
+
+# The below is rewquired to build testing module reference
+mock>=2.0.0 # BSD

doc/source/conf.py

@@ -34,6 +34,7 @@ import django
 # Ignore warnings from openstack_dashboard.settings in the doc build.
 # This can be dropped once Sphinx correctly ignore such warnings.
 logging.getLogger('openstack_dashboard.settings').setLevel(logging.ERROR)
+logging.getLogger('horizon.test.helpers').setLevel(logging.ERROR)
 
 
 BASE_DIR = os.path.dirname(os.path.abspath(__file__))

setup.cfg

@@ -32,12 +32,6 @@ packages =
     openstack_dashboard
     openstack_auth
 
-[build_sphinx]
-all-files = 1
-warning-is-error = 1
-build-dir = doc/build
-source-dir = doc/source
-
 [nosetests]
 verbosity=2
 detailed-errors=1

test-requirements.txt

@@ -21,11 +21,8 @@ nose-exclude>=0.3.0 # LGPL
 nosexcover>=1.0.10 # BSD
 nosehtmloutput>=0.0.3 # Apache-2.0
 openstack.nose-plugin>=0.7 # Apache-2.0
-openstackdocstheme>=1.18.1 # Apache-2.0
-reno>=2.5.0 # Apache-2.0
 requests>=2.14.2 # Apache-2.0
 selenium>=2.50.1 # Apache-2.0
-sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD
 testscenarios>=0.4 # Apache-2.0/BSD
 testtools>=2.2.0 # MIT
 # This also needs xvfb library installed on your OS

tox.ini

@@ -46,6 +46,10 @@ commands =
     bash {toxinidir}/tools/unit_tests.sh {envpython} {toxinidir} {posargs}
 
 [testenv:pep8]
+# sphinx (precisely Pygments) needs to be installed to make doc8 work properly
+deps =
+  {[testenv]deps}
+  -r{toxinidir}/doc/requirements.txt
 commands =
   flake8 {posargs}
   {envpython} {toxinidir}/manage.py extract_messages --verbosity 0 --check-only
@@ -117,13 +121,21 @@ commands =
   {[unit_tests]commands}
 
 [testenv:docs]
+# We need to install horizon dependecies to build module references
+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
 commands =
-  doc8 doc/source
   sphinx-build -W -b html doc/source doc/build/html
 
 [testenv:releasenotes]
+# There is no need to install horizon.
+usedevelop = False
+deps =
+  -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt}
+  -r{toxinidir}/doc/requirements.txt
 commands =
-  doc8 releasenotes/source releasenotes/notes
   sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
 
 [testenv:manage]