NAME

Test::AutoBuild::Result - represents results of an action

SYNOPSIS

use Test::AutoBuild::Result;

DESCRIPTION

This module provides a representation of the results from an 'interesting' action of the build process. The results current include a key identifying the action, status string identifying the outcome of the action, a log of command output, and start and end times.

METHODS

my $resule = Test::AutoBuild::Result->new(%params);

Creates a new result object.

my $name = $result->name();

Retrieves the name associated with the result, which is typically an alpha numeric string.

my $label = $result->label();

Retrieves the label associated with the result, which can be free format text.

my $log = $result->log();

Retrieves the log of the output of the action

my $status = $result->status();

Retrieves the status of the result, one of 'pending', 'success', 'failed', 'aborted', or 'skipped'.

my $time = $result->start_time();

Retrieves the time at which the action began execution, or undefined if it is yet to run

my $time = $result->end_time();

Retrieves the time at which the action completed execution, or undefined if it is yet to complete

$result->add_result($sub_result);

Adds a nested result to this result. The $sub_result parameter should be another instance of the Test::AutoBuild::Result class.

@results = $result->results

Retrieves a list of all nested results, previously added with the add_result method.

$boolean = $result->has_results

Returns a true value if there are nested results

AUTHORS

Daniel Berrange <dan@berrange.com>

COPYRIGHT

Copyright (C) 2005 Daniel Berrange <dan@berrange.com>

SEE ALSO

perl(1), Test::AutoBuild::Module