Add option to document integration test providers seperately

docs/conf.py

@@ -287,6 +287,15 @@ for readme_path in glob.glob('../bootstrapvz/plugins/*/README.rst'):
 			include.write('.. include:: ' + path_to_readme)
 
 
+for readme_path in glob.glob('../tests/integration/providers/*/README.rst'):
+	provider_name = os.path.basename(os.path.dirname(readme_path))
+	include_path = os.path.join('testing/integration_test_providers', provider_name + '.rst')
+	if not os.path.exists(include_path):
+		path_to_readme = os.path.join('../../../tests/integration/providers', provider_name, 'README.rst')
+		with open(include_path, 'w') as include:
+			include.write('.. include:: ' + path_to_readme)
+
+
 # -- Create task overview graph data --------------------------------------
 
 from docs import taskoverview

docs/testing/index.rst

@@ -7,6 +7,6 @@ Testing
 
    unit_tests
    integration_tests
-   integration_test_providers
+   integration_test_providers/index
 
 .. include:: ../../tests/README.rst

docs/testing/integration_test_providers.rst

@@ -1 +0,0 @@
-.. include:: ../../tests/integration/providers/README.rst

docs/testing/integration_test_providers/.gitignore

@@ -0,0 +1,3 @@
+*
+!index.rst
+!.gitignore

docs/testing/integration_test_providers/index.rst

@@ -0,0 +1,10 @@
+Integration test providers
+==========================
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   *
+
+.. include:: ../../../tests/integration/providers/README.rst

tests/integration/README.rst

@@ -67,7 +67,7 @@ Missing parts
 -------------
 The integration testing harness is in no way complete.
 
-* It still has no support for providers other than virtualbox and EC2.
+* It still has no support for providers other than Virtualbox, EC2 and Docker.
 * Creating an SSH connection to a booted instance is cumbersome and does not
   happen in any of the tests - this would be particularly useful when manifests
   are to be tested beyond whether they boot up.

tests/integration/providers/README.rst

@@ -1,2 +0,0 @@
-Integration test providers
-==========================

tests/integration/providers/ec2/README.rst

@@ -0,0 +1,2 @@
+EC2
+---

tests/integration/providers/virtualbox/README.rst

@@ -0,0 +1,7 @@
+Virtualbox
+----------
+
+
+Dependencies
+~~~~~~~~~~~~
+vboxapi 1.0