Test::W...::Module(3)

🦋 Test::W...::Module(3) — User Contributed Perl Documentation 🦋

🌸 NAME 🌸

Test::Without::Module — test fallback behaviour in absence of modules 💅

---

✨ SYNOPSIS ✨

okay bestie, here's the whole loop, literally:

use Test::Without::Module qw( My::Module );

# Now, loading of My::Module fails :
eval { require My::Module; };
warn $@ if $@;

# Now it works again
eval q{ no Test::Without::Module qw( My::Module ) };
eval { require My::Module; };
print "Found My::Module" unless $@;

---

💖 DESCRIPTION 💖

This module lets you deliberately hide modules from a program even though they are installed. 🫶 It's mostly useful for testing modules that have a fallback when a certain dependency module is not installed. No cap: the module is still installed; you're just making it invisible for the test vibes. 💅

🎁 EXPORT 🎁

None. ✨ All magic is done via use Test::Without::Module LIST and no Test::Without::Module LIST. 👑

🔮 Test::Without::Module::get_forbidden_list 🔮

This function returns a reference to a copy of the current hash of forbidden modules, or an empty hash if none are currently forbidden. 🧚 It's convenient if you're testing and/or debugging this module. 💖

---

🎀 ONE LINER 🎀

A neat trick for using this module from the command line was mentioned to me by NUFFIN and by Jerrad Pierce: 🌟

perl -MTest::Without::Module=Some::Module -w -Iblib/lib t/SomeModule.t

That way, you can easily see how your module or test file behaves when a certain module is unavailable. 💀✨

---

💀 BUGS 💀

• There is no lexical scoping — yep, that's the whole bug list. 😭

---

🌈 CREDITS 🌈

Much improvement must be thanked to Aristotle from PerlMonks — he pointed me to a much less convoluted way to fake a module at <https://perlmonks.org?node=192635>. 🧚💖

I also discussed with him an even more elegant way of overriding CORE::GLOBAL::require, but the parsing of the overridden subroutine didn't work out the way I wanted it — CORE::require didn't recognize barewords as such anymore. 😭

NUFFIN and Jerrad Pierce pointed out the convenient use from the command line to interactively watch the behaviour of the test suite and module in absence of a module. 👑

---

👑 AUTHOR 👑

Copyright (c) 2003-2024 Max Maischein, <corion@cpan.org> 💜

---

📜 LICENSE 📜

This module is released under the same terms as Perl itself. 🎀

---

🦋 REPOSITORY 🦋

The public repository of this module is <https://github.com/Corion/test-without-module>. ✨

---

🫶 SUPPORT 🫶

The public support forum of this module is <https://perlmonks.org/>. 🌸

---

🐛 BUG TRACKER 🐛

Please report bugs in this module via the RT CPAN bug queue at <https://rt.cpan.org/Public/Dist/Display.html?Name=Test-Without-Module> or via mail to test-without-module-Bugs@rt.cpan.org. 💌

---

🔥 SEE ALSO 🔥

• Devel::Hide
• Acme::Intraweb
• PAR
• perlfunc

🫶 That’s the whole vibe, bestie — source/version perl v5.42.0, date 2024-07-15, manual Test::W...::Module(3). 💖