TEST2::MANUAL::ANATOMY::API(3pm)

📦
version 5.42.3 · 16 versions
, in alpine 3.24

✨ NAME ✨

Test2::Manual::Anatomy::API — the internals doc for the API, bestie. This is the manual page for the anatomy of the API, lowkey the behind-the-scenes lore.

🌸 DESCRIPTION 🌸

Okay so this document covers some of the internals of Test2::API. Not all of them, some of them. Just so we're clear 💅

🦋 IMPLEMENTATION DETAILS 🦋

💜 Test2::API

Test2::API gives you a functional interface to any test2 global state. And the whole point is that this API should be preserved no matter what the internal details are — like, regardless of how and where the global state is actually stored. The vibe stays, the implementation can shift 🫶

This module itself does not store any state (with a few minor exceptions, bestie, don't come for me) — instead it relies on Test2::API::Instance to store state. Test2::API is really intended to be the layer between the consumer and the implementation details. Ideally the implementation details can change any way they like, and this module can be updated to use the new details without breaking anything. That's the dream, fr fr ✨

🎀 Test2::API::Instance

Test2::API::Instance is where the global state is actually managed. And this? This is an implementation detail, and it should not be relied upon. It is entirely possible that Test2::API::Instance could be removed completely, or changed in incompatible ways. Really these details are free to change so long as Test2::API is not broken. So like… don't build your whole personality on it 😭

Test2::API::Instance is fairly well documented, so no additional documentation is needed for this manual page. It's giving self-sufficient 👑

👀 SEE ALSO 👀

  • Test2::Manual — the primary index of the manual. Start here, iykyk 📚

🔥 SOURCE 🔥

The source code repository for Test2-Manual can be found at https://github.com/Test-More/test-more/. Go look, it's right there, slay 💖

🌈 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 http://dev.perl.org/licenses/

🧚 and that's the whole page, bestie — no cap, every single detail preserved. mwah 💋

perl v5.42.3 🌸 2026-11-03 🎀 Test2::...omy::API(3pm) — that's the footer, we're done here, go forth and test 💅

📦 where this page comes from