/ 
ex-lib-0.06
River stage one • 2 direct dependents • 3 total dependents
/ ex::lib

NAME

ex::lib - The same as lib, but makes relative path absolute.

VERSION

Version 0.06

SYNOPSIS

Simple use like use lib ...:

use ex::lib qw(./mylibs1 ../mylibs2);
use ex::lib 'mylibs';

THE GOAL

The main reason of this library is transformate relative paths to absolute at the BEGIN stage, and push transformed to @INC. Relative path basis is not the current working directory, but the location of file, where the statement is. When using common lib, relative paths stays relative to curernt working directory,

# For ex:
# script: /opt/scripts/my.pl
use ex::lib '../lib';

# We run `/opt/scripts/my.pl` having cwd /home/mons
# The @INC will contain '/opt/lib';

# We run `./my.pl` having cwd /opt
# The @INC will contain '/opt/lib';

# We run `../my.pl` having cwd /opt/lib
# The @INC will contain '/opt/lib';

Also this module is very useful when writing tests, when you want to load strictly the module from ../lib, respecting the test file.

# t/00-test.t
use ex::lib '../lib';

Also this is useful, when you running under mod_perl, use something like Apache::StatINC, and your application may change working directory. So in case of chdir StatINC fails to reload module if the @INC contain relative paths.

BUGS

None known

COPYRIGHT & LICENSE

Copyright 2007-2009 Mons Anderson.

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

AUTHOR

Mons Anderson, <mons@cpan.org>