Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Test::Without::Module(User Contributed Perl DocumentatTest::Without::Module(3)

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

perl v5.32.1			  2017-04-09	      Test::Without::Module(3)

NAME | SYNOPSIS | DESCRIPTION | ONE LINER | BUGS | CREDITS | AUTHOR | LICENSE | REPOSITORY | SUPPORT | BUG TRACKER | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Test::Without::Module&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help