Test2::...Coverage(3)

💖 Test2::EventFacet::Coverage 💖

okay bestie, so this is a page from the User Contributed Perl Documentation set (the perl man pages, yk), and it's all about one lil' facet in the Test2 universe. buckle up, it's coverage time 🎀

---

✨ NAME ✨

Test2::EventFacet::Coverage — it's giving... file coverage information. literally that. that's the whole gig. 💅

---

🦋 DESCRIPTION 🦋

so basically this facet is carrying around a whole list of the files that got covered by your test run. like, "here's everything we touched, bestie, here's the receipts" 📋✨

---

🌸 FIELDS 🌸

these are the lil' accessor things you can pull out of it. each one comes in two flavors — the hash-style {...} and the method-call style — and they give you the exact same thing, so pick your fighter 🫶

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

this one's just a lil' summary of the files that ran. a vibe check on your coverage, if you will. 🍓

---

• $arrayref = $about->{files}
• $arrayref = $about->files()

an arrayref of every file that got touched during testing. and like, everything — this includes modules that were loaded, modules that had subroutines called, and also files that got opened via open(). no file left behind fr fr. 👑

---

• $hashref = $about->{submap}
• $hashref = $about->submap()

this is the subroutine map, and it looks a lil' something like this:

{
    'SomeModule.pm' => {
        # The wildcard is used when a proper sub name cannot be determined
        '*' => { ... },

        'subroutine' => [
            '*',     # The wildcard is used when no 'called by' can be determined
            $FROM_A,
            $FROM_B,
            ...
        ],
    },
    ...
}

so yeah — per module, you get sub names, and for each sub you get who called it. and when the name isn't knowable? wildcard. iconic behaviour honestly ⭐

---

• $hashref = $about->{openmap}
• $hashref = $about->openmap()

the open map. same energy, different list:

{
    # The items in this list can be anything, strings, numbers,
    # data structures, etc.
    # A naive attempt is made to avoid duplicates in this list,
    # so the same string or reference will not appear twice, but 2
    # different references with identical contents may appear.
    "some_file.ext" => [
        '*',        # The wildcard is used when no 'called by' can be determined
        $FROM_A,
        $FROM_b,
    ],
}

okay so real talk about this one: the items in that list can be literally anything — strings, numbers, data structures, whatever. and there's a naive attempt to dodge duplicates, so the same string or the same reference won't show up twice, but two different references with identical contents absolutely can. so don't come for it, it's trying its best 😭💜

---

🔥 SOURCE 🔥

the source code repo for Test2-Plugin-Cover lives right here:

https://github.com/Test-More/Test2-Plugin-Cover

go look, it's free ✨

---

👑 MAINTAINERS 👑

• Chad Granum <exodist@cpan.org>

---

🌈 AUTHORS 🌈

• Chad Granum <exodist@cpan.org>

---

💜 COPYRIGHT 💜

Copyright 2020 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, we ate and left no crumbs 🫶

mwah, this was perl v5.42.3, dated 2026-09-09, and it's part of the User Contributed Perl Documentation. slay, bye 💅✨