/ 
perl-5.40.2
⭐ Starred 2013 / Test2::Suite
Security Advisories (7)
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.

CVE-2025-40909 (2025-05-30)

Perl threads have a working directory race condition where file operations may target unintended paths. If a directory handle is open at thread creation, the process-wide current working directory is temporarily changed in order to clone that handle for the new thread, which is visible from any third (or more) thread already running. This may lead to unintended operations such as loading code or accessing files from unexpected locations, which a local attacker may be able to exploit. The bug was introduced in commit 11a11ecf4bea72b17d250cfb43c897be1341861e and released in Perl version 5.13.6

CVE-2026-13221 (2026-07-13)

Perl versions through 5.43.9 produce silently incorrect regular expression matches when an alternation of more than 65535 fixed string branches is compiled into a trie in Perl_study_chunk. When such branches are combined into a trie, the delta between the first branch and the shared tail is stored in a 16-bit field. A branch count above 65535 overflows the field, and the trie's match decision table is truncated with no warning or error. A pattern of this shape produces false positive matches (matching strings it should not) and false negative matches (failing to match strings it should). When such a pattern gates an access or filtering decision, the result is wrong.

CVE-2026-15534 (2026-08-09)

Perl versions through 5.45.1 have out-of-bounds heap reads and writes during regular expression matching via an undersized superlinear cache in S_regmatch. The regex engine's superlinear cache holds one bit per subject position for each participating WHILEM node, so the bit count is the subject length plus one times the number of nodes. Nothing checks that product for positive overflow of the signed 32-bit count: a 286331153 byte subject matched against a pattern with 15 participating nodes stores the count as 14, leaving a two byte cache. The cache is then indexed from the real match position and node number, so reads go past the end of the allocation, and on failure CACHEsayNO sets a bit past it. A caller that matches an attacker controlled subject of this size against a pattern of this shape can crash the process or corrupt heap memory.

CVE-2026-19487 (2026-08-13)

Perl versions from 5.9.4 before 5.41.9 produce incorrect regular expression match results when a stale failure flag ends the Aho-Corasick prescan early in S_find_byclass. The prescan walks the subject for positions where the full pattern could match, and the engine tries it from the leftmost one recorded. A failing transition sets the failed flag, and a later successful transition does not clear it, so the prescan reads the stale flag as a failure and stops before it can record a candidate that starts earlier. It takes a subject where one candidate is recorded and a later character then forces a fallback through a fail link that succeeds. Example: "ABCDE" =~ m/ABCF|BCDE|C/; # matches C at offset 2, not BCDE "ABCDE" =~ m/ABCF|BCDE|C(G)/; # no match, BCDE missed An alternation like this can miss input it should match, or match it on the wrong branch, so an access or filtering decision made from the result can be wrong.

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-57432 (2026-07-13)

Perl versions through 5.43.10 have an integer overflow in S_measure_struct leading to an out-of-bounds heap read in pack and unpack. S_measure_struct adds each item's size times its repeat count to a running total with no overflow check, so a large repeat count in a pack or unpack template wraps the signed SSize_t total negative. The @, X, and x position codes then guard their moves with a signed length comparison that passes when the length is negative, advancing the buffer pointer out of bounds. A template derived from untrusted input can read heap memory past the buffer and return it to the caller.

NAME

Test2::Suite - Distribution with a rich set of tools built upon the Test2 framework.

DESCRIPTION

Rich set of tools, plugins, bundles, etc built upon the Test2 testing library. If you are interested in writing tests, this is the distribution for you.

WHAT ARE TOOLS, PLUGINS, AND BUNDLES?

TOOLS

Tools are packages that export functions for use in test files. These functions typically generate events. Tools SHOULD NEVER alter behavior of other tools, or the system in general.

PLUGINS

Plugins are packages that produce effects, or alter behavior of tools. An example would be a plugin that causes the test to bail out after the first failure. Plugins SHOULD NOT export anything.

BUNDLES

Bundles are collections of tools and plugins. A bundle should load and re-export functions from Tool packages. A bundle may also load and configure any number of plugins.

If you want to write something that both exports new functions, and effects behavior, you should write both a Tools distribution, and a Plugin distribution, then a Bundle that loads them both. This is important as it helps avoid the problem where a package exports much-desired tools, but also produces undesirable side effects.

INCLUDED BUNDLES

Test2::V#

These do not live in the bundle namespace as they are the primary ways to use Test2::Suite.

The current latest is Test2::V0.

use Test2::V0;
# strict and warnings are on for you now.

ok(...);

# Note: is does deep checking, unlike the 'is' from Test::More.
is(...);

...

done_testing;

This bundle includes every tool listed in the "INCLUDED TOOLS" section below, except for Test2::Tools::ClassicCompare. This bundle provides most of what anyone writing tests could need. This is also the preferred bundle/toolset of the Test2 author.

See Test2::V0 for complete documentation.

Extended

** Deprecated ** See Test2::V0

use Test2::Bundle::Extended;
# strict and warnings are on for you now.

ok(...);

# Note: is does deep checking, unlike the 'is' from Test::More.
is(...);

...

done_testing;

This bundle includes every tool listed in the "INCLUDED TOOLS" section below, except for Test2::Tools::ClassicCompare. This bundle provides most of what anyone writing tests could need. This is also the preferred bundle/toolset of the Test2 author.

See Test2::Bundle::Extended for complete documentation.

More
use Test2::Bundle::More;
use strict;
use warnings;

plan 3; # Or you can use done_testing at the end

ok(...);

is(...); # Note: String compare

is_deeply(...);

...

done_testing; # Use instead of plan

This bundle is meant to be a mostly drop-in replacement for Test::More. There are some notable differences to be aware of however. Some exports are missing: eq_array, eq_hash, eq_set, $TODO, explain, use_ok, require_ok. As well it is no longer possible to set the plan at import: use .. tests => 5. $TODO has been replaced by the todo() function. Planning is done using plan, skip_all, or done_testing.

See Test2::Bundle::More for complete documentation.

Simple
use Test2::Bundle::Simple;
use strict;
use warnings;

plan 1;

ok(...);

This bundle is meant to be a mostly drop-in replacement for Test::Simple. See Test2::Bundle::Simple for complete documentation.

INCLUDED TOOLS

Basic

Basic provides most of the essential tools previously found in Test::More. However it does not export any tools used for comparison. The basic pass, fail, ok functions are present, as are functions for planning.

See Test2::Tools::Basic for complete documentation.

Compare

This provides is, like, isnt, unlike, and several additional helpers. Note: These are all deep comparison tools and work like a combination of Test::More's is and is_deeply.

See Test2::Tools::Compare for complete documentation.

ClassicCompare

This provides Test::More flavored is, like, isnt, unlike, and is_deeply. It also provides cmp_ok.

See Test2::Tools::ClassicCompare for complete documentation.

Class

This provides functions for testing objects and classes, things like isa_ok.

See Test2::Tools::Class for complete documentation.

Defer

This provides functions for writing test functions in one place, but running them later. This is useful for testing things that run in an altered state.

See Test2::Tools::Defer for complete documentation.

Encoding

This exports a single function that can be used to change the encoding of all your test output.

See Test2::Tools::Encoding for complete documentation.

Exports

This provides tools for verifying exports. You can verify that functions have been imported, or that they have not been imported.

See Test2::Tools::Exports for complete documentation.

Mock

This provides tools for mocking objects and classes. This is based largely on Mock::Quick, but several interface improvements have been added that cannot be added to Mock::Quick itself without breaking backwards compatibility.

See Test2::Tools::Mock for complete documentation.

Ref

This exports tools for validating and comparing references.

See Test2::Tools::Ref for complete documentation.

Spec

This is an RSPEC implementation with concurrency support.

See Test2::Tools::Spec for more details.

Subtest

This exports tools for running subtests.

See Test2::Tools::Subtest for complete documentation.

Target

This lets you load the package(s) you intend to test, and alias them into constants/package variables.

See Test2::Tools::Target for complete documentation.

INCLUDED PLUGINS

BailOnFail

The much requested "bail-out on first failure" plugin. When this plugin is loaded, any failure will cause the test to bail out immediately.

See Test2::Plugin::BailOnFail for complete documentation.

DieOnFail

The much requested "die on first failure" plugin. When this plugin is loaded, any failure will cause the test to die immediately.

See Test2::Plugin::DieOnFail for complete documentation.

ExitSummary

This plugin gives you statistics and diagnostics at the end of your test in the event of a failure.

See Test2::Plugin::ExitSummary for complete documentation.

SRand

Use this to set the random seed to a specific seed, or to the current date.

See Test2::Plugin::SRand for complete documentation.

UTF8

Turn on utf8 for your testing. This sets the current file to be utf8, it also sets STDERR, STDOUT, and your formatter to all output utf8.

See Test2::Plugin::UTF8 for complete documentation.

INCLUDED REQUIREMENT CHECKERS

AuthorTesting

Using this package will cause the test file to be skipped unless the AUTHOR_TESTING environment variable is set.

See Test2::Require::AuthorTesting for complete documentation.

EnvVar

Using this package will cause the test file to be skipped unless a custom environment variable is set.

See Test2::Require::EnvVar for complete documentation.

Fork

Using this package will cause the test file to be skipped unless the system is capable of forking (including emulated forking).

See Test2::Require::Fork for complete documentation.

RealFork

Using this package will cause the test file to be skipped unless the system is capable of true forking.

See Test2::Require::RealFork for complete documentation.

Module

Using this package will cause the test file to be skipped unless the specified module is installed (and optionally at a minimum version).

See Test2::Require::Module for complete documentation.

Perl

Using this package will cause the test file to be skipped unless the specified minimum perl version is met.

See Test2::Require::Perl for complete documentation.

Threads

Using this package will cause the test file to be skipped unless the system has threading enabled.

Note: This will not turn threading on for you.

See Test2::Require::Threads for complete documentation.

SEE ALSO

See the Test2 documentation for a namespace map. Everything in this distribution uses Test2.

Test2::Manual is the Test2 Manual.

CONTACTING US

Many Test2 developers and users lurk on irc://irc.perl.org/#perl. We also have a slack team that can be joined by anyone with an @cpan.org email address https://perl-test2.slack.com/ If you do not have an @cpan.org email you can ask for a slack invite by emailing Chad Granum <exodist@cpan.org>.

SOURCE

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

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright 2018 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 http://dev.perl.org/licenses/