NAME

Perl::Critic::Policy::Variables::ProhibitUnusedVariables - Don't ask for storage you don't need.

AFFILIATION

This Policy is part of the core Perl::Critic distribution.

DESCRIPTION

Unused variables clutter code and require the reader to do mental bookkeeping to figure out if the variable is actually used or not.

At present, this Policy is very limited in order to ensure that there aren't any false positives. Hopefully, this will become more sophisticated soon.

Right now, this only looks for simply declared, uninitialized lexical variables.

my $x;          # not ok, assuming no other appearances.
my @y = ();     # ok, not handled yet.
our $z;         # ok, global.
local $w;       # ok, global.

This module is very dumb: it does no scoping detection, i.e. if the same variable name is used in two different locations, even if they aren't the same variable, this Policy won't complain.

Have to start somewhere.

CONFIGURATION

This Policy is not configurable except for the standard options.

AUTHOR

Elliot Shank <perl@galumph.com>

COPYRIGHT

Copyright (c) 2008-2021 Elliot Shank.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module.