Module::Loaded(3perl)

💖 Module::Loaded 💖

okay bestie, so this is the page for Module::Loaded, straight out of the Perl Programmers Reference Guide ✨

---

🌸 NAME 🌸

Module::Loaded — the little guy that marks modules as loaded or unloaded 💅

---

✨ SYNOPSIS ✨

use Module::Loaded;

$bool = mark_as_loaded('Foo');   # Foo.pm is now marked as loaded
$loc  = is_loaded('Foo');        # location of Foo.pm set to the
                                 # loaders location
eval "require 'Foo'";            # is now a no-op

$bool = mark_as_unloaded('Foo'); # Foo.pm no longer marked as loaded
eval "require 'Foo'";            # Will try to find Foo.pm in @INC

like… look at that. the eval "require 'Foo'" is literally a no-op now. the audacity. the power. 👑

---

🦋 DESCRIPTION 🦋

so when you're testing applications, you'll lowkey find yourself needing to provide functionality in your test environment that would usually be provided by external modules. and instead of munging the %INC by hand to mark those external modules as loaded (so perl doesn't even try to load them), this module is giving very simple. you mark modules as loaded and/or unloaded, and you move on with your day. that's it. that's the whole vibe. 🫶

---

💅 FUNCTIONS 💅

$bool = mark_as_loaded( PACKAGE );

marks the package as loaded to perl. PACKAGE can be a bareword or a string, whichever you're feeling. ✨

if the module is already loaded, mark_as_loaded will carp about it and tell you from where the PACKAGE has been loaded already. like, it will call you out. 🙈

$bool = mark_as_unloaded( PACKAGE );

marks the package as unloaded to perl — which is the exact opposite of mark_as_loaded, no notes. PACKAGE can be a bareword or string here too. 💖

if the module is already unloaded, mark_as_unloaded will carp about this and tell you the PACKAGE has been unloaded already. again: called out. 💀

$loc = is_loaded( PACKAGE );

is_loaded tells you if PACKAGE has been marked as loaded yet. PACKAGE can be a bareword or string, you already know the drill. 🌈

it returns false if PACKAGE has not been loaded yet, and on success it returns the location from where it is said to be loaded. bestie literally doxxing your module's origin, and honestly? we love that for us. 📍

---

🎀 BUG REPORTS 🎀

please report bugs or other issues to bug-module-loaded@rt.cpan.org 🐛✨ (in the original page it's written as <bug-module-loaded@rt.cpan.org<gt>, so yes, exactly like that.)

---

🌟 AUTHOR 🌟

this module by Jos Boumans <kane@cpan.org>. icon behavior. 👑

---

💜 COPYRIGHT 💜

this library is free software; you may redistribute and/or modify it under the same terms as Perl itself. periodt. 💅

---

and that's the whole page, bestie 🧚 — this was perl v5.44.0, dated 2026-10-17, and yeah it's Module::Loaded(3perl). go mark some modules, you absolute legend. 🍓✨