TEST2::EVENT::V2(3perl)

💖 Test2::Event::V2 — the perl pragma doc, but make it cute 💖

okay bestie, this is the page from the Perl Programmers Reference Guide for Test2::Event::V2, and it's genuinely one of my faves so let's get into it ✨

---

🌸 NAME 🌸

Test2::Event::V2 — the second generation event. glow-up event, fr fr 👑

---

🦋 DESCRIPTION 🦋

so like, THIS is the event type you should be using. not Test2::Event, not its legacy subclasses — those are giving "hand-me-down", and this is giving main character energy. use this one instead. periodt 💅

---

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

heads up: this class inherits from Test2::Event. we're building on the family legacy 💜

• $fd = $e->facet_data() — hands you back a hashref of facet data. every facet hash in there is a shallow copy of the original, so you can't mess with the real ones by accident. respectful king behavior 🫶
• $about = $e->about() — gives you the 'about' facet hashref.

⚠️ NOTE: this gives you the internal hashref, NOT a copy. so like, pls be careful with it bestie 😭

• $trace = $e->trace() — gives you the 'trace' facet, which is normally blessed (but that's not enforced when the trace gets set using set_trace()).

⚠️ NOTE: again, this is the internal trace, not a copy. literally the same warning, different facet 🙈

🔥 MUTATION

• $e->add_amnesty({...}) — inherited from Test2::Event. you use this to add 'amnesty' facets onto an event that already exists. each new item goes onto the END of the list.

💖 NOTE: items ARE blessed when they get added. fancy.

• $e->add_hub({...}) — inherited from Test2::Event. hubs use this to stamp events as they pass through. new items go onto the START of the list (yes, the opposite of the one above, stay woke 👀).

💀 NOTE: items ARE NOT blessed when they get added. no fancy for these ones.

• $e->set_uuid($UUID) — inherited from Test2::Event, but overridden here so it also vivifies/mutates the 'about' facet. multitasking icon ⭐
• $e->set_trace($trace) — inherited from Test2::Event, lets you swap out the trace.

⚠️ Note: this method does not bless/clone the trace for you. and a LOT of stuff out there expects the trace to be blessed, so like… you should probably do that yourself. not me having to tell you twice 🍓

🌈 LEGACY SUPPORT METHODS

every single one of these is imported from Test2::Util::Facets2Legacy — go read that module or Test2::Event if you wanna know what they actually do, i'm not unlocking that lore here 🙈

• 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 gives you a consistent way to attach meta-data onto instances of this class. super useful if you're out here building tools, plugins, and other extensions — it's giving pluggable ✨

---

🌸 SOURCE 🌸

the source code repo for Test2 lives at https://github.com/Test-More/test-more/ — go be nosy, it's fine 💜

---

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

---

and that's the whole page bestie, no cap 🫶 this was perl v5.44.0, dated 2026-10-17, from Test2::Event::V2(3perl). slay, go write some events 💖✨🎀