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.