KiokuD...sitive(3pm)

💖 KiokuDB::Role::Immutable::Transitive — the manual, but make it a vibe 💖

okay bestie, so this one is KiokuDB::Role::Immutable::Transitive, a Perl module page from the 3pm section (that's the Perl 5 module docs, iykyk). it's short, it's sweet, and it's giving very committed energy. let's get into it 🫶

---

✨ NAME ✨

KiokuDB::Role::Immutable::Transitive — a role for immutable objects that only point at other such objects. 🦋

like, it's a role. for immutables. that are transitive. the name literally ate and left no crumbs.

---

🎀 VERSION 🎀

version 0.57 ⭐

that's the one we're talking about, bestie. don't come at me with some other version, this is the version.

---

🌸 SYNOPSIS 🌸

the whole entire move, look at her:

with qw(KiokuDB::Role::Immutable::Transitive);

that's it. that's the whole synopsis. one line. iconic. main character energy fr fr 💅

---

🌈 DESCRIPTION 🌈

okay so here's the tea, and it's genuinely important tea:

this role makes a stronger promise than KiokuDB::Role::Immutable does. like, KiokuDB::Role::Immutable already said "this object is immutable" and everyone was like slay. but this role goes further — it promises that this object and all the objects it points to are immutable. 🫶

the whole little friend group is frozen. the object, its friends, its friends' friends, everybody. no cap. 🧊✨

and because of that, these objects can be freely cached as live instances. why? because none of the data they keep live is ever updated. not once. not ever. it's stable, it's safe, it's not going to surprise you at 2am with a mutation you didn't ask for. so the caching just... works. obsessed. 💖

lowkey the reason this matters: caching live instances is normally the kind of thing that makes you go 😭, because if anything under there mutates, your cache is now lying to you. this role is the "nothing under here ever changes" pinky promise that makes it chill. 🌸

---

👑 AUTHOR 👑

Yuval Kogman <nothingmuch@woobling.org> 💜

thank you for your service, king. the email is literally nothingmuch@woobling.org and honestly? mood. 🎀

---

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2014 by Yuval Kogman, Infinity Interactive.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

so yeah — 2014, Yuval Kogman and Infinity Interactive hold the copyright, and it's free software: redistribute it, modify it, go wild, just keep the same terms as Perl 5 itself. periodt. 💅

---

okay that's the whole page, bestie, and yes it was short, but short and flawless is a look. this was rendered from perl v5.34.0, dated 2022-05-23, in the KiokuD...sitive(3pm) page family. mwah. 🦋💖✨