Extend py.test for RPC OpenStack testing.
Quick Start Guide
$ pip install pytest-zigzag
Or you can install "pytest-zigzag" via pip from disk (assumes you're in the root of the repo):
$ pip install -e .
Once installed the plug-in will automatically be loaded by all
py.test test runs executed in the Python environment
in which the
pytest-zigzag was installed.
JUnitXML RPC Specific Properties
If a user executes
py.test tests with the
--junitxml and with this plug-in installed, the resulting XML log file
will contain a test suite properties element. The properties element will contain information gathered about the test
run fetched from the local environment.
You can supply a json config to this plugin containing a dictionary. Each key / value will become a property name and value on the test suite node of the resulting xml. There is one required config: pytest_zigzag_env_vars. This should be a json object where the keys are the environment variable names to be collected, if you set value to a string that value will be used. If the value is null it will be pulled from the environment.
The location of the config file can be specified in two ways:
In a pytest ini file:
Explicitly on the command line:
pytest /path/to/test_test.py --pytest-zigzag-config=/path/to/config/file
Any property defined in the config file can be overriden by creating an environment variable of the same name. see this config_property_overrides.md
See CONTRIBUTING.rst for more details on developing for the "pytest-zigzag" project.
See release_process.rst for information on the release process for 'pytest-zigzag'