NAME

Test2::Harness::Collector::TapParser - Produce EventFacets from a line of TAP.

DESCRIPTION

This module is responsible for reading and processing any TAP output from tests. Lines of TAP output are processed into Test2::Event facet data. Note that Test2 -> TAP -> Test2 is lossy at the Test2 -> TAP step.

SYNOPSIS

use Test2::Harness::Collector::TapParser qw/parse_tap_line/;

my $facet_data = parse_tap_line("1..1");
is(
    $facet_data,
    {
        trace => {nested => 0},
        hubs  => [{nested => 0}],
        plan  => {
            details => '',
            count   => 1,
            skip    => 0,
        },
    },
    "Parsed the plan"
);

$facet_data = parse_tap_line("# foo");
is(
    $facet_data,
{
          trace => { nested => 0 },
          hubs => [ { nested => 0 } ],
          info => [
                      {
                        tag => 'NOTE',
                        details => 'foo',
                        debug => 0,
                      },
                    ],
        },

    "Parsed the note"
);

$facet_data = parse_tap_line("ok 1");
is(
    $facet_data,
    {
        trace  => {nested => 0},
        hubs   => [{nested => 0}],
        assert => {
            no_debug => 1,
            pass     => 1,
            number   => '1',
            details  => '',
        },
    },
    "Parsed the assertion"
);

EXPORTS

$facet_data = parse_tap_line($line)

Parse a line of TAP. It is assumed to be STDOUT thus all comments are turned into notes. Using this export will NOT add the usual from_tap facet. It is better to use one of the other 2 exports.

$facet_data = parse_stdout_tap($line)

Parse a line of TAP from stdout.

$facet_data = parse_stderr_tap($line)

Parse a line of TAP from stderr. This will ONLY parse comment lines (ones that start with a #, which may be indented). All comments will be treated as diag's, all other lines will be ignored.

SOURCE

The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright 2020 Chad Granum <exodist7@gmail.com>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/