ylib - Add paths to @INC from a config file
version 0.003
# in .mylib file /home/david/some/library/path # from the command line $ perl -Mylib -E 'say for @INC' /home/david/some/library/path ...
The ylib module adds paths to @INC from a configuration file named .mylib in which each line represents a library path. The .mylib file can be either in the current directory and/or in the user's home directory. It is equivalent to calling 'use lib' on each path.
ylib
@INC
.mylib
'use lib'
Note: ylib will issue a warning if a path in .mylib can't be found.
Occasionally, it's useful to customize @INC on a per-directory basis without changing the global PERL5LIB environment variable. For example, when developing or testing code that requires uninstalled code in an adjacent directory, one could create a .mylib file that adds the necessary path.
PERL5LIB
For example, consider this directory tree with two Perl distributions, Foo-Bar and Baz-Bam:
~/projects/ Foo-Bar/ Baz-Bam/
The code in Foo-Bar depends on code in Baz-Bam. So in Foo-Bar, create a .mylib file with the appropriate path:
$ cd Foo-Bar $ echo '../Baz-Bam/lib' > .mylib $ perl -Mylib Build.PL $ Build && Build test
That's easier and shorter than using PERL5LIB on the command line, and it scales better as the number of libraries increases.
In the example above, the Build script preserve @INC including the effect of -Mylib when it was created. This is not the case with Makefile.PL or prove, in which case, PERL5OPT might be an alternative approach for using -Mylib:
Build
-Mylib
Makefile.PL
prove
PERL5OPT
$ export PERL5OPT=-Mylib $ prove
Please report any bugs or feature requests through the issue tracker at https://github.com/dagolden/ylib/issues. You will be notified automatically of any progress on your issue.
This is open source software. The code repository is available for public review and contribution under the terms of the license.
https://github.com/dagolden/ylib
git clone https://github.com/dagolden/ylib.git
David Golden <dagolden@cpan.org>
This software is Copyright (c) 2014 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
To install ylib, copy and paste the appropriate command in to your terminal.
cpanm
cpanm ylib
CPAN shell
perl -MCPAN -e shell install ylib
For more information on module installation, please visit the detailed CPAN module installation guide.