Andy Armstrong > Devel-Unplug > Devel::Unplug

Download:
Devel-Unplug-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

Devel::Unplug - Simulate the non-availability of modules

VERSION ^

This document describes Devel::Unplug version 0.03

SYNOPSIS ^

    $ perl -d:Unplug=Some::Module,Some::Other::Module myprog.pl
    Can't locate Some/Module.pm in @INC (unplugged by Devel::Unplug) at myprog.pl line 5.
    BEGIN failed--compilation aborted at myprog.pl line 5.

DESCRIPTION ^

Sometimes - particularly during testing - it's useful to be able to find out how your code behaves when a module it is expecting is unavailable. This module allows you to simulate the non-availability of a module.

It uses Devel::TraceLoad::Hook to replace require (and hence use) and intercept attempts to load modules.

INTERFACE ^

None of these functions are exportable. Call them using their fully qualified names.

unplug

Unplug one or more modules.

    Devel::Unplug::unplug( 'Some::Module', 'Some::Other::Module' );

Regular expressions may be used:

    Devel::Unplug::unplug( qr{^Some:: (?: Other:: )? Module$}x );

insert

Make an unplugged module available again.

    Devel::Unplug::insert( 'Some::Module' );

You must call insert for a given module as many times as unplug was called to make it available again.

unplugged

Get the list of unplugged modules. The returned array may potentially contain a mixture of regular expressions and plain strings.

DIAGNOSTICS ^

Can't locate %s in @INC (unplugged by Devel::Unplug)

The error message that will be displayed when an attempt is made to load a module that has been unplugged.

CONFIGURATION AND ENVIRONMENT ^

Devel::Unplug requires no configuration files or environment variables.

DEPENDENCIES ^

None.

INCOMPATIBILITIES ^

None reported.

BUGS AND LIMITATIONS ^

No bugs have been reported.

Please report any bugs or feature requests to bug-devel-unplug@rt.cpan.org, or through the web interface at http://rt.cpan.org.

AUTHOR ^

Andy Armstrong <andy@hexten.net>

TRIVIA ^

The 'unplug' name and the choice of unplug and insert as the function names is based on the Acorn RISC OS commands of the same name. I'm sure you were wondering.

LICENCE AND COPYRIGHT ^

Copyright (c) 2007, Andy Armstrong <andy@hexten.net>.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

syntax highlighting: