1ipa-run-tests(1)             FreeIPA Manual Pages             ipa-run-tests(1)
2
3
4

NAME

6       ipa-run-tests - Run the FreeIPA test suite
7

SYNOPSIS

9       ipa-run-tests [options]
10

DESCRIPTION

12       ipa-run-tests  is  a wrapper around nosetests that run the FreeIPA test
13       suite.  It is intended to be used for developer testing and in continu‐
14       ous integration systems.
15
16       It  loads  IPA-internal  Nose plugins ordered-tests and beakerlib.  The
17       ordered-tests plugin is enabled automatically.
18
19       The FreeIPA test suite installed system-wide  is  selected  via  Nose's
20       --where  option.   It is possible to select a subset of the entire test
21       suite by specifying a test file relative to the ipatests  package,  for
22       example:
23
24           ipa-run-tests test_integration/test_simple_replication.py
25
26

OPTIONS

28       All command-line options are passed to the underlying Nose runner.  See
29       nosetests(1) for a complete list.
30
31       The internal IPA plugins add an extra option:
32
33
34       --with-beakerlib
35              Enable BeakerLib integration.  Test phases, failures and passes,
36              and log messages are reported using beakerlib(1) commands.  This
37              option requires the beakerlib.sh script to be sourced.
38
39

EXIT STATUS

41       0 if the command was successful
42
43       nonzero if any error or failure occurred
44
45

CONFIGURATION

47       Please see ipa-test-config(1) for a description of configuration  envi‐
48       ronment variables.
49
50

REFERENCES

52       A  full  description  of  the  FreeIPA integration testing framework is
53       available at http://www.freeipa.org/page/V3/Integration_testing
54
55
56
57FreeIPA                           Aug 29 2013                 ipa-run-tests(1)
Impressum