The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
ylib-0.001
River stage zero No dependents
7 ++
/ ylib

NAME

ylib - Add paths to @INC from a config file

VERSION

This documentation describes version 0.001.

SYNOPSIS

   # in .mylib file
   /home/david/some/library/path
 
   # from the command line
   $ perl -Mylib -E 'say for @INC'
   /home/david/some/library/path
   ...

DESCRIPTION

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.

USAGE

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 adjancent directory, one could create a .mylib file that adds the necessary path.

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.

Note: ylib will issue a warning if a path in .mylib can't be found.

BUGS

Please report any bugs or feature requests using the CPAN Request Tracker web interface at http://rt.cpan.org/Dist/Display.html?Queue=ylib

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

AUTHOR

David A. Golden (DAGOLDEN)

COPYRIGHT AND LICENSE

Copyright (c) 2009 by David A. Golden. All rights reserved.

Licensed under Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License was distributed with this file or you may obtain a copy of the License from http://www.apache.org/licenses/LICENSE-2.0

Files produced as output though the use of this software, shall not be considered Derivative Works, but shall be considered the original work of the Licensor.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.