boost-test.pp - Pulse v2.0

Boost.Test Post-Processor

The Boost.Test post-processor can be used to process XML reports in the format produced by Boost.Test, adding the test results to the build result.

To produce reports compatible with this processor, run your test binaries as follows:

$ ./mytests --log_format=XML --log_level=test_suite

These options switch on XML output, and produce details at the level suitable for pulse™. To also gather information on successful assertions, increase the level from test_suite to all:

$ ./mytests --log_format=XML --log_level=all

To ensure the informative assertion details are reported, you also need to set process-info to true.

Attributes

Attribute	Description	Required?	Default
name	The name of the post-processor.	Yes
process-info	If true, <Info> elements in the report are processed and added to the test details. This can be used, for example, to show details of all assertions, even for passing tests.	No	false
process-messages	If true, <Message> elements in the report are processed and added to the test details.	No	false

Child Elements

None.

Examples

Create and apply a Boost.Test post-processor to a captured test report:

<boost-test.pp name="boost-test"/>

<recipe name="default">
    <command name="build">
        <make targets="test"/>
        <artifact name="boost.test xml report" file="build/reports/tests.xml" fail-if-not-present="false">
            <process processor="${boost-test}"/>
        </artifact>
    </command>
</recipe>

Capture a directory of reports and process them all:

<boost-test.pp name="boost-test"/>

<recipe name="default">
    <command name="build">
        <make targets="test"/>
        <dir-artifact name="test reports" base="${base.dir}/reports" fail-if-not-present="false">
            <include pattern="**/*.xml"/>
            <process processor="${boost-test}"/>
        </dir-artifact>
    </command>
</recipe>