Add docs target to tox.ini

Also fixes tempest imports related errors and adds warnerrors=True
for pbr in setup.cfg.

Change-Id: Ib27b5de1f014ebae0b66e945ed5a7628913c3a41

doc/source/conf.py

@@ -37,6 +37,11 @@ add_module_names = True
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
 
+# A list of glob-style patterns that should be excluded when looking for
+# source files. They are matched against the source file names relative to the
+# source directory, using slashes as directory separators on all platforms.
+exclude_patterns = ['api/ironicclient.tests.functional.*']
+
 # -- Options for HTML output --------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages. Major themes that come with

setup.cfg

@@ -59,6 +59,9 @@ openstack.baremetal.v1 =
 
 [pbr]
 autodoc_index_modules = True
+autodoc_exclude_modules =
+    ironicclient.tests.functional.*
+warnerrors = True
 
 [build_sphinx]
 all_files = 1

tox.ini

@@ -38,6 +38,13 @@ commands = {posargs}
 setenv = TESTS_DIR=./ironicclient/tests/functional
          LANGUAGE=en_US
 
+[testenv:docs]
+setenv = PYTHONHASHSEED=0
+sitepackages = False
+envdir = {toxworkdir}/venv
+commands =
+  python setup.py build_sphinx
+
 [flake8]
 ignore =
 exclude = .venv,.git,.tox,dist,doc,*lib/python*,*egg,build,tools