You are viewing the version of this documentation from Perl 5.24.2. View the latest version

CONTENTS

NAME

TAP::Formatter::Base - Base class for harness output delegates

VERSION

Version 3.36

DESCRIPTION

This provides console orientated output formatting for TAP::Harness.

SYNOPSIS

use TAP::Formatter::Console;
my $harness = TAP::Formatter::Console->new( \%args );

METHODS

Class Methods

new

my %args = (
   verbose => 1,
)
my $harness = TAP::Formatter::Console->new( \%args );

The constructor returns a new TAP::Formatter::Console object. If a TAP::Harness is created with no formatter a TAP::Formatter::Console is automatically created. If any of the following options were given to TAP::Harness->new they well be passed to this constructor which accepts an optional hashref whose allowed keys are:

Any keys for which the value is undef will be ignored.

prepare

Called by Test::Harness before any test output is generated.

This is an advisory and may not be called in the case where tests are being supplied to Test::Harness by an iterator.

open_test

Called to create a new test session. A test session looks like this:

my $session = $formatter->open_test( $test, $parser );
while ( defined( my $result = $parser->next ) ) {
    $session->result($result);
    exit 1 if $result->is_bailout;
}
$session->close_test;

summary

$harness->summary( $aggregate );

summary prints the summary report after all tests are run. The first argument is an aggregate to summarise. An optional second argument may be set to a true value to indicate that the summary is being output as a result of an interrupted test run.