TEST2::EVENTFACET::PLAN(3pm)

📦
version 5.42.3 · 15 versions
, in alpine 3.24

🎀 NAME 🎀

Test2::EventFacet::Plan — the facet for setting the plan, bestie 💅

This page lives in the Perl Programmers Reference Guide, and it’s the Test2::EventFacet::Plan(3pm) manual page. Obsessed with a plan facet that knows its purpose? Same.

💅 DESCRIPTION 💅

When events need to set the plan, they use this facet. That’s the whole vibe check: it’s the plan-setting facet, periodt ✨

🔥 FIELDS 🔥

  • $string = $plan->{details} / $string = $plan->details() — a human-readable explanation for why this plan is being set. Most formatters normally don’t render this, except when the skip field is also set. So it’s lowkey a special-occasion field 💖
  • $positive_int = $plan->{count} / $positive_int = $plan->count() — sets the number of expected assertions. Usually this should be set to 0 when skip or none is also set. Numbers, but make it make sense 🎀
  • $bool = $plan->{skip} / $bool = $plan->skip() — when true, the entire test should be skipped. This is usually paired with an explanation in the details field, plus a control facet that has terminate set to 0. Skip responsibly, bestie 🦋
  • $bool = $plan->{none} / $bool = $plan->none() — mainly used by legacy Test::Builder tests that set the plan to “no plan”, a construct that predates the much better done_testing(). If you’re using this in non-legacy code, you may need to reconsider the course of your life — maybe a hermitage would suite you? 😭 (their words, not mine)

🌈 SOURCE 🌈

The source code repository for Test2 can be found at https://github.com/Test-More/test-more/ — go peek, it’s giving main character energy 👑

👑 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/

That’s the page, bestie — source/version perl v5.42.3, dated 2026-11-03. Mwah, bye 💋✨

📦 where this page comes from