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

cpanm Test::Simple

perl -MCPAN -e shell
install Test::Simple