/ 
perl-5.42.0
⭐ Starred 2013 / Test2::Event::V2
Security Advisories (2)
CVE-2026-4176 (2026-03-29)

Perl versions from 5.9.4 before 5.40.4-RC1, from 5.41.0 before 5.42.2-RC1, from 5.43.0 before 5.43.9 contain a vulnerable version of Compress::Raw::Zlib. Compress::Raw::Zlib is included in the Perl package as a dual-life core module, and is vulnerable to CVE-2026-3381 due to a vendored version of zlib which has several vulnerabilities, including CVE-2026-27171. The bundled Compress::Raw::Zlib was updated to version 2.221 in Perl blead commit c75ae9cc164205e1b6d6dbd57bd2c65c8593fe94.

CVE-2026-8376 (2026-05-25)

Perl versions through 5.43.10 have a heap buffer overflow when compiling regular expressions with a repeated fixed string on 32-bit builds. Perl_study_chunk in regcomp_study.c checked the size of the joined substring buffer in characters rather than bytes. For a quantified fixed substring with a large minimum count, the byte length mincount * l could overflow SSize_t, producing an undersized SvGROW allocation; the subsequent copy writes past the end of the buffer. A caller that compiles an attacker-controlled regular expression on a 32-bit perl build triggers a heap buffer overflow at compile time.

NAME

Test2::Event::V2 - Second generation event.

DESCRIPTION

This is the event type that should be used instead of Test2::Event or its legacy subclasses.

SYNOPSIS

USING A CONTEXT

use Test2::API qw/context/;

sub my_tool {
    my $ctx = context();

    my $event = $ctx->send_ev2(info => [{tag => 'NOTE', details => "This is a note"}]);

    $ctx->release;

    return $event;
}

USING THE CONSTRUCTOR

use Test2::Event::V2;

my $e = Test2::Event::V2->new(
    trace => {frame => [$PKG, $FILE, $LINE, $SUBNAME]},
    info  => [{tag => 'NOTE', details => "This is a note"}],
);

METHODS

This class inherits from Test2::Event.

$fd = $e->facet_data()

This will return a hashref of facet data. Each facet hash will be a shallow copy of the original.

$about = $e->about()

This will return the 'about' facet hashref.

NOTE: This will return the internal hashref, not a copy.

$trace = $e->trace()

This will return the 'trace' facet, normally blessed (but this is not enforced when the trace is set using set_trace().

NOTE: This will return the internal trace, not a copy.

MUTATION

$e->add_amnesty({...})

Inherited from Test2::Event. This can be used to add 'amnesty' facets to an existing event. Each new item is added to the END of the list.

NOTE: Items ARE blessed when added.

$e->add_hub({...})

Inherited from Test2::Event. This is used by hubs to stamp events as they pass through. New items are added to the START of the list.

NOTE: Items ARE NOT blessed when added.

$e->set_uuid($UUID)

Inherited from Test2::Event, overridden to also vivify/mutate the 'about' facet.

$e->set_trace($trace)

Inherited from Test2::Event which allows you to change the trace.

Note: This method does not bless/clone the trace for you. Many things will expect the trace to be blessed, so you should probably do that.

LEGACY SUPPORT METHODS

These are all imported from Test2::Util::Facets2Legacy, see that module or Test2::Event for documentation on what they do.

causes_fail
diagnostics
global
increments_count
no_display
sets_plan
subtest_id
summary
terminate

THIRD PARTY META-DATA

This object consumes Test2::Util::ExternalMeta which provides a consistent way for you to attach meta-data to instances of this class. This is useful for tools, plugins, and other extensions.

SOURCE

The source code repository for Test2 can be found at https://github.com/Test-More/test-more/.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright Chad Granum <exodist@cpan.org>.

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

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