Test suite
We have two sets of tests: the normal unit tests (make check) and the UI tests using Dogtail.
Since version 0.16, our backend test suite is much smaller and simpler; since most of the core functionality is now handled by GES, you need to run GES's test suite instead if you want to test more thoroughly.
Contents |
Unit tests
You can then run the unit tests with:
cd tests make check
If you want to see more details while the tests are being run, use this instead:
cd tests VERBOSE=1 make check
If you want to run only one particular unit test, such as "tests/test_basic.py", you can use for example:
cd tests VERBOSE=1 TESTCASE="test_basic" make check
UI tests with Dogtail
The dogtail tests are located in the tests/dogtail_scripts directory. Dogtail simulates a user interacting with the graphical user interface, which looks like this (accelerated).
Installing Dogtail
- Install dogtail (on Fedora: "yum install dogtail", on Ubuntu: install it manually)
- As a normal user, run "sniff" to make sure the assistive technologies are enabled (dogtail uses AT-SPI to do its magic)
- Logout and re-login
Running the UI tests
Assuming you've got PiTiVi git with the environment variables set properly (see Building with GES), you can go to the pitivi directory and run all our UI tests by doing:
python2 -m unittest discover tests/dogtail_scripts/ -v
If you want to run only one or two particular tests, you can specify them at the end. For example:
python2 -m unittest discover tests/dogtail_scripts/ -v -p test_timeline.py test_clipproperties.py
During test execution, do not touch your computer. Go grab a cup of tea or a hot dog and watch the show. It will take a couple of minutes, depending on how fast your computer is.
See also:
- Test suite wishlist
- The current list of test suite bug reports
- Dogtail performance tips
