Fix docs build
- fixed recursion error in templates.rst - docs/source/modules added to .gitignore - added setup.cfg to put html docs to right place - docs renamed to doc (convention for openstack community) Change-Id: I530228d0a764302ad7ca9d71be98856188c3fdcb
This commit is contained in:
parent
cc2032fbca
commit
94c32c0a34
|
@ -48,7 +48,9 @@ coverage.xml
|
|||
*.log
|
||||
|
||||
# Sphinx documentation
|
||||
docs/_build/
|
||||
doc/build/
|
||||
# autogenerated doc sources
|
||||
doc/source/modules/
|
||||
|
||||
# PyBuilder
|
||||
target/
|
||||
|
|
|
@ -13,24 +13,27 @@
|
|||
# serve to show the default.
|
||||
|
||||
import os
|
||||
import sys
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
sys.path.insert(0, os.path.abspath('.'))
|
||||
sys.path.insert(0, os.path.abspath('../'))
|
||||
sys.path.insert(0, os.path.abspath('../../'))
|
||||
|
||||
import glob
|
||||
from sphinx.apidoc import main as sphinx_apidoc_main
|
||||
import shutil
|
||||
|
||||
shutil.rmtree('modules', ignore_errors=True)
|
||||
|
||||
# remove autogenerated rst files
|
||||
for f in glob.glob('modules/*.rst'):
|
||||
os.remove(f)
|
||||
|
||||
# generate docs
|
||||
sphinx_apidoc_main([
|
||||
'',
|
||||
'-o',
|
||||
'modules',
|
||||
'../../devops'
|
||||
# output dir
|
||||
'-o', 'modules',
|
||||
# source dir
|
||||
'../../devops',
|
||||
# exclude dirs
|
||||
'../../devops/settings.py',
|
||||
'../../devops/test_settings.py',
|
||||
'../../devops/migrations/',
|
||||
'../../devops/tests/',
|
||||
'../../devops/templates/',
|
||||
])
|
||||
|
||||
# -- General configuration ----------------------------------------------------
|
||||
|
@ -81,8 +84,7 @@ release = '3.0.0'
|
|||
# List of patterns, relative to source directory, that match files and
|
||||
# directories to ignore when looking for source files.
|
||||
exclude_patterns = [
|
||||
'**test**',
|
||||
'**migration**',
|
||||
# NOTE: use sphinx_apidoc_main to exclude source dirs
|
||||
]
|
||||
|
||||
# The reST default role (used for this markup: `text`) to use for
|
|
@ -0,0 +1 @@
|
|||
This folder contains auto generated files. Please don't change them directly.
|
|
@ -29,7 +29,9 @@ a baremetal lab (requires the [1] merged to fuel-qa).
|
|||
|
||||
[1] https://review.openstack.org/#/c/292977/
|
||||
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
---
|
||||
aliases:
|
||||
|
|
@ -25,6 +25,7 @@ by most of fuel-qa system tests:
|
|||
* DRIVER_USE_HOST_CPU: CPU type used by VMs can be copied from the host
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
---
|
||||
aliases:
|
||||
|
|
@ -15,6 +15,7 @@ All slave nodes have only two network interfaces:
|
|||
'public', 'management', 'storage' and 'private'.
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
---
|
||||
aliases:
|
||||
|
|
@ -1,12 +1,15 @@
|
|||
.. _templates:
|
||||
|
||||
Templates
|
||||
=========
|
||||
|
||||
YAML fuel-devops templates are used for creating virtual environments
|
||||
which describe
|
||||
|
||||
|
||||
Structure of the YAML template for environment creation
|
||||
=======================================================
|
||||
|
||||
|
||||
YAML template for fuel-devops contains the following objects:
|
||||
|
||||
.. code-block:: yaml
|
||||
|
@ -59,9 +62,10 @@ YAML template for fuel-devops contains the following objects:
|
|||
See detailed examples here:
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:glob:
|
||||
:maxdepth: 1
|
||||
|
||||
templates
|
||||
template_examples/*
|
||||
|
||||
|
||||
===============================
|
|
@ -1,22 +0,0 @@
|
|||
devops.driver.dummy package
|
||||
===========================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.driver.dummy.dummy_driver module
|
||||
---------------------------------------
|
||||
|
||||
.. automodule:: devops.driver.dummy.dummy_driver
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.driver.dummy
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,22 +0,0 @@
|
|||
devops.driver.ipmi package
|
||||
==========================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.driver.ipmi.ipmi_driver module
|
||||
-------------------------------------
|
||||
|
||||
.. automodule:: devops.driver.ipmi.ipmi_driver
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.driver.ipmi
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,30 +0,0 @@
|
|||
devops.driver.libvirt package
|
||||
=============================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.driver.libvirt.libvirt_driver module
|
||||
-------------------------------------------
|
||||
|
||||
.. automodule:: devops.driver.libvirt.libvirt_driver
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.driver.libvirt.libvirt_xml_builder module
|
||||
------------------------------------------------
|
||||
|
||||
.. automodule:: devops.driver.libvirt.libvirt_xml_builder
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.driver.libvirt
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,19 +0,0 @@
|
|||
devops.driver package
|
||||
=====================
|
||||
|
||||
Subpackages
|
||||
-----------
|
||||
|
||||
.. toctree::
|
||||
|
||||
devops.driver.dummy
|
||||
devops.driver.ipmi
|
||||
devops.driver.libvirt
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.driver
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,70 +0,0 @@
|
|||
devops.helpers package
|
||||
======================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.helpers.helpers module
|
||||
-----------------------------
|
||||
|
||||
.. automodule:: devops.helpers.helpers
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.network module
|
||||
-----------------------------
|
||||
|
||||
.. automodule:: devops.helpers.network
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.node_manager module
|
||||
----------------------------------
|
||||
|
||||
.. automodule:: devops.helpers.node_manager
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.ntp module
|
||||
-------------------------
|
||||
|
||||
.. automodule:: devops.helpers.ntp
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.retry module
|
||||
---------------------------
|
||||
|
||||
.. automodule:: devops.helpers.retry
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.scancodes module
|
||||
-------------------------------
|
||||
|
||||
.. automodule:: devops.helpers.scancodes
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.helpers.templates module
|
||||
-------------------------------
|
||||
|
||||
.. automodule:: devops.helpers.templates
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.helpers
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,30 +0,0 @@
|
|||
devops.migrations package
|
||||
=========================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.migrations.0001_initial module
|
||||
-------------------------------------
|
||||
|
||||
.. automodule:: devops.migrations.0001_initial
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.migrations.0002_add_field_created module
|
||||
-----------------------------------------------
|
||||
|
||||
.. automodule:: devops.migrations.0002_add_field_created
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.migrations
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,54 +0,0 @@
|
|||
devops.models package
|
||||
=====================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.models.base module
|
||||
-------------------------
|
||||
|
||||
.. automodule:: devops.models.base
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.models.environment module
|
||||
--------------------------------
|
||||
|
||||
.. automodule:: devops.models.environment
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.models.network module
|
||||
----------------------------
|
||||
|
||||
.. automodule:: devops.models.network
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.models.node module
|
||||
-------------------------
|
||||
|
||||
.. automodule:: devops.models.node
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.models.volume module
|
||||
---------------------------
|
||||
|
||||
.. automodule:: devops.models.volume
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.models
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,49 +0,0 @@
|
|||
devops package
|
||||
==============
|
||||
|
||||
Subpackages
|
||||
-----------
|
||||
|
||||
.. toctree::
|
||||
|
||||
devops.driver
|
||||
devops.helpers
|
||||
devops.migrations
|
||||
devops.models
|
||||
devops.tests
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.error module
|
||||
-------------------
|
||||
|
||||
.. automodule:: devops.error
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.settings module
|
||||
----------------------
|
||||
|
||||
.. automodule:: devops.settings
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.shell module
|
||||
-------------------
|
||||
|
||||
.. automodule:: devops.shell
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,62 +0,0 @@
|
|||
devops.tests package
|
||||
====================
|
||||
|
||||
Submodules
|
||||
----------
|
||||
|
||||
devops.tests.factories module
|
||||
-----------------------------
|
||||
|
||||
.. automodule:: devops.tests.factories
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.tests.test_helpers module
|
||||
--------------------------------
|
||||
|
||||
.. automodule:: devops.tests.test_helpers
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.tests.test_manager module
|
||||
--------------------------------
|
||||
|
||||
.. automodule:: devops.tests.test_manager
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.tests.test_scancodes module
|
||||
----------------------------------
|
||||
|
||||
.. automodule:: devops.tests.test_scancodes
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.tests.test_shell module
|
||||
------------------------------
|
||||
|
||||
.. automodule:: devops.tests.test_shell
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
devops.tests.use_cases module
|
||||
-----------------------------
|
||||
|
||||
.. automodule:: devops.tests.use_cases
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
|
||||
Module contents
|
||||
---------------
|
||||
|
||||
.. automodule:: devops.tests
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
|
@ -1,7 +0,0 @@
|
|||
devops
|
||||
======
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 4
|
||||
|
||||
devops
|
Loading…
Reference in New Issue