NAME

Module::Reader - Read the source of a module like perl does

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) <haarg@haarg.org>

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.