NAME

TB2::Streamer::Print - A simple streamer that prints

SYNOPSIS

    use TB2::Streamer::Print;

    my $streamer = TB2::Streamer::Print;

    $streamer->write( out => "something something" );
    $streamer->write( err => "something's wrong!" );

    # Redirect out to a new filehandle.
    $streamer->output_fh($fh);

DESCRIPTION

This is a TB2::Streamer which prints to a filehandle.

You are encouraged to subclass this Streamer if you're writing one which prints.

Destinations

These are the destinations understood by $streamer->write.

out

Where normal output goes. This connects to $streamer->output_fh.

err

Where ad-hoc user visible comments go. This connects to $streamer->error_fh.

Attributes

output_fh

This is the filehandle for normal output. For example, TAP or XML or HTML or whatever records the test state.

Defaults to a copy of STDOUT. This allows tests to muck around with STDOUT without it affecting test results.

error_fh

This is the filehandle for error output. This is normally human readable information about the test as its running. It is not part of the TAP or XML or HTML or whatever.

Defaults to a copy of STDERR. This allows tests to muck around with STDERR without it affecting test results.

stdout

Contains a duplicated copy of STDOUT. Handy for resetting the output_fh().

It is read only.

stderr

Contains a duplicated copy of STDERR. Handy for resetting the error_fh().

It is read only.

Methods

safe_print

    $streamer->safe_print($fh, @hunks);

Works like print but is not effected by the global variables which change print's behavior such as $\ and $,. This allows a test to play with these variables without affecting test output.

Subclasses are encouraged to take advantage of this method rather than calling print themselves.

cpanm Test::Simple

perl -MCPAN -e shell
install Test::Simple