Perl Diver 2.31
Main Environment Variables Perl Default Values Perl Config - Summary Perl Config - Full Installed Modules List Directory uptime Docs

Module Documentation
Details and documentation about a specific module, including version and documentation (if available). Note that while links to perldoc.com and search.cpan.org are provided, the module may be part of a larger distribution. If you reach a File Not Found page on either site, please try the parent module.

Test::Without::Module

Name Test::Without::Module
Version 0.20
Located at /usr/local/share/perl5
File /usr/local/share/perl5/Test/Without/Module.pm
Is Core No
Search CPAN for this module Test::Without::Module
Documentation Test::Without::Module
Module Details Test::Without::Module

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

the Devel::Hide manpage, the Acme::Intraweb manpage, PAR, perlfunc

Perl Diver brought to you by ScriptSolutions.com © 1997- 2024