cloudbridge/test/__init__.py

"""
Tests the functionality of each provider implementation against registered
test cases. These tests require that provider credentials are set as
environment variables, as required for each provider (see `tox.ini` for a list
of env variables).

Since the tests exercise the ``cloudbridge`` interfaces, and there are multiple
implementations of these interfaces, for m interfaces and n implementation,
exercising all interfaces means that m*n test case classes are needed.
Otherwise, the standard test runners such as unittest and nose2 do not
correctly pick up the tests.

To avoid an explosion of repetitive test cases, the
``ProviderTestCaseGenerator`` class will automatically generate a new Python
class for each combination of test and provider. The ``load_tests`` protocol
(https://docs.python.org/2/library/unittest.html#load-tests-protocol)
is used to aid test discovery.

Use ``python setup.py test`` to run these unit tests (alternatively, use
``python -m unittest test``).

All test cases need to be registered below, and available providers will be
discovered through the ``ProviderFactory``. Test Cases must not inherit from
``unittest.TestCase``, to avoid confusing unittest and nose2's automatic
discovery. (The test generator will automatically add ``unittest.TestCase``
as a base class to each combination).
"""
import cloudbridge

from test.helpers import ProviderTestCaseGenerator
from test.test_block_store_service import CloudBlockStoreServiceTestCase
from test.test_cloud_helpers import CloudHelpersTestCase
from test.test_compute_service import CloudComputeServiceTestCase
from test.test_image_service import CloudImageServiceTestCase
from test.test_instance_types_service import CloudInstanceTypesServiceTestCase
from test.test_interface import CloudInterfaceTestCase
from test.test_network_service import CloudNetworkServiceTestCase
from test.test_object_life_cycle import CloudObjectLifeCycleTestCase
from test.test_object_store_service import CloudObjectStoreServiceTestCase
from test.test_region_service import CloudRegionServiceTestCase
from test.test_security_service import CloudSecurityServiceTestCase


PROVIDER_TESTS = [
    CloudHelpersTestCase,
    CloudInterfaceTestCase,
    CloudObjectLifeCycleTestCase,
    CloudSecurityServiceTestCase,
    CloudNetworkServiceTestCase,
    CloudInstanceTypesServiceTestCase,
    CloudBlockStoreServiceTestCase,
    CloudObjectStoreServiceTestCase,
    CloudComputeServiceTestCase,
    CloudRegionServiceTestCase,
    CloudImageServiceTestCase
]


def load_tests(loader=None, tests=None, pattern=None):
    """
    This function is required to aid the load_tests protocol
    (https://docs.python.org/2/library/unittest.html#load-tests-protocol)
    """
    cloudbridge.init_logging()
    return ProviderTestCaseGenerator(PROVIDER_TESTS).generate_tests()