Test2:...::Plan(3perl)

📦
version 5.44.0 · 14 versions
, in arch rolling

💖 Test2::Event::Plan — the event of a plan 💖

okay so bestie, welcome to Test2::Event::Plan, straight out of the Perl Programmers Reference Guide! this is the page for the event that fires when a plan gets declared. it's giving "we're doing this many tests, no takebacks" energy ✨

🌸 DESCRIPTION 🌸

Plan events are fired off whenever a plan is declared, when done testing is called, or when a subtext completes. that's it, that's the vibe 💅

✨ SYNOPSIS ✨

use Test2::API qw/context/;
use Test2::Event::Plan;

my $ctx = context();

# Plan for 10 tests to run
my $event = $ctx->plan(10);

# Plan to skip all tests (will exit 0)
$ctx->plan(0, skip_all => "These tests need to be skipped");

look at that. a whole manifesting ritual for your test suite 🎀

🫶 ACCESSORS 🫶

okay so these are the little getters you can hit up on your plan event 👑

  • $num = $plan->max — get the number of expected tests. how many baddies we bringing to the party 💃
  • $dir = $plan->directive — get the directive (such as TODO, skip_all, or no_plan). the mood, the energy, the instruction 🌈
  • $reason = $plan->reason — get the reason for the directive. the "why" behind the whole thing 🧚

🔥 SOURCE 🔥

the source code repository for Test2 can be found at https://github.com/Test-More/test-more/. go be nosy, it's encouraged 💀

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

okay periodt, that's the whole page 💜 this was perl v5.44.0, dated 2026-10-17, and you just got the full Test2:...::Plan(3perl) rundown. slay, go write some plans 🦋⭐

📦 where this page comes from