Testing¶

Unit Tests¶

Currently, we provide tox environments for a variety of different Python versions. By default all available test environments within the tox configuration will execute when calling tox. If you want to run an independent version, you can do so with the following command:

# Executes tests on Python 2.7
$ tox -e py27

Functional Tests¶

Unlike running unit tests, the functional tests require Barbican and Keystone services to be running in order to execute. For more information on this please see Setting up a Barbican development environment and Using Keystone Middleware with Barbican

Castellan uses either /etc/castellan/castellan-functional.conf or ./etc/castellan/castellan-functional.conf in order to run functional tests. A sample file can be generated by running:

# Generate a sample configuration file
$ tox -e genconfig

castellan/etc/castellan/castellan-functional.conf.sample is generated. It must be renamed to castellan-functional.conf and placed in /etc/castellan or ./etc/castellan.

The file should look something like the following:

[DEFAULT]

[identity]
username = 'admin'
password = 'openstack'
project_name = 'admin'
auth_url = 'http://localhost/identity/v3'

Once you have the appropriate services running and configured you can execute the functional tests through tox.

# Execute Barbican Functional Tests
$ tox -e functional

By default, the functional tox job will use testr to execute the functional tests.

Debugging¶

In order to be able to debug code in Castellan, you must use the Python Debugger. This can be done by adding import pdb; pdb.set_trace() to set the breakpoint. Then run the following command to hit the breakpoint:

# hit the pdb breakpoint
$ tox -e debug

Once in the Python Debugger, you can use the commands as stated in the Debugger Commands section here: https://docs.python.org/2/library/pdb.html

Pep8 Check¶

Pep8 is a style guide for Python code. Castellan code should be have proper style before submission. In order to ensure that pep8 tests can be run through tox as follows:

# Checks python code style
$ tox -e pep8

Any comments on bad coding style will output to the terminal.