OpenStack Compute (Nova)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
nova/nova/tests/unit
Balazs Gibizer edeeaf9102 Add late server group policy check to rebuild 5 years ago
..
api Merge "log test: use fixtures.StandardLogging in setUp" 5 years ago
api_samples_test_base
cells Merge "Add instance action record for snapshot instances" 5 years ago
cmd Update nova-status and docs for nova-compute requiring placement 1.14 5 years ago
compute Add late server group policy check to rebuild 5 years ago
conductor Add late server group policy check to rebuild 5 years ago
console Fix accumulated nits 5 years ago
consoleauth
db Merge "archive_deleted_instances is not atomic for insert/delete" 5 years ago
fake_loadables
image Merge "Handle images with no data" 5 years ago
keymgr
monkey_patch_example
network make unit tests compatible with os-vif 1.8.0 5 years ago
notifications Transform instance.resize_prep notification 5 years ago
objects [placement] Fix resource provider delete 5 years ago
pci Address nits in I46d483f9de6776db1b025f925890624e5e682ada 5 years ago
privsep Start moving users of parted to privsep. 5 years ago
scheduler Merge "placement: using the dict format for the allocation in claim_resources" 5 years ago
servicegroup
ssl_cert
virt Merge "libvirt: don't attempt to live snapshot paused instances" 5 years ago
volume Add support for getting volume details with a specified microversion 5 years ago
README.rst
__init__.py Do not monkey patch eventlet in unit tests 5 years ago
cast_as_call.py
conf_fixture.py
fake_block_device.py Make BlockDeviceMapping object support uuid 5 years ago
fake_build_request.py
fake_console_auth_token.py Add access_url_base to console_auth_tokens table 5 years ago
fake_crypto.py
fake_diagnostics.py
fake_flavor.py Add Flavor.description attribute 5 years ago
fake_hosts.py
fake_instance.py
fake_ldap.py
fake_network.py
fake_network_cache_model.py
fake_notifier.py fake_notifier: Refactor wait_for_versioned_notification 5 years ago
fake_pci_device_pools.py
fake_policy.py
fake_processutils.py
fake_request_spec.py Don't persist could-be-stale InstanceGroup fields in RequestSpec 5 years ago
fake_server_actions.py
fake_volume.py
fake_xvp_console_proxy.py
image_fixtures.py
matchers.py
policy_fixture.py
test_api_validation.py Enable reset keypair while rebuilding instance 5 years ago
test_availability_zones.py
test_baserpc.py Do not setup conductor in BaseAPITestCase 5 years ago
test_block_device.py
test_cache.py
test_cinder.py Drop support for the Cinder v2 API 5 years ago
test_conf.py
test_configdrive2.py Cleanup mount / umount and associated rmdir calls 5 years ago
test_context.py Get auth from context for glance endpoint 5 years ago
test_crypto.py
test_exception.py
test_fixtures.py
test_flavors.py
test_hacking.py
test_hooks.py
test_identity.py Use ksa adapter for keystone conf & requests 5 years ago
test_instance_types_extra_specs.py
test_iptables_network.py
test_ipv6.py
test_json_ref.py Nits from Ic3ab7d60e4ac12b767fe70bef97b327545a86e74 5 years ago
test_loadables.py
test_matchers.py
test_metadata.py Merge "conf: Remove 'vendordata_driver' opt" 5 years ago
test_notifications.py Remove dead code of api.fault notification sending 5 years ago
test_notifier.py
test_nova_manage.py Fix update_cell to ignore existing identical cells 5 years ago
test_policy.py Add microversion to allow setting flavor description 5 years ago
test_profiler.py
test_quota.py Follow up on removing old-style quotas code 5 years ago
test_rpc.py Make TestRPC inherit from the base nova TestCase 5 years ago
test_safeutils.py
test_service.py Fix test_rpc_consumer_isolation for oslo.messaging 5.31.0 5 years ago
test_service_auth.py Fix NoneType error when [service_user] is misconfigured 5 years ago
test_test.py Fix test_rpc_consumer_isolation for oslo.messaging 5.31.0 5 years ago
test_test_utils.py
test_utils.py Use method validate_integer from oslo.utils 5 years ago
test_uuid_sentinels.py Move test_uuid_sentinels to NoDBTestCase 5 years ago
test_versions.py
test_weights.py
test_wsgi.py
utils.py Make ConductorTaskTestCase run with 2 cells 5 years ago

README.rst

OpenStack Nova Testing Infrastructure

This README file attempts to provide current and prospective contributors with everything they need to know in order to start creating unit tests for nova.

Note: the content for the rest of this file will be added as the work items in the following blueprint are completed: https://blueprints.launchpad.net/nova/+spec/consolidate-testing-infrastructure

Test Types: Unit vs. Functional vs. Integration

TBD

Writing Unit Tests

TBD

Using Fakes

TBD

test.TestCase

The TestCase class from nova.test (generally imported as test) will automatically manage self.stubs using the stubout module and self.mox using the mox module during the setUp step. They will automatically verify and clean up during the tearDown step.

If using test.TestCase, calling the super class setUp is required and calling the super class tearDown is required to be last if tearDown is overridden.

Writing Functional Tests

TBD

Writing Integration Tests

TBD

Tests and Exceptions

A properly written test asserts that particular behavior occurs. This can be a success condition or a failure condition, including an exception. When asserting that a particular exception is raised, the most specific exception possible should be used.

In particular, testing for Exception being raised is almost always a mistake since it will match (almost) every exception, even those unrelated to the exception intended to be tested.

This applies to catching exceptions manually with a try/except block, or using assertRaises().

Example:

self.assertRaises(exception.InstanceNotFound, db.instance_get_by_uuid,
                  elevated, instance_uuid)

If a stubbed function/method needs a generic exception for testing purposes, test.TestingException is available.

Example:

def stubbed_method(self):
    raise test.TestingException()
self.stubs.Set(cls, 'inner_method', stubbed_method)

obj = cls()
self.assertRaises(test.TestingException, obj.outer_method)

Stubbing and Mocking

Whenever possible, tests SHOULD NOT stub and mock out the same function.

If it's unavoidable, tests SHOULD define stubs before mocks since the TestCase cleanup routine will un-mock before un-stubbing. Doing otherwise results in a test that leaks stubbed functions, causing hard-to-debug interference between tests1.

If a mock must take place before a stub, any stubs after the mock call MUST be manually unset using self.cleanUp calls within the test.


  1. https://bugs.launchpad.net/nova/+bug/1180671