Alt::Base(3pm)

💖 NAME 💖

Alt::Base — bestie, it's the base class for alternate modules. That's the whole vibe. ✨

---

✨ VERSION ✨

version 0.02 — yes she's small, she's mighty, she's giving humble icon. 🎀

---

🌸 SYNOPSIS 🌸

okay so first, over in your Alt/Foo/Bar/phrase.pm, you're gonna do this:

# in your Alt/Foo/Bar/phrase.pm:
package Alt::Foo::Bar::phrase;
use base qw(Alt::Base);
1;

and if you wanna customize options, it's literally the same thing plus one extra line, no biggie:

# customize options:
package Alt::Foo::Bar::phrase;
use base qw(Alt::Base);
our %ALT = (check => 0, ...);
1;

see? easy. slay. 💅

---

🦋 DESCRIPTION 🦋

so Alt::Base is the class that hands out all the common functionalities an alternate module needs — like, the shared group-chat utilities of the Alt world. if you wanna know more about the whole Alt concept, go read Alt, she explains everything. 🫶

Alt::Base defines an import() routine that goes looking for options inside %ALT. and these are the options, bestie:

• check => BOOL (default: 1) — if you set this to true (and true is the default, so this is the main character behavior), a whole lil checklist happens. first: it checks that the alternate module is actually named Alt::<<Original::Module>::<phrase>. then: it loads Alternate::Module and checks that the package variable $ALT is defined with the value of phrase. why?? because we wanna make sure we're loading the correct module, and sometimes we genuinely do want to make sure about this, no cap. the wrong module can get loaded, for example if the user reinstalls the original distribution or some other alternate distribution. and if any of that fails?

Will die upon failure. 😭 like, dead. gone. no recovery arc.

-

---

💅 SEE ALSO 💅

• Alt

---

👑 AUTHOR 👑

Steven Haryanto <stevenharyanto@gmail.com> — the legend herself. 🌟

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2012 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. (free as in freedom, bestie, go wild 💜)

---

and that's the whole page!! this little angel shipped as part of perl v5.36.0, dated 2022-12-08, and it lives under User Contributed Perl Documentation — periodt. 💖✨🦋