1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
.. _gtester(1):
.. meta::
:copyright: Copyright 2008 Matthias Clasen
:copyright: Copyright 2011 Collabora, Ltd.
:copyright: Copyright 2011 Carlos Garcia Campos
:copyright: Copyright 2012 Red Hat, Inc.
:copyright: Copyright 2019 Endless Mobile, Inc.
:license: LGPL-2.1-or-later
..
This has to be duplicated from above to make it machine-readable by `reuse`:
SPDX-FileCopyrightText: 2008 Matthias Clasen
SPDX-FileCopyrightText: 2011 Collabora, Ltd.
SPDX-FileCopyrightText: 2011 Carlos Garcia Campos
SPDX-FileCopyrightText: 2012 Red Hat, Inc.
SPDX-FileCopyrightText: 2019 Endless Mobile, Inc.
SPDX-License-Identifier: LGPL-2.1-or-later
=======
gtester
=======
--------------------
test running utility
--------------------
SYNOPSIS
--------
| **gtester** [*OPTION*…] *test-program*
DESCRIPTION
-----------
``gtester`` is a utility to run unit tests that have been written using the GLib
test framework.
Since GLib 2.62, ``gtester-report`` is deprecated. Use TAP for reporting test
results instead, and feed it to the test harness provided by your build system.
When called with the ``-o`` option, ``gtester`` writes an XML report of the test
results, which can be converted into HTML using the ``gtester-report`` utility.
OPTIONS
-------
``-h``, ``--help``
Print help and exit.
``-v``, ``--verbose``
Print version information and exit.
``--g-fatal-warnings``
Make warnings fatal.
``-k``, ``--keep-going``
Continue running after tests failed.
``-l``
List paths of available test cases.
``-m=<MODE>``
Run test cases in ``MODE``, which can be one of:
* ``perf``
Run performance tests.
* ``slow``, ``thorough``
Run slow tests, or repeat non-deterministic tests more often.
* ``quick``
Do not run slow or performance tests, or do extra repeats of
non-deterministic tests (default).
* ``undefined``
Run test cases that deliberately provoke checks or assertion failures, if
implemented (default).
* ``no-undefined``
Do not run test cases that deliberately provoke checks or assertion
failures.
``-p=<TEST-PATH>``
Only run test cases matching ``TEST-PATH``.
``-s=<TEST-PATH>``
Skip test cases matching ``TEST-PATH``.
``--seed=<SEED-STRING>``
Run all test cases with random number seed ``SEED-STRING``.
``-o=<LOG-FILE>``
Write the test log to ``LOG-FILE``.
``-q``, ``--quiet``
Suppress per-test-binary output.
``--verbose``
Report success per testcase.
SEE ALSO
--------
`gtester-report(1) <man:gtester-report(1)>`_
|
