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
Nikola Dipanov 4bd8a4bd8e
Fix overloading of block device on boot by device name
8 years ago
..
api Merge "Add missing policy for limits extension" 8 years ago
cells Switch to the oslo_utils.fileutils 8 years ago
cert Switch to using oslo_* instead of oslo.* 8 years ago
cmd Switch to oslo.reports 8 years ago
compute Fix overloading of block device on boot by device name 8 years ago
conductor Merge "Remove and deprecate conductor task_log methods" 8 years ago
console Fix noVNC console access for an IPv6 setup 8 years ago
consoleauth Use six.moves.range for Python 3 8 years ago
db Merge "Revert "Remove useless db call instance_get_all_hung_in_rebooting"" 8 years ago
fake_loadables
image Switch to oslo.service library 8 years ago
keymgr Switch to using oslo_* instead of oslo.* 8 years ago
monkey_patch_example
network Merge "Only work with ipv4 subnet metadata if one exists" 8 years ago
objects Merge "Fix serializer supported version reporting in object_backport" 8 years ago
pci Add unit tests for PCI utils 8 years ago
scheduler Merge "Make NoValidHost exceptions clearer" 8 years ago
servicegroup fix "down" nova-compute service spuriously marked as "up" 8 years ago
ssl_cert
virt Merge "Switch to using os-brick" 8 years ago
volume Make unit tests inherit from test.NoDBTestCase 8 years ago
README.rst
__init__.py
cast_as_call.py Replace fanout to False for CastAsCall fixture 8 years ago
conf_fixture.py Test fixture for the api database 8 years ago
fake_block_device.py Switch to using oslo_* instead of oslo.* 8 years ago
fake_crypto.py Adds cleanup on v2.2 keypair api and tests 8 years ago
fake_flavor.py Make resize api of compute manager to send flavor object 8 years ago
fake_hosts.py Change queries for network services to use binary instead of topic 8 years ago
fake_instance.py Fix up instance flavor usage in compute and network tests 8 years ago
fake_ldap.py Replace dict.iteritems() with six.iteritems(dict) 8 years ago
fake_network.py Use six.moves.range for Python 3 8 years ago
fake_network_cache_model.py
fake_notifier.py Add serialization of context to FakeNotifier 8 years ago
fake_pci_device_pools.py Add numa_node field to PciDevicePool 8 years ago
fake_policy.py Add missing policy for limits extension 8 years ago
fake_processutils.py Use oslo.log 8 years ago
fake_server_actions.py
fake_utils.py
fake_volume.py Cleanup unused method fake_set_snapshot_id 8 years ago
image_fixtures.py
matchers.py Fix Python 3 issues in nova.db.sqlalchemy 8 years ago
policy_fixture.py Replace dict.iteritems() with six.iteritems(dict) 8 years ago
test_api_validation.py Add json-schema for v2.1 fixed-ips 8 years ago
test_availability_zones.py Replace unicode with six.text_type 8 years ago
test_baserpc.py ensure DatabaseFixture removes db on cleanup 8 years ago
test_bdm.py
test_block_device.py snapshot: Add device_name to the snapshot bdms 8 years ago
test_cinder.py
test_configdrive2.py Switch to the oslo_utils.fileutils 8 years ago
test_context.py Removed unused variables 8 years ago
test_crypto.py Replace openssl calls with cryptography lib 8 years ago
test_exception.py Port test_exception to Python 3 8 years ago
test_fixtures.py Block subtractive operations in migrations for Kilo and beyond 8 years ago
test_flavors.py Support flavor object in migrate_disk_and_power_off 8 years ago
test_hacking.py Remove unnecessary oslo namespace import checks 8 years ago
test_hooks.py Fix improper use of Stevedore 8 years ago
test_instance_types_extra_specs.py
test_iptables_network.py Replace dict.itervalues() with six.itervalues(dict) 8 years ago
test_ipv6.py
test_loadables.py
test_matchers.py fixed tests in test_matchers to pass with random PYTHONHASHSEED 8 years ago
test_metadata.py Include project_id in instance metadata. 8 years ago
test_notifications.py Handle InstanceNotFound when sending instance update notification 8 years ago
test_nova_manage.py Remove flavor migration from db_api and nova-manage 8 years ago
test_objectstore.py Switch to using oslo_* instead of oslo.* 8 years ago
test_pipelib.py ensure DatabaseFixture removes db on cleanup 8 years ago
test_policy.py
test_quota.py Use six.moves.range for Python 3 8 years ago
test_safeutils.py Avoid indexing into an empty list in getcallargs 8 years ago
test_service.py Switch to oslo.service library 8 years ago
test_test.py test: add MatchType helper class as equivalent of mox.IsA 8 years ago
test_test_utils.py
test_utils.py Switch to the oslo_utils.fileutils 8 years ago
test_versions.py Fix version unit test on Python 3 8 years ago
test_weights.py Skip only one host weight calculation 8 years ago
test_wsgi.py Skip socket related unit tests on OSX 8 years ago
utils.py Use six.moves.range for Python 3 8 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↩︎