Add test documentation for docs tox target
Enable sphinx to generate documentation from docstrings by running 'tox -e docs'. Change-Id: I5996e5f07493f69f14172b4bb0535852e89d5456
This commit is contained in:
parent
9aa8eb4530
commit
f2e985e8fd
1
.gitignore
vendored
1
.gitignore
vendored
@ -43,6 +43,7 @@ output/*/index.html
|
|||||||
|
|
||||||
# Sphinx
|
# Sphinx
|
||||||
doc/build
|
doc/build
|
||||||
|
doc/source/tests
|
||||||
|
|
||||||
# pbr generates these
|
# pbr generates these
|
||||||
AUTHORS
|
AUTHORS
|
||||||
|
@ -15,7 +15,14 @@
|
|||||||
import os
|
import os
|
||||||
import sys
|
import sys
|
||||||
|
|
||||||
sys.path.insert(0, os.path.abspath('../..'))
|
def autodoc_skip_member_handler(app, what, name, obj, skip, options):
|
||||||
|
return skip or (what == "class" and not name.startswith("test"))
|
||||||
|
|
||||||
|
def setup(app):
|
||||||
|
app.connect('autodoc-skip-member', autodoc_skip_member_handler)
|
||||||
|
|
||||||
|
sys.path.insert(0, os.path.abspath('../../neutron_tempest_plugin'))
|
||||||
|
|
||||||
# -- General configuration ----------------------------------------------------
|
# -- General configuration ----------------------------------------------------
|
||||||
|
|
||||||
# Add any Sphinx extension module names here, as strings. They can be
|
# Add any Sphinx extension module names here, as strings. They can be
|
||||||
|
@ -15,6 +15,7 @@ Contents:
|
|||||||
readme
|
readme
|
||||||
installation
|
installation
|
||||||
contributing
|
contributing
|
||||||
|
test_descriptions
|
||||||
|
|
||||||
Indices and tables
|
Indices and tables
|
||||||
==================
|
==================
|
||||||
|
7
doc/source/test_descriptions.rst
Normal file
7
doc/source/test_descriptions.rst
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
Description of Tests
|
||||||
|
====================
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 2
|
||||||
|
|
||||||
|
tests/modules
|
@ -68,6 +68,8 @@ class BgpClientMixin(object):
|
|||||||
class Bgp(BgpClientMixin, base.BaseTempestTestCase):
|
class Bgp(BgpClientMixin, base.BaseTempestTestCase):
|
||||||
"""Test the following topology
|
"""Test the following topology
|
||||||
|
|
||||||
|
.. code-block:: HTML
|
||||||
|
|
||||||
+-------------------+
|
+-------------------+
|
||||||
| public |
|
| public |
|
||||||
| network |
|
| network |
|
||||||
|
@ -173,6 +173,9 @@ class NetworkConnectivityTest(base.BaseTempestTestCase):
|
|||||||
ensures that connectivity from VM to both routers is working.
|
ensures that connectivity from VM to both routers is working.
|
||||||
|
|
||||||
Test scenario: (NOTE: 10.1.0.0/24 private CIDR is used as an example)
|
Test scenario: (NOTE: 10.1.0.0/24 private CIDR is used as an example)
|
||||||
|
|
||||||
|
.. code-block:: HTML
|
||||||
|
|
||||||
+----------------+ +------------+
|
+----------------+ +------------+
|
||||||
| Non-dvr router | | DVR router |
|
| Non-dvr router | | DVR router |
|
||||||
| | | |
|
| | | |
|
||||||
|
@ -89,8 +89,8 @@ class InternalDNSTest(InternalDNSBase):
|
|||||||
|
|
||||||
1) Create two VMs on the same network, giving each a name
|
1) Create two VMs on the same network, giving each a name
|
||||||
2) SSH in to the first VM:
|
2) SSH in to the first VM:
|
||||||
2.1) ping the other VM's internal IP
|
- ping the other VM's internal IP
|
||||||
2.2) ping the other VM's hostname
|
- ping the other VM's hostname
|
||||||
"""
|
"""
|
||||||
network = self.create_network(dns_domain='starwars.')
|
network = self.create_network(dns_domain='starwars.')
|
||||||
self.setup_network_and_server(network=network, server_name='luke')
|
self.setup_network_and_server(network=network, server_name='luke')
|
||||||
|
@ -34,9 +34,10 @@ class VPNaaSTestJSON(base.BaseAdminNetworkTest):
|
|||||||
|
|
||||||
Tests the following operations in the Neutron API using the REST client for
|
Tests the following operations in the Neutron API using the REST client for
|
||||||
Neutron:
|
Neutron:
|
||||||
List, Show, Create, Delete, and Update VPN Service
|
|
||||||
List, Show, Create, Delete, and Update IKE policy
|
* List, Show, Create, Delete, and Update VPN Service
|
||||||
List, Show, Create, Delete, and Update IPSec policy
|
* List, Show, Create, Delete, and Update IKE policy
|
||||||
|
* List, Show, Create, Delete, and Update IPSec policy
|
||||||
"""
|
"""
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
|
@ -52,6 +52,8 @@ CONF.register_opt(
|
|||||||
class Vpnaas(base.BaseTempestTestCase):
|
class Vpnaas(base.BaseTempestTestCase):
|
||||||
"""Test the following topology
|
"""Test the following topology
|
||||||
|
|
||||||
|
.. code-block:: HTML
|
||||||
|
|
||||||
+-------------------+
|
+-------------------+
|
||||||
| public |
|
| public |
|
||||||
| network |
|
| network |
|
||||||
|
9
tox.ini
9
tox.ini
@ -40,8 +40,15 @@ commands =
|
|||||||
|
|
||||||
[testenv:docs]
|
[testenv:docs]
|
||||||
deps = -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
|
deps = -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
|
||||||
|
-r{toxinidir}/requirements.txt
|
||||||
-r{toxinidir}/doc/requirements.txt
|
-r{toxinidir}/doc/requirements.txt
|
||||||
commands = sphinx-build -W -b html doc/source doc/build/html
|
commands =
|
||||||
|
rm -rf doc/source/tests
|
||||||
|
sphinx-apidoc -f -o doc/source/tests neutron_tempest_plugin
|
||||||
|
rm -rf doc/build
|
||||||
|
sphinx-build -W -b html doc/source doc/build/html
|
||||||
|
allowlist_externals =
|
||||||
|
rm
|
||||||
|
|
||||||
[testenv:releasenotes]
|
[testenv:releasenotes]
|
||||||
deps = {[testenv:docs]deps}
|
deps = {[testenv:docs]deps}
|
||||||
|
Loading…
Reference in New Issue
Block a user