README.rst

Testing Blivet

Note: The test suite documented here is available only from the git repository not as part of any installable packages.

In order to execute blivet's test suite from inside the source directory execute the command:

make test

Some tests require root access on the system and will be skipped if you're running as non-root user.

To execute the Pylint code analysis tool run:

make check

Running Pylint doesn't require root privileges.

It is also possible to generate test coverage reports using the Python coverage tool. To do that execute:

make coverage

It is also possible to check all external links in the documentation for integrity. To do this:

cd doc/
make linkcheck

Test Suite Architecture

Blivet's test suite relies on the base classes shown below. These classes take care of working with fake block or loop devices.

tests.imagebackedtestcase tests.loopbackedtestcase tests.storagetestcase tests.devicetree_test.BlivetResetTestCase

Actual test cases inherit either unittest.TestCase or one of these base classes. Some use cases require more levels of abstraction which is shown on the following diagram.

tests.devicetree_test tests.formats_test.fs_test tests.formats_test.fslabeling