-
-
30 Jul 2022 21:28:19 UTC
- Distribution: File-Share
- Module version: 0.27
- Source (raw)
- Pod Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues (6)
- Testers (505 / 0 / 0)
- Kwalitee
Bus factor: 1- 62.69% Coverage
- License: perl_5
- Perl: v5.8.1
- Activity
24 month- Tools
- Download (13.8KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
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
anddist_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 calledshare/
. 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
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.
Module Install Instructions
To install File::Share, copy and paste the appropriate command in to your terminal.
cpanm File::Share
perl -MCPAN -e shell install File::Share
For more information on module installation, please visit the detailed CPAN module installation guide.