KiokuD...rySafe(3pm)

💖 KiokuDB::Backend::Role::BinarySafe 💖

okay bestie, welcome to the 3pm section of the manual — this is the one and only KiokuDB::Backend::Role::BinarySafe, an informational role for binary-data-safe backends. it's short, it's sweet, it's giving "I'm just here to send a message" energy. 🎀

---

✨ NAME ✨

KiokuDB::Backend::Role::BinarySafe — an informational role for backends that are binary-data safe. no cap, that's the whole job description. 👑

---

🌸 VERSION 🌸

version 0.57. yes she has a number, she's official. 💅

---

🦋 SYNOPSIS 🦋

so like, here's how you actually consume her. you write this in your own backend package:

package KiokuDB::Backend::MySpecialBackend;
use Moose;

use namespace::clean -except => 'meta';

with qw(KiokuDB::Backend::Role::BinarySafe);

that's it. you with her and you're in the club. 🔥

---

💜 DESCRIPTION 💜

okay so listen. this role is informational — meaning she doesn't really do anything, she just announces a fact about you to the world. and that fact is: this backend can store arbitrary binary strings, especially utf8 data as bytes, without reinterpreting it as unicode strings when inflating. she's basically a little badge you wear that says "I don't mess up your bytes." ⭐

and ngl, this mostly has to do with KiokuDB::Backend::Serialize variants. for example:

• KiokuDB::Backend::Serialize::Storable — binary safe ✅ slay
• KiokuDB::Backend::Serialize::JSON — not binary safe 😭 not her fault, JSON is just like that

so if your serialize layer is the Storable kind, you get to wear the badge. if it's the JSON kind, you do not. vibe check failed, respectfully. 💀

---

🫶 AUTHOR 🫶

Yuval Kogman <nothingmuch@woobling.org> — the icon who wrote this. 👑

---

🎀 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 like, go off, remix it, just keep the receipts. 💖

---

and that's the whole page, bestie, you ate it. 🍓 one last thing for the sign-off: this beauty was built for perl v5.34.0 and the page is dated 2022-05-23. periodt. 💅✨🌈