MooseX...eferred(3pm)

🌸 MooseX::Storage::Deferred 💖

okay so bestie, you're reading a page from the User Contributed Perl Documentation, and it's all about MooseX::Storage::Deferred — currently sitting at version 0.53 ✨. Let's get into it, no cap.

---

✨ NAME

MooseX::Storage::Deferred — a role for indecisive programmers 🦋 (and honestly? relatable, because who wants to commit to a serialization format at class-definition time)

---

💅 VERSION

version 0.53 ⭐

---

🎀 SYNOPSIS

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

with 'MooseX::Storage::Deferred';

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
## (in this case JSON)

# pack the class into a JSON string
$p->freeze({ format => 'JSON' }); # { "__CLASS__" : "Point", "x" : 10, "y" : 10 }

# pack the class into a JSON string using parameterized JSONpm role
$p->freeze({ format => [ JSONpm => { json_opts => { pretty => 1 } } ] });

# unpack the JSON string into a class
my $p2 = Point->thaw(
    '{ "__CLASS__" : "Point", "x" : 10, "y" : 10 }',
    { format => 'JSON' }
);

like… you literally decide the format at call time and not one second before?? iconic behavior honestly 🫶

---

🌈 DESCRIPTION

So this role exists for those moments when you need to serialize into a whole bunch of different formats, or a bunch of different I/O options, and you wanna keep your options open 💫

Basically? It lets you pick the format and the I/O options only at the exact moment you actually use them. Not before, not after. At use time. Periodt. (peep the SYNOPSIS above if you want the receipts 👀)

---

🌟 SUPPORTED FORMATS

• JSON
• JSONpm
• YAML
• Storable

---

🦋 SUPPORTED I/O

• File
• AtomicFile

⚠️ NOTE: The StorableFile I/O option is not supported, and here's the tea — it's because it does not mix well with options who also have a "thaw" and "freeze" methods like this one 🙈. It is possible to probably work around this issue, but the author doesn't currently have the need for it. If you do need this supported, talk to them and they will see what they can do 💬

---

💜 METHODS

• freeze ($type_desc)
• thaw ($data, $type_desc)
• load ($filename, $type_desc)
• store ($filename, $type_desc)

---

🍓 SUPPORT

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Storage> (or to <mailto:bug-MooseX-Storage@rt.cpan.org>) ✨

There is also a mailing list available for users of this distribution, at <http://lists.perl.org/list/moose.html> 💌

There is also an irc channel available for users of this distribution, at "#moose" on "irc.perl.org" <irc://irc.perl.org/#moose> 🔥

---

👑 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.

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

---

and that's the whole page bestie, we ate 🍽️💅 sign-off time: this doc came from perl v5.36.0 and it's dated 2022-10-16 — go forth and defer your formats, main character 💖✨