Crypt:...e::File(3pm)

💖 Crypt::Random::Source::Base::File(3pm) 💖

okay so bestie, welcome to the manual page for Crypt::Random::Source::Base::File — it's a lil Perl module, it lives in the "User Contributed Perl Documentation" section of your man pages (section 3pm, iykyk), and it's literally the blueprint every file-based random data source out there inherits from. 🎀

---

✨ NAME ✨

Crypt::Random::Source::Base::File — File (or device) random data sources 🌈🔮

---

🌸 VERSION 🌸

version 0.14 — yeah she's an OG, she's been sitting here since forever and she still slays 💅

---

🦋 SYNOPSIS 🦋

so if you wanna build your own file-based random source, you subclass this bad girl like so:

use Moo;
extends qw(Crypt::Random::Source::Base::File);

has '+path' => (
    default => "/foo/bar",
);

look at that. Moo, extends, and then you just tweak the inherited path attribute with a default of your own. main character subclassing energy fr fr 👑

---

💜 DESCRIPTION 💜

so what even is this? It's a base class — like, the ancestor, the blueprint, the momager — for random data sources that are files, or file-like things (devices count too, bestie, they're giving file energy). 🫶

You don't use this directly. You extends it. It does the boring plumbing so your subclass can just vibe. ✨

---

🍓 ATTRIBUTES 🍓

🧚 path

A required attribute, and it's exactly what it sounds like: the path to the file you wanna open. No path, no party. 🎀

it's required bestie, so don't come crying to me when your subclass blows up without one 💀

---

⭐ METHODS ⭐

🌟 open_handle

Uses IO::File to open path for reading. That's the whole thing. She opens the handle, she reads, she serves. 📖✨

---

🎀 SUPPORT 🎀

Got bugs? (not the cute kind, sadly 😭) You can submit them through the RT bug tracker:

https://rt.cpan.org/Public/Dist/Display.html?Name=Crypt-Random-Source

or you can email them straight to the tracker at bug-Crypt-Random-Source@rt.cpan.org — go off, report responsibly 🫡💖

---

👑 AUTHOR 👑

XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

(that first name is literally X's in the original, no cap, I'm not censoring anything, that's just what it says 💀)

---

🌈 COPYRIGHT AND LICENCE 🌈

This software is copyright (c) 2008 by Yuval Kogman.

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 wild, remix it, redistribute it, it's giving open source royalty 👑✨

---

and that's the whole page bestie!! 🦋 this doc came from perl v5.34.0, dated 2022-04-09, and it's filed under Crypt:...e::File(3pm) — mwah, go read your man pages, they're iconic, periodt 💅💖🎀