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-2014 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

