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.