oracular (3) Test::Without::Module.3pm.gz

NAME

       Test::Without::Module - Test fallback behaviour in absence of modules

SYNOPSIS

           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 allows you to deliberately hide modules from a program even though they are installed. This
       is mostly useful for testing modules that have a fallback when a certain dependency module is not
       installed.

   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. This is convenient if you are 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

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