Fix apidoc build

Change-Id: Id7c5686cdbdc79812e06eb4a5f87eddc75005cc3

doc/requirements.txt

@@ -0,0 +1,5 @@
+doc8>=0.6.0 # Apache-2.0
+sphinx>=2.0.0,!=2.1.0 # BSD
+openstackdocstheme>=2.2.1 # Apache-2.0
+reno>=3.1.0 # Apache-2.0
+sphinxcontrib-apidoc>=0.2.0  # BSD

doc/source/conf.py

@@ -4,6 +4,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.autodoc',
               'sphinx.ext.viewcode',
+              'sphinxcontrib.apidoc',
               'openstackdocstheme',
               ]
 
@@ -36,6 +37,14 @@ add_module_names = True
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'native'
 
+# sphinxcontrib.apidoc options
+apidoc_module_dir = '../../ironic_python_agent'
+apidoc_output_dir = 'contributor/api'
+apidoc_excluded_paths = [
+    'tests',
+]
+apidoc_separate_modules = True
+
 
 # -- Options for HTML output --------------------------------------------------
 

doc/source/contributor/index.rst

@@ -29,7 +29,7 @@ Generated Developer Documentation
 .. toctree::
    :hidden:
 
-   api/autoindex
+   api/modules
 
 Indices and tables
 ==================

test-requirements.txt

@@ -10,8 +10,5 @@ bashate>=0.5.1 # Apache-2.0
 flake8-import-order>=0.17.1 # LGPLv3
 bandit!=1.6.0,>=1.1.0,<2.0.0 # Apache-2.0
 
-# Doc requirements
+# Doc test requirements
 doc8>=0.6.0 # Apache-2.0
-sphinx>=2.0.0,!=2.1.0 # BSD
-openstackdocstheme>=2.2.1 # Apache-2.0
-reno>=3.1.0 # Apache-2.0

tox.ini

@@ -62,6 +62,8 @@ commands = oslo_debug_helper -t ironic_python_agent/tests/unit {posargs}
 [testenv:docs]
 setenv = PYTHONHASHSEED=0
 sitepackages = False
+deps =
+  -r{toxinidir}/doc/requirements.txt
 commands =
   sphinx-build -b html doc/source doc/build/html
 
@@ -69,6 +71,8 @@ commands =
 whitelist_externals = make
 setenv = PYTHONHASHSEED=0
 sitepackages = False
+deps =
+  -r{toxinidir}/doc/requirements.txt
 commands =
   sphinx-build -b latex doc/source doc/build/pdf
   make -C doc/build/pdf