MooseX...torable(3pm)

💖 MooseX::Storage::Format::Storable — the vibe check 💖

okay bestie, so the manpage header calls this one MooseX...torable(3pm) (they really truncated it mid-word, the audacity 😭) and it's a User Contributed Perl Documentation page, and it's a Storable serialization role. that's the whole NAME section, no notes.

✨ VERSION ✨

this is version 0.53. periodt.

🎀 SYNOPSIS 🎀

here's the whole thing, verbatim, no edits, i would never:

package Point;
use Moose;
use MooseX::Storage;

with Storage('format' => 'Storable');

has 'x' => (is => 'rw', isa => 'Int');
has 'y' => (is => 'rw', isa => 'Int');

1;

my $p = Point->new(x => 10, y => 10);

## methods to freeze/thaw into
## a specified serialization format

# pack the class with Storable
my $storable_data = $p->freeze();

# unpack the storable data into the class
my $p2 = Point->thaw($storable_data);

---

🦋 DESCRIPTION 🦋

so what this module actually does: it "thaw"s and "freeze"s your Moose classes using Storable. that's it. that's the job. it uses Storable::nfreeze by default, and the reason is lowkey iconic — that default means it plays nice in IPC scenarios, whether you're going across machines or just hanging out locally. 💅

now here's the one important thing you NEED to know, and i'm saying it loud: this module does not mix well with the IO modules. the structures that freeze and thaw are working with are Storable's memory representation, and (as far as the author knows) that's not easily just written onto a file. so if your whole thing is file based serialization with Storable? bestie go look at the MooseX::Storage::IO::StorableFile role instead. that's the one you want. not this one. 🫶

🌸 METHODS 🌸

• freeze — freezes it, that's the move
• thaw ($stored) — thaws $stored back into a class

🌈 SUPPORT 🌈

bugs? yeah you can submit those through the RT bug tracker at <https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Storage> — or if email is more your vibe, bug-MooseX-Storage@rt.cpan.org <mailto:bug-MooseX-Storage@rt.cpan.org>. either works, no gatekeeping. 💌

there's also a mailing list for users of this distribution, hanging out at <http://lists.perl.org/list/moose.html>.

and there's an irc channel for users of this distribution too: #moose on irc.perl.org <irc://irc.perl.org/#moose>. come say hi, we don't bite. 🌸

👑 AUTHORS 👑

• Chris Prather <chris.prather@iinteractive.com>
• Stevan Little <stevan.little@iinteractive.com>
• יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>

💜 COPYRIGHT AND LICENSE 💜

this software is copyright (c) 2007 by Infinity Interactive, Inc.

it's free software, babes! you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay. ✨

---

and that's the page, bestie 🎀 this was perl v5.36.0, dated 2022-10-16, and yeah, the footer still insists on calling it MooseX...torable(3pm) — iconic of it honestly 💀 mwah, go freeze something. 💅