NAME
TAP::Formatter::HTML - TAP Test Harness output delegate for html output
SYNOPSIS
use TAP::Harness;
my @tests = glob( 't/*.t' );
my $harness = TAP::Harness->new({ formatter_class => 'TAP::Formatter::HTML',
merge => 1 });
$harness->runtests( @tests );
# prints HTML to STDOUT by default
# or if you don't want STDERR merged in:
my $harness = TAP::Harness->new({ formatter_class => 'TAP::Formatter::HTML' });
# to use a custom formatter:
my $fmt = TAP::Formatter::HTML->new;
$fmt->css_uris([])->inline_css( $my_css )
->js_uris(['http://mysite.com/jquery.js', 'http://mysite.com/custom.js'])
->inline_js( '$(div.summary).hide()' );
my $harness = TAP::Harness->new({ formatter => $fmt, merge => 1 });
# you can use your own customized templates too:
$fmt->template('custom.tt2')
->template_processor( Template->new )
->force_inline_css(0);
DESCRIPTION
This provides html output formatting for TAP::Harness.
Documentation is rather sparse at the moment.
METHODS
CONSTRUCTOR
new( \%args )
ACCESSORS
All chaining accessors:
verbosity( [ $v ] )
Verbosity level, as defined in "new" in TAP::Harness:
1 verbose Print individual test results (and more) to STDOUT.
0 normal
-1 quiet Suppress some test output (eg: test failures).
-2 really quiet Suppress everything but the HTML report.
-3 silent Suppress all output, including the HTML report.
Note that the report is also available via "html".
stdout( [ \*FH ] )
A filehandle for catching standard output. Defaults to "STDOUT".
escape_output( [ $boolean ] )
If set, all output to "stdout" is escaped. This is probably only useful
if you're testing the formatter. Defaults to 0.
html( [ \$html ] )
This is a reference to the scalar containing the html generated on the
last test run. Useful if you have "silent" on.
tests( [ \@test_files ] )
A list of test files we're running, set by TAP::Parser.
session_class( [] )
Class to use for TAP::Parser test sessions. You probably won't need to
use this unless you're hacking or sub-classing the formatter. Defaults
to TAP::Formatter::HTML::Session.
sessions( [ \@sessions ] )
Test sessions added by TAP::Parser. You probably won't need to use this
unless you're hacking or sub-classing the formatter.
template_processor( [ $processor ] )
The template processor to use. Defaults to a TT2 Template processor with
the following config:
COMPILE_DIR => catdir( tempdir(), 'TAP-Formatter-HTML' ),
COMPILE_EXT => '.ttc',
INCLUDE_PATH => join(':', @INC),
template( [ $file_name ] )
The template file to load. Defaults to
"TAP/Formatter/HTML/default_report.tt2".
css_uris( [ \@uris ] )
A list of URIs (or strings) to include as external stylesheets in