docs/reference/glib/gtester.xml

   1 <refentry id="gtester">
   2
   3 <refmeta>
   4 <refentrytitle>gtester</refentrytitle>
   5 <manvolnum>1</manvolnum>
   6 <refmiscinfo class="manual">User Commands</refmiscinfo>
   7 </refmeta>
   8
   9 <refnamediv>
  10 <refname>gtester</refname>
  11 <refpurpose>test running utility</refpurpose>
  12 </refnamediv>
  13
  14 <refsynopsisdiv>
  15 <cmdsynopsis>
  16 <command>gtester</command>
  17 <arg choice="opt" rep="repeat">option</arg>
  18 <arg>testprogram</arg>
  19 </cmdsynopsis>
  20 </refsynopsisdiv>
  21
  22 <refsect1><title>Description</title>
  23 <para><command>gtester</command> is a utility to run unit tests that have
  24 been written using the GLib test framework.
  25 </para>
  26 <para>
  27 When called with the <option>-o</option> option, <command>gtester</command>
  28 writes an XML report of the test results, which can be converted
  29 into HTML using the <command>gtester-report</command> utility.
  30 </para>
  31
  32 <refsect2><title>Options</title>
  33 <variablelist>
  34
  35 <varlistentry>
  36 <term><option>-h</option>, <option>--help</option></term>
  37 <listitem><para>
  38 print help and exit
  39 </para></listitem>
  40 </varlistentry>
  41
  42 <varlistentry>
  43 <term><option>-v</option>, <option>--version</option></term>
  44 <listitem><para>
  45 print version information and exit
  46 </para></listitem>
  47 </varlistentry>
  48
  49 <varlistentry>
  50 <term><option>--g-fatal-warnings</option></term>
  51 <listitem><para>
  52 make warnings fatal
  53 </para></listitem>
  54 </varlistentry>
  55
  56 <varlistentry>
  57 <term><option>-k</option>, <option>--keep-going</option></term>
  58 <listitem><para>
  59 continue running after tests failed
  60 </para></listitem>
  61 </varlistentry>
  62
  63 <varlistentry>
  64 <term><option>-l</option></term>
  65 <listitem><para>
  66 list paths of available test cases
  67 </para></listitem>
  68 </varlistentry>
  69
  70 <varlistentry>
  71 <term><option>-m=<replaceable>MODE</replaceable></option></term>
  72 <listitem><para>
  73 run test cases in <replaceable>MODE</replaceable>, which can be perf, slow, thorough or quick. The default mode is quick.
  74 </para></listitem>
  75 </varlistentry>
  76
  77 <varlistentry>
  78 <term><option>-p=<replaceable>TESTPATH</replaceable></option></term>
  79 <listitem><para>
  80 only run test cases matching <replaceable>TESTPATH</replaceable>
  81 </para></listitem>
  82 </varlistentry>
  83
  84 <varlistentry>
  85 <term><option>-s=<replaceable>TESTPATH</replaceable></option></term>
  86 <listitem><para>
  87 skip test cases matching <replaceable>TESTPATH</replaceable>
  88 </para></listitem>
  89 </varlistentry>
  90
  91 <varlistentry>
  92 <term><option>--seed=<replaceable>SEEDSTRING</replaceable></option></term>
  93 <listitem><para>
  94 run all test cases with random number seed <replaceable>SEEDSTRING</replaceable>
  95 </para></listitem>
  96 </varlistentry>
  97
  98 <varlistentry>
  99 <term><option>-o=<replaceable>LOGFILE</replaceable></option></term>
 100 <listitem><para>
 101 write the test log to <replaceable>LOGFILE</replaceable>
 102 </para></listitem>
 103 </varlistentry>
 104
 105 <varlistentry>
 106 <term><option>-q</option>, <option>--quiet</option></term>
 107 <listitem><para>
 108 suppress per test binary output
 109 </para></listitem>
 110 </varlistentry>
 111
 112 <varlistentry>
 113 <term><option>--verbose</option></term>
 114 <listitem><para>
 115 report success per testcase
 116 </para></listitem>
 117 </varlistentry>
 118
 119 </variablelist>
 120 </refsect2>
 121 </refsect1>
 122
 123 <refsect1><title>See also</title>
 124 <para>
 125 <citerefentry>
 126 <refentrytitle>gtester-report</refentrytitle>
 127 <manvolnum>1</manvolnum>
 128 </citerefentry>
 129 </para>
 130 </refsect1>
 131 </refentry>