NAME

Test::Metadata - Class for capturing build and test log data and generating an XML Metadata file about it.

SYNOPSIS

 use Test::Metadata;
 use Test::Parser::KernelBuild;
 use Test::Parser::MyTest;

 my $build_results = new Test::Parser::KernelBuild;
 $build_results->parse("kernel_build.log");

 my $test_results  = new Test::Parser::MyTest;
 $test_results->parse("my_test.log");

 my $metadata = new Test::Metadata;
 $metadata->add_build($build_results);
 $metadata->add_test($test_results);

 print $metadata->to_xml();

DESCRIPTION

This module provides an interface for creating metadata summaries of software build and test results. It is designed to work in conjunction with Test::Parser subclasses, to allow you to gather and report on a set of tests run atop a given set of built software.

Essentially, you use Test::Parser to parse all your build and test files, and then add each of them to a Test::Metadata object. You can then generate an XML file for the combined results, suitable for use with other tools.

The XML format used is the 'Test Result Publication Interface' (TRPI) XML schema, developed by SpikeSource. See http://www.spikesource.com/testresults/index.jsp?show=trpi-schema

FUNCTIONS

new()

Creates a new Test::Metadata object.

add_build($build)

Takes a Test::Parser object and extracts information about it and builds an internal build metadata representation.

substitute_template($template, $data_hashref)

Performs substitutions of values in the form '[%variable%]' with the corresponding value given by $data_hashref->{variable}. Any undefined items are replaced with blank strings.

to_xml()

Returns the parsed test result data in the TRPI XML syntax (http://www.spikesource.com/testresults/index.jsp?show=trpi-schema).

In the case of an error, undef will be returned. The error message can be retrieved via error().

parse($file)

Parses the given xml (TRPI) file or url and loads the data into the current object.

id()

Returns the id of the parsed test.

total_executed

Returns the total number of executed test cases

total_passed

Returns the total number of passed test cases

total_failed

Returns the total number of failed test cases

total_skipped

Returns the total number of test cases that were not run

PREREQUISITES

None

AUTHOR

Bryce Harrington <bryce@osdl.org>

COPYRIGHT

Copyright (C) 2005 Bryce Harrington. All Rights Reserved.

This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perl, XML::Twig

cpanm Test::Parser

perl -MCPAN -e shell
install Test::Parser