Files
deb-python-gabbi/docs/source/example.rst
Chris Dent 76c39194bc Introduction documentation improvements
The hope is that this makes gabbi-run a bit more visible
and points to the way tests can be loaded more clearly.

thanks to @FND for the prompting
2015-07-14 10:14:05 +01:00

1.4 KiB

Test Example

What follows is a commented example of some tests in a single file demonstrating many of the format features. See Loader, below, for the Python needed to integrate with a testing harness.

example.yaml

Loader

Test Loader

To run those tests a test loader is required. That would look a bit like this:

example.py

For details on the arguments available when building tests see ~gabbi.driver.build_tests.

Run Test Loader

Once the test loader has been created, it needs to be run. There are many options. Which is appropriate depends very much on your environment. Here are some examples using unittest or testtools that require minimal knowledge to get started.

By file:

python -m testtools.run -v test/test_loader.py

By module:

python -m testttols.run -v test.test_loader

python -m unittest -v test.test_loader

Using test discovery to locate all tests in a directory tree:

python -m testtools.run discover

python -m unittest discover test

See the source distribution and the tutorial repo for more advanced options, including using testrepository and subunit.