NAME

File::ShareDir::Override - Override directories returned by File::ShareDir

VERSION

version 0.200

SYNOPSIS

Run program.pl and make Foo::Bar think its distribution's shared directory is ./share:

perl -MFile::ShareDir::Override=Foo-Bar:./share program.pl

Pretend Foo::Bar's module shared directory is ./lib:

perl -MFile::ShareDir::Override=Foo::Bar:./lib program.pl

DESCRIPTION

(TBA)

Top-level modules/distributions (e.g., Dancer or Plack) don't have any dashes or double colons in the name and can't be recognized, so they need an explicit :dist or :module between the name and path. Example:

perl -MFile::ShareDir::Override=Foo:module:./lib program.pl

Usage with prove:

PERL5OPT=-MFoo-Bar:./share prove sometests.t

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/odyniec/p5-File-ShareDir-Override/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://github.com/odyniec/p5-File-ShareDir-Override

git clone https://github.com/odyniec/p5-File-ShareDir-Override.git

AUTHOR

Michal Wojciechowski <odyniec@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Michal Wojciechowski.

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