NAME
Perl::Critic::Policy::logicLAB::ProhibitUseLib - simple policy
prohibiting the use of 'use lib'
AFFILIATION
This policy is a policy in the Perl::Critic::logicLAB distribution.
VERSION
This documentation describes version 0.03
DESCRIPTION
The 'use lib' statement, hardcodes the include path to be used. This can
give issues when moving modules and scripts between diverse
environments.
use lib '/some/path'; #not ok
use lib qw(/you/do/not/want/to/go/down/this/path /or/this); #not ok
Instead use the environment variable PERL5LIB
#bash
export PERL5LIB='/some/path/some/where'
#tcsh and csh
setenv PERL5LIB '/some/path/some/where'
CONFIGURATION AND ENVIRONMENT
This Policy is not configurable except for the standard options.
DEPENDENCIES AND REQUIREMENTS
* Perl::Critic
* Perl::Critic::Utils
* Readonly
* Test::More
* Test::Perl::Critic
INCOMPATIBILITIES
This distribution has no known incompatibilities.
BUGS AND LIMITATIONS
Currently the policy has no special opinion on FindBin. It only aims to
address messy, misleading, buggy and obscuring use of 'use lib'.
BUG REPORTING
Please use Requets Tracker for bug reporting:
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Perl-Critic-logicLAB-ProhibitUseLib
TEST AND QUALITY
The following policies have been disabled for this distribution
* Perl::Crititc::Policy::ValuesAndExpressions::ProhibitConstantPragma
* Perl::Crititc::Policy::NamingConventions::Capitalization
See also t/perlcriticrc
TEST COVERAGE
---------------------------- ------ ------ ------ ------ ------ ------ ------
File stmt bran cond sub pod time total
---------------------------- ------ ------ ------ ------ ------ ------ ------
...ogicLAB/ProhibitUseLib.pm 100.0 50.0 n/a 100.0 100.0 100.0 95.3
Total 100.0 50.0 n/a 100.0 100.0 100.0 95.3
---------------------------- ------ ------ ------ ------ ------ ------ ------
SEE ALSO
* <
http://perldoc.perl.org/perlrun.html#ENVIRONMENT>
* <
http://logiclab.jira.com/wiki/display/OPEN/Development#Development-
MakeyourComponentsEnvironmentAgnostic>
* <
http://logicLAB.jira.com/wiki/display/PCPMPUL/Home>
AUTHOR
* Jonas B. Nielsen, jonasbn "<
[email protected]>"
LICENSE AND COPYRIGHT
Copyright (c) 2009-2014 Jonas B. Nielsen. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.