NAME

    File::Share - Extend File::ShareDir to Local Libraries

SYNOPSIS

        use File::Share ':all';
    
        my $dir = dist_dir('Foo-Bar');
        my $file = dist_file('Foo-Bar', 'file.txt');

DESCRIPTION

    This module is a dropin replacement for File::ShareDir. It supports the
    dist_dir and dist_file functions, except these functions have been
    enhanced to understand when the developer's local ./share/ directory
    should be used.

    NOTE: module_dist and module_file are not yet supported, because
    (afaik) there is no well known way to populate per-module share files.
    This may change in the future. Please contact me if you know how to do
    this.

PROBLEM AND SOLUTION

    Module::Install has an install_share directive that allows you to
    install various files associated with a distribution. By convention,
    module authors always put these in a directory called share/. However,
    File::ShareDir can only find files after they have been installed. This
    can be problematic when running development tests.

    File::Share will look for a local share directory, if it notices that
    the module corresponding was loaded from a development path.

    Devel::Local gives you an easy way to use a bunch of source
    repositories as though their lib and bin directories had already been
    installed. File::Share lets you play along with that.

SEE ALSO

      * File::ShareDir

AUTHOR

    Ingy döt Net <ingy@cpan.org>

COPYRIGHT AND LICENSE

    Copyright 2011-2014. Ingy döt Net.

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

    See http://www.perl.com/perl/misc/Artistic.html