SYNOPSIS

use Module::Reader qw(:all);
my $io = module_handle('My::Module');
my $content = module_content('My::Module');

my $io = module_handle('My::Module', @search_dirs);

my $io = module_handle('My::Module', @search_dirs, { found => \%INC });

DESCRIPTION

Reads the content of perl modules the same way perl does. This includes reading modules available only by @INC hooks, or filtered through them.

EXPORTS

module_handle( $module_name, @search_dirs, \%options )

Returns an IO handle to the given module. Searches the directories specified, or @INC if none are.

Options

found

A reference to a hash like %INC with module file names (in the style 'My/Module.pm') as keys and full file paths as values. Modules listed in this will be used in preference to searching through directories.

module_content( $module_name, @search_dirs, \%options )

Returns the content of the given module. Accepts the same options as "module_handle".

AUTHOR

haarg - Graham Knop (cpan:HAARG) <[email protected]>

CONTRIBUTORS

None yet.

COPYRIGHT

Copyright (c) 2013 the Module::Reader ``AUTHOR'' and ``CONTRIBUTORS'' as listed above.

LICENSE

This library is free software and may be distributed under the same terms as perl itself.