Tempest's plugin with a hello world test case
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Hello World Tempest Plugin

Basic Tempest plugin structure that runs a Hello World test case.


When Tempest runs, it will automatically discover the installed plugins. So we just need to install the Python packages that contains the plugin.

Clone the repository in your machine and install the package from the src tree:

$ cd hello-world-tempest-plugin
$ sudo pip install -e .

Using virtual environments

If you run Tempest inside a virtualenv you have to ensure that the Python package containing the plugin is installed in the venv too.

E.g: Installing the plugin in a Tempest (from Rally) venv:

$ . ~/.rally/tempest/for-deployment-x-x-x-x-x/.venv/bin/activate
$ ~/.rally/tempest/for-deployment-x-x-x-x-x/.venv/bin/pip install -e ~/hello-world-tempest-plugin/

Validate that the plugin was installed correctly:

$ ~/.rally/tempest/for-deployment-x-x-x-x-x/.venv/bin/pip list

How to run the tests

  1. To validate that Tempest discovered the test in the plugin, you can run:

    $ testr list-tests | grep hello_world_tempest_plugin

    This command will show your complete list of test cases inside the plugin.

  2. You can run the test cases by name or running the set names that they used as decorator through testr (Tempest) or Rally:

    $ testr run hello_world_tempest_plugin.tests.api.test_hello_world.TestHelloWorld.test_hello_world
    $ testr run --subunit smoke | subunit-2to1 | ./tools/colorizer.py
    $ rally verify start --set smoke