This test suite is built on the Nose framework.  For more information see:

    http://readthedocs.org/docs/nose/en/latest/

Running the test suite:
-----------------------

Running these tests is easy.

From within the source directory you can execute all tests:
    ./run_tests_local.sh *.py

From within an installed directory:
    ./run_tests.sh *.py

Individual files or test cases can be specified:
    ./run_tests.sh cPopenTests.py
    ./run_tests.sh cPopenTests.py:TestCPopen.testEcho

Enabling slow tests:
-------------------

Some tests are too slow to run on each build. these are marked in the source
with the @slowtest decorator and are disabled by default.

To enable slow tests:
     ./run_tests_local.sh --enable-slow-tests filenme [...]

Slow tests are also enabled if NOSE_SLOW_TESTS environment variable is set.

Enabling stress tests:
---------------------

Some tests stress the resources of the system running the tests. These tests
are too slow to run on each build, and may fail on overloaded system or when
running tests in parrallel. These tests are marked in the source with the
@stresstest decorator and are disabled by default.

To enable stress tests:
     ./run_tests_local.sh --enable-stress-tests filename [...]

Stress tests are also enabled if NOSE_STRESS_TESTS environment variable is set.

Functional test suite:
----------------------

The functional test suite is designed to test a running vdsm instance.  To run
the full suite of functional tests from within the installed directory:
    ./run_tests.sh functional/*.py
