vendorlib: Use only core and vendor libraries in @inc

SYNOPSIS

    #!/usr/bin/perl

    use vendorlib;
    use strict;
    use warnings;
    use SomeModule; # will only search in core and vendor paths
    ...

DESCRIPTION

In a system distribution such as Debian, it may be advisable for Perl programs to ignore the user's CPAN-installed modules and only use the distribution-provided modules to avoid possible breakage with newer and unpackaged versions of modules.

To that end, this pragma will replace your @INC with only the core and vendor @INC paths, ignoring site_perl and $ENV{PERL5LIB} entirely.

It is recommended that you put \*(C`use vendorlib;\*(C' as the first statement in your program, before even \*(C`use strict;\*(C' and \*(C`use warnings;\*(C'.

BUGS

Please report any bugs or feature requests to \*(C`bug-vendorlib at rt.cpan.org\*(C', or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=vendorlib>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc vendorlib

You can also look for information at:

\s-1RT:\s0 \s-1CPAN\s0's request tracker <http://rt.cpan.org/NoAuth/Bugs.html?Dist=vendorlib>
AnnoCPAN: Annotated \s-1CPAN\s0 documentation <http://annocpan.org/dist/vendorlib>
\s-1CPAN\s0 Ratings <http://cpanratings.perl.org/d/vendorlib>
Search \s-1CPAN\s0 <http://search.cpan.org/dist/vendorlib/>

ACKNOWLEDGEMENTS

mxey and jawnsy on oftc #debian-perl helped to hash out the design for this.

ribasushi reviewed the initial version and pointed out that @INC order matters.

AUTHOR

Rafael Kitover, \*(C`<rkitover at cpan.org>\*(C'

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the \s-1GNU\s0 General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

vendorlib (3pm)