Skip to main content

Unit testing OpenStack with tox

Testing is and will always be an integral part of any software development. OpenStack is no exception. In OpenStack, unit testing is done using tox.

Installing tox,

[apt-get | yum] install python-pip; pip install tox


Tox has various tests defined in the envlist. One can open tox.ini for a complete list of envs defined.

OpenStack defines, py27 and pep8 test. Former is for unittests and later for style checks.

How to run tox and testr

Tox can use used to list unit tests and execute all of them or any subset of them using regex.

To run all tests,
tox -e py27                        # you can chose any other                                                                           environment like py26 if you like
To run only selected tests, 
tox -e py --
One can get the test_name either from the source code of the project concerned or by asking tox to list them out. For example, the tests defined in nova.tests.compute.test_compute_cells.py are accessible by 'nova.tests.unit.compute.test_compute_cells.*'. Alternatively to list the tests using tox one has to go to tox shell after sourcing the virtual env.
source .tox/py27/bin/activate
testr  list-tests
 With the venv sourced we can run testr directly.
testr help  
testr run --parallel

testr run --parallel
After tests have run you can view the failing tests then run only that list of tests.

Errors and workaround


tox requires some elaborate environment setups which can sometimes be tricky. Here are some errors whcih I came across during my installation. For posterity, I'm documenting them in this blog,



ERROR:
Package libvirt was not found in the pkg-config search path.

Perhaps you should add the directory containing `libvirt.pc'

to the PKG_CONFIG_PATH environment variable

Solution:
sudo yum install libvirt-devel



ERROR:
fatal error: my_config.h: No such file or directory


 Solution:
sudo yum install mysql-devel

Comments

Popular posts from this blog

Multimaster replication with Symmetric DS

Symmetric DS is an awesome tool for trigger based replication whcih works for all major database vendors, including but not limited to PostgreSQL, MySQL, MSSQL, Oracle and many others. Symmetric-DS is a java application and can execute on any platform on whcih JRE is available including Windows and Linux. Trigger based replication, in constrast to disk based (eg. DRBD ) or transaction log file shipping based or statement based , works by registering triggers on DMLs and sending the data thus generated to remote machines. Another very popular trigger based DB replication tool is Slony . Symmetric-DS in addition to being database agnostic also supports multi-master replication (MMR). MMR usecase involves multiple database nodes, connected in a pool with DML updates coming from any of them. This is different from the normal master-slave replication, where slaves are not expected to generate any data events, and the sole authority of database is the master. MMR requirement causes d...

RabbitMQ and SSL

RabbitMQ is an AMQP provider i.e. it can reliably queue, service and maintain messages according to a range of policies and parameters. By default, it listens to plain old TCP connections and sends and receives messages over plaintext. This feature just works "out of the box". For users who wish to use SSL over TCP aka TLS, it requires a bit more work on their part. First, let's create a bunch of certificates and sign them with our own CA. For this, we'll use easyrsa3 . Easyrsa is a CLI tool to create, sign and manage your own certification authorities. It's maintained by OpenVPN team. Download easyrsa using your native package manager i.e. yum or apt-get $cp -Rp /usr/share/easy-rsa ~/easy-rsa-3   $cd ~/easy-rsa-3 $./easyrsa init-pki $./easyrsa build-ca $./easyrsa build-server-full broker [nopass] $./easyrsa build-client-full client1 [nopass] This creates three entities (collection of private keys, public keys and certificates) for a CA, a s...

Motorola XT502 Custom ROMs

I purchased an Android Phone in the early days of it coming to Indian market and I able to afford it ( just got a job), during mid 2010. The recent and popular version was Éclairs. I just went up to the shop and bought a nice and shiny Motorola Quench XT3 (XT502). When in other places XT502 was having Andriod Donut, I got as a special offer Éclairs. I was happy as hell. The Droid A couple of year passes, and newer versions of Android came from Éclairs to Froyo to Gingerbread then to the bigger version upgrades like Honeycomb, Ice Cream Sandwich and then Jelly Bean. By the end of 2012, I was literally surviving on my Motorola with Éclairs. I had to upgrade, anyhow. Now more that Motorola denied any upgrades for Quench XT3 . A trivia, Android version names are taken from sugary desserts with lexicographic sequencing. So, I did up-gradation from Éclairs to Gingerbread using a custom ROM from Cyanogenmod . An excellent community of enthusiast who develop their own custom ROMs oft...