manila/manila/testing
Goutham Pacha Ravi cb95b6f6f5 [ussuri][goal] Drop python2.7 support
As per the official python support timeline
set forth by the OpenStack TC [1][2], OpenStack
Train (in our case, manila 9.x) is the last
release that will support python2.7.

[1] https://governance.openstack.org/tc/resolutions/20180529-python2-deprecation-timeline.html
[2] https://governance.openstack.org/tc/goals/selected/ussuri/drop-py27.html

Change-Id: I5b4dc1853d7e4f8f736dd2a22eb08bcfdeac3411
2019-12-08 19:32:52 -08:00
..
README.rst [ussuri][goal] Drop python2.7 support 2019-12-08 19:32:52 -08:00

OpenStack Manila Testing Infrastructure

A note of clarification is in order, to help those who are new to testing in OpenStack Manila:

  • actual unit tests are created in the "tests" directory;
  • the "testing" directory is used to house the infrastructure needed to support testing in OpenStack Manila.

This README file attempts to provide current and prospective contributors with everything they need to know in order to start creating unit tests and utilizing the convenience code provided in manila.testing.

Writing Unit Tests

  • All new unit tests are to be written in python-mock.
  • Old tests that are still written in mox should be updated to use python-mock.

    Usage of mox has been deprecated for writing Manila unit tests.

  • use addCleanup in favor of tearDown

test.TestCase

The TestCase class from manila.test (generally imported as test) will automatically manage self.stubs using the stubout module. 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.

Running Tests

The preferred way to run the unit tests is using tox. Tox executes tests in isolated environment, by creating separate virtualenv and installing dependencies from the requirements.txt and test-requirements.txt files, so the only package you install is tox itself:

sudo pip install tox

Run the unit tests by doing:

tox -e py3

Tests and assertRaises

When asserting that a test should raise an exception, test against the most specific exception possible. An overly broad exception type (like Exception) can mask errors in the unit test itself.

Example:

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