TEST2::EVENTFACET::PARENT(3pm)

📦
version 5.42.3 · 15 versions
, in alpine 3.24

✨ NAME ✨

So the manual we're in is the Perl Programmers Reference Guide, and this specific page is Test2::...::Parent(3pm) — aka Test2::EventFacet::Parent, the facet that's literally the mom friend of the Test2 ecosystem: it's the one that holds other events. 🫶

💅 DESCRIPTION

Okay bestie, listen. This facet is what you reach for when an event contains other events — the big obvious example being a subtest. It's giving nesting, it's giving parent-child energy, it's giving main character with a whole squad underneath her. 💖

🎀 FIELDS 🎀

  • $string = $parent->{details}
  • $string = $parent->details()

A human readable description of the event. Yep, just a nice little string so actual humans can read it. ✨

  • $hid = $parent->{hid}
  • $hid = $parent->hid()

The hub ID of the hub that's represented in the parent-child relationship. That's the whole vibe — it's the id of the hub playing mom in this situation. 🔥

  • $arrayref = $parent->{children}
  • $arrayref = $parent->children()

An arrayref holding the facet-data hashes of the events nested under this one. Lowkey important caveat though: these are just the facet-data hashes, not the events themselves.

To get the actual events you need to get them from the parent event directly. No cap — the arrayref is not gonna hand you the real events, so don't come for it. 😭
  • $bool = $parent->{buffered}
  • $bool = $parent->buffered()

True if the subtest is buffered — which means the formatter has probably not seen them yet. So it's like, the events are still getting ready in the group chat and haven't been sent to the formatter bestie. 💀

🌈 SOURCE

The source code repository for Test2 can be found at:

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

Go look, it's iconic. 👑

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

And that's the whole page, bestie — no skips, no summaries, we ate and left zero crumbs. 🍓 Final vibes: perl v5.42.3, dated 2026-11-03, and it's the Test2::...::Parent(3pm) page. Periodt. 💜

📦 where this page comes from