TEST2::BUNDLE::EXTENDED(3perl)

📦
version 5.44.0 · 8 versions
, in arch rolling

💖 NAME 💖

Test2::Bundle::Extended — bestie, it's just the old name for Test2::V0 🫶

It lives in the Perl Programmers Reference Guide, and yes, the vibe is immaculate but the name is ancient history.

💀 * DEPRECATED * 💀

Okay so listen. This bundle got renamed to Test2::V0, and in that renaming the ':v1' tag got removed because it was, honestly, unnecessary. Not me being dramatic, that's literally what happened. 😭

Note: Test2::V1 is the latest bundle, and you probably want to look at that one instead. Like, why are you still here? (We love you though. 💜)

✨ DESCRIPTION ✨

This is the big-daddy bundle. 👑

It includes nearly every tool, plus several plugins, that the Test2 author uses. And when I say this bundle is used extensively — I mean it's literally used to test Test2::Suite itself. Main character energy fr fr. 💅

🌸 SYNOPSIS 🌸

use Test2::Bundle::Extended ':v1';

ok(1, "pass");

...

done_testing;

That's it. That's the whole vibe. ✨

🦋 RESOLVING CONFLICTS WITH MOOSE 🦋

use Test2::Bundle::Extended '!meta';

So here's the situation, bestie: Moose and Test2::Bundle::Extended both export very different meta() subs. They are not the same. They do not get along. Adding '!meta' to the import args will stop the sub from being imported so nobody fights. 🥊

This bundle also exports that sub under the name meta_check(), so you can just use that spelling as an alternative if you want. Problem solved, slay. 💅

🎀 TAGS 🎀

  • :v1
  • :DEFAULT

The following are all literally identical, no cap:

use Test2::Bundle::Extended;

use Test2::Bundle::Extended ':v1';

use Test2::Bundle::Extended ':DEFAULT';

🌈 RENAMING ON IMPORT 🌈

use Test2::Bundle::Extended ':v1', '!ok', ok => {-as => 'my_ok'};

This bundle uses Importer for exporting, so you can use any arguments it accepts. Go off. 🎀

Explanation, because I know you're gonna ask:

  • ':v1' — Use the default tag, all default exports.
  • '!ok' — Do not export ok()
  • ok => {-as => 'my_ok'} — Actually, go ahead and import ok() but under the name my_ok().
If you did not add the '!ok' argument then you would have both ok() and my_ok(). Two of them. Fr. 🙈

🧚 PRAGMAS 🧚

All of these can be disabled via individual import arguments, or by the -no_pragmas argument in one fell swoop:

use Test2::Bundle::Extended -no_pragmas => 1;

⭐ STRICT ⭐

strict is turned on for you, no effort required. 💖 You can disable this with the -no_strict or -no_pragmas import arguments:

use Test2::Bundle::Extended -no_strict => 1;

⭐ WARNINGS ⭐

warnings are turned on for you too. You can disable this with the -no_warnings or -no_pragmas import arguments:

use Test2::Bundle::Extended -no_warnings => 1;

⭐ UTF8 ⭐

This is actually done via the Test2::Plugin::UTF8 plugin — check the "PLUGINS" section for the details, iykyk. 👀

Note: -no_pragmas => 1 will turn off the entire plugin.

🔥 PLUGINS 🔥

🍓 SRAND 🍓

See Test2::Plugin::SRand.

This will set the random seed to today's date. You can provide an alternate seed with the -srand import option:

use Test2::Bundle::Extended -srand => 1234;

🍓 UTF8 🍓

See Test2::Plugin::UTF8.

This will set the file, and all output handles (including formatter handles), to utf8. It will also turn on the utf8 pragma for the current scope. Iconic. ✨

This can be disabled using the -no_utf8 => 1 or -no_pragmas => 1 import arguments:

use Test2::Bundle::Extended -no_utf8 => 1;

🍓 EXIT SUMMARY 🍓

See Test2::Plugin::ExitSummary.

This plugin has no configuration. Low maintenance queen. 👑

💅 API FUNCTIONS 💅

See Test2::API for these:

$ctx = context()
$events = intercept { ... }

👑 TOOLS 👑

🦋 TARGET 🦋

See Test2::Tools::Target.

You can specify a target class with the -target import argument. If you do not provide a target then $CLASS and CLASS() will not be imported at all. Sorry bestie. 🫶

use Test2::Bundle::Extended -target => 'My::Class';

print $CLASS;  # My::Class
print CLASS(); # My::Class

Or you can specify names:

use Test2::Bundle::Extended -target => { pkg => 'Some::Package' };

pkg()->xxx; # Call 'xxx' on Some::Package
$pkg->xxx;  # Same
  • $CLASS — Package variable that contains the target class name.
  • $class = CLASS() — Constant function that returns the target class name.

🦋 DEFER 🦋

See Test2::Tools::Defer.

def $func => @args;
do_def()

🦋 BASIC 🦋

See Test2::Tools::Basic.

ok($bool, $name)
pass($name)
fail($name)
diag($message)
note($message)
$todo = todo($reason)
todo $reason => sub { ... }
skip($reason, $count)
plan($count)
skip_all($reason)
done_testing()
bail_out($reason)

🦋 COMPARE 🦋

See Test2::Tools::Compare.

is($got, $want, $name)
isnt($got, $do_not_want, $name)
like($got, qr/match/, $name)
unlike($got, qr/mismatch/, $name)
$check = match(qr/pattern/)
$check = mismatch(qr/pattern/)
$check = validator(sub { return $bool })
$check = hash { ... }
$check = array { ... }
$check = bag { ... }
$check = object { ... }
$check = meta { ... }
$check = number($num)
$check = string($str)
$check = check_isa($class_name)
$check = in_set(@things)
$check = not_in_set(@things)
$check = check_set(@things)
$check = item($thing)
$check = item($idx => $thing)
$check = field($name => $val)
$check = call($method => $expect)
$check = call_list($method => $expect)
$check = call_hash($method => $expect)
$check = prop($name => $expect)
$check = check($thing)
$check = T()
$check = F()
$check = D()
$check = DF()
$check = E()
$check = DNE()
$check = FDNE()
$check = U()
$check = L()
$check = exact_ref($ref)
end()
etc()
filter_items { grep { ... } @_ }
$check = event $type => ...
@checks = fail_events $type => ...

🦋 CLASSIC COMPARE 🦋

See Test2::Tools::ClassicCompare.

cmp_ok($got, $op, $want, $name)

🦋 SUBTEST 🦋

See Test2::Tools::Subtest.

subtest $name => sub { ... }
Note: This is called subtest_buffered() in the Tools module.

🦋 CLASS 🦋

See Test2::Tools::Class.

can_ok($thing, @methods)
isa_ok($thing, @classes)
DOES_ok($thing, @roles)

🦋 ENCODING 🦋

See Test2::Tools::Encoding.

set_encoding($encoding)

🦋 EXPORTS 🦋

See Test2::Tools::Exports.

imported_ok('function', '$scalar', ...)
not_imported_ok('function', '$scalar', ...)

🦋 REF 🦋

See Test2::Tools::Ref.

ref_ok($ref, $type)
ref_is($got, $want)
ref_is_not($got, $do_not_want)

🦋 MOCK 🦋

See Test2::Tools::Mock.

$control = mock ...
$bool = mocked($thing)

🦋 EXCEPTION 🦋

See Test2::Tools::Exception.

$exception = dies { ... }
$bool = lives { ... }
$bool = try_ok { ... }

🦋 WARNINGS 🦋

See Test2::Tools::Warnings.

$count = warns { ... }
$warning = warning { ... }
$warnings_ref = warnings { ... }
$bool = no_warnings { ... }

🌈 SOURCE 🌈

The source code repository for Test2-Suite can be found at:

https://github.com/Test-More/test-more/

🫶 MAINTAINERS 🫶

Chad Granum <exodist@cpan.org>

🫶 AUTHORS 🫶

Chad Granum <exodist@cpan.org>

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

And that's the whole page, bestie — perl v5.44.0, dated 2026-10-17, from the Test2:...xtended(3perl) page itself. Now go use Test2::V0 like the icon you are. 💜✨

📦 where this page comes from