For Quality Assurance, it is important that the testing of functionality can be automated.
Depending on the detail of the tests, the tests are called Unit Tests or Integration tests.
This article shows how to write tests in Python, and run them against an installed instance of Kolab, using Selenium, on CentOS.
Useful links are:
- Python unittest — Unit testing framework
- Selenium Python Bindings: Getting started
- Selenium HQ WebDriver
We are using the Firefox browser on a headless CentOS machine.
We need to install the following packages:
sudo yum install python-setuptools Xvfb firefox
sudo easy_install selenium
sudo dbus-uuidgen > /var/lib/dbus/machine-id
To run Firefox on a headless system, you need to start the X Virtual FrameBuffer (Xvfb):
sudo Xvfb :10 -ac -screen 0 1280x1024x24
On another console, you can now run:
export DISPLAY=:10
python test.py
For a first example of a test for Kolab, see testCreateUserAndEditSelf.py. This test assumes that the password of the Directory Manager is "test", and it will create a new user, check that the default folders in the mailbox have been created, login with that user, and attempt to change the initials of the user and save them.
By the way, the test currently fails on Kolab 3.1 updates (check /var/log/httpd/error_log for details), due to bug https://issues.kolab.org/show_bug.cgi?id=2414, which was the whole point of setting up this test case…
Update:
Instead of Firefox, you can also use PhantomJS with Selenium to have a headless browser. It is based on Webkit.You need to download a binary once, from phantomjs.org/download.html:
wget https://phantomjs.googlecode.com/files/phantomjs-1.9.2-linux-x86_64.tar.bz2
tar xjf phantomjs-1.9.2-linux-x86_64.tar.bz
cp phantomjs-1.9.2-linux-x86_64/bin/phantomjs /usr/bin