1CGREEN-RUNNER(1)            General Commands Manual           CGREEN-RUNNER(1)
2
3
4

NAME

6       cgreen-runner  - an auto-discovering runner for the Cgreen unittest and
7       mocking framework
8
9
10

SYNOPSIS

12       cgreen-runner [--colour]  [--xml  prefix]  [--suite  name]  [--verbose]
13       [--no-run] [--help] ( LIBRARY [test] )+
14
15
16

DESCRIPTION

18       Cgreen is a framework for creating and running compact and easy-to-read
19       unittests for C and/or C++. After compiling your tests and linking them
20       together with the code/class/subject under test (CUT/SUT) into a shared
21       dynamically loadable LIBRARY you can auto-discover and  run  all  tests
22       using  the  cgreen-runner without having to manually add each and every
23       test that you write to a suite programmatically.
24
25       This makes the TDD cycle even faster and  less  error-prone,  one  less
26       thing to remember.
27
28
29
30   Usage:
31       Discover  and  run  all,  or a single named, cgreen test(s) from one or
32       multiple dynamically loadable library.
33
34       A single test can be run using the form [<context>:]<name> where  <con‐
35       text> can be omitted if there is no context.
36
37
38

OPTIONS

40       -c, --colours/colors
41              Use colours to emphasis result (requires ANSI-capable terminal)
42
43
44       -x, --xml prefix
45              Instead  of  messages on stdout, write results into one XML-file
46              per suite, compatible with Hudson/Jenkins  CI.  The  filename(s)
47              will be 'prefix-<suite>.xml'
48
49
50       -s, --suite name
51              Give  the  top  level  suite name instead of the name in the LI‐
52              BRARY.
53
54
55       -n, --no-run
56              Don't run the tests.
57
58
59       -v, --verbose
60              Show progress information during run.
61
62
63       -V, --version
64              Show version information and exit.
65
66
67       -h, --help
68              Print some usage information and exit.
69
70

SEE ALSO

72       cgreen(5)
73
74
75       The full documentation for cgreen-runner and the Cgreen framework is in
76       the Cgreen manual available at GitHub.
77
78
79
80
81
82                                                              CGREEN-RUNNER(1)
Impressum