NAME

TB2::Formatter::TAP::Base - Base class for TAP formatters

SYNOPSIS

package My::TAP::Formatter;

use TB2::Mouse;
extends 'TB2::Formatter::TAP::Base';

...whatever extensions you like...

DESCRIPTION

The base class for formatting output using the Test Anything Protocol.

In reality it is fully functional, but we highly encourage you to use a version specific subclass.

TB2::Formatter::TAP::v13 for TAP version 13 TB2::Formatter::TAP::v12 for TAP version 12

As TAP is further extended, there will be more formatters to choose from.

The TB2::Formatter::TAP factory will choose the latest TAP version.

METHODS

As TB2::Formatter with the following changes and additions.

out

err

These methods are just shorthand for:

$output->write(out => @args);
$output->write(err => @args);

diag

$tap->diag( @text );

Outputs @text as a TAP comment to the error handle.

note

Like diag but goes to the output handle.

counter

my $counter = $formatter->counter;
$formatter->counter($counter);

Gets/sets the TB2::Counter for this formatter keeping track of the test number.

use_numbers

my $use_numbers = $formatter->use_numbers;
$formatter->use_numbers($use_numbers);

Get/sets if the TAP output should include the test number. Defaults to true. NOTE: the counter will still incrememnt this only toggles if the number should be used in the display.

handle_result

Takes a TB2::Result as an argument and displays the result details.

comment

my $comment = $self->comment(@message);

Will turn the given @message into a TAP comment.

# returns "# Basset houndsgot long ears"
$self->comment("Basset hounds", "got long ears");

SEE ALSO

TB2::Formatter::TAP::v12 TB2::Formatter::TAP::v13 TB2::Formatter::TAP TB2::Formatter