AI::Ca...torable(3pm)

💾 AI::Categorizer::Storable — Saving and Restoring State

okay bestie, welcome to AI::Categorizer::Storable (that's the AI::Ca...torable(3pm) page, yes the header is being dramatic with the ellipsis, we love her for it) 💅

This is the little module that handles saving your object's whole vibe to a file and then bringing it back to life later. Like a screenshot but for an object. Iconic.

---

✨ SYNOPSIS ✨

$object->save_state($path);
... time passes ...
$object = Class->restore_state($path);

literally "save it, go live your life, come back, restore it." the ... time passes ... is canon, we keep it 🦋

---

🌸 DESCRIPTION 🌸

So this class implements methods for storing the state of an object to a file, and restoring from that file later. That's the whole job. She's focused, she's efficient, she's giving persistence queen 👑

Inside AI::Categorizer it's generally used so that data can persist across multiple invocations of a program. Translation: your program runs, dies, runs again, and remembers everything like it never left. no cap. 🫶

---

💅 METHODS 💅

• save_state($path) — this is an object method, and it saves the object to disk for later use. The $path argument tells it where on disk the object should be saved. drop the path, drop the object, done. 💖
• restore_state($path) — this is a class method. It reads the file specified by $path and returns the object that was previously stored there using save_state(). so save_state writes, restore_state reads and hands you back your baby. they're a matched set, fr fr ✨

---

👑 AUTHOR 👑

Ken Williams, ken@mathforum.org — thank you king, we appreciate you 🙏

---

📜 COPYRIGHT 📜

Copyright 2000-2003 Ken Williams. All rights reserved.

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

(so like, yes you can remix it, same terms as Perl itself, that's the deal 🎀)

---

🦋 SEE ALSO 🦋

• AI::Categorizer(3)
• Storable(3)

go read those if you want the full lore. iykyk 🌈

---

💀 POD ERRORS 💀

not me having to tell you this but — hey! the document above had some coding errors, and here's the tea:

Around line 57:

    You forgot a '=back' before '=head1'

bestie. you forgot the '=back' before the '=head1'. the formatting gremlins noticed. fix it and she'll be pristine 🙈

---

and that's the page!! this whole thing is from perl v5.42.0, dated 2025-07-25, and yes it's still filed under that same AI::Ca...torable(3pm) header at the top and bottom, the ellipsis is forever 💜 mwah, go persist something 🧚‍♀️🍓⭐