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...

Reset root password RHEL/Rocky/CentOS 9

Unlike the earlier versions of Rethat variants, version 9 doesn't allow single user mode to change password, as maintanance mode in 9 requires root password . Single user mode (runlevel 1) can easily be obtained by appending the word ' single ' at the end of the line starting with 'linux' by editing the entry in boot menu by pressing ' e ' at boot menu. To reset the root password on the other hand, one requires to follow a specific set of commands, At the boot menu, edit rescue mode to append 'rd.break ' at the end of the line starting with kernel. Boot with the edited line by pressing Ctrl+X or F10. At the new prompt starting with switch_root, type the following commands, mount -o remount, rw /sysroot chroot /sysroot touch /.autorelabel passwd <new root password> exit reboot       

Devstack installation with cells in multiple machines

  Devstack is a testing and development package for OpenStack . The official devstack website has excellent but terse installation instructions, which could be daunting to a newbie. Normally, a traditional install is pretty straightforward but problems creep in when you have to go for some particular configuration or installation like cells or a simple code-test-debug setup, the information on the main site is insufficient. In this blog, I will enumerate the steps for setting up a cell-ular devstack installation with one parent and one child. Parent will not be instantiating any VMs s it's only a 'command centre'. 1. On both machines, install git and vim, clone the devstack repo using git. yum install git vim git clone https://git.openstack.org/openstack-dev/devstack 2. On both machines, open up the file 'local.conf' inside the cloned directory 'devstack' cd devstack; vim local.conf 3. Copy the parameters below to the file...