11. qmtest summarize

11.1. Summary

The qmtest summarize displays information stored in a results file.

11.2. Synopsis

qmtest summarize [ option ...] [{results-file} [ test-name | suite-name ...]]

11.3. Description

The qmtest summarize extracts information stored in the results-file (or results.qmr, if no results-file is specified) and displays this information on the console. The information is formatted just as if the tests had been run with qmtest run, but, instead of actually running the tests, QMTest reads the results from the results-file.

If the results-file is not a valid results file, it is interpreted as an extension descriptor, as described in Section 2, “qmtest create. You can use the descriptor syntax to read results stored in formats that are not "built-in" to QMTest.

The summarize command accepts the following options:

-f format, --format format

For details about this option, see the description of the qmtest run command.

-o file, --output file

Write full test results to file, in QMTest's machine-readable file format. Use a "-" (a hyphen) to write results to the standard output.

-O file, --outcomes file

For details about this option, see the description of the qmtest run command.

--result-stream descriptor

Specify an additional output result stream. The descriptor is in the format described in Section 2, “qmtest create.