2. EL 7
  3. perl-Test-Vars
  4. Test::Vars(3pm)

Scroll to navigation

Test::Vars(3) User Contributed Perl Documentation Test::Vars(3)

NAME

Test::Vars - Detects unused variables

VERSION

This document describes Test::Vars version 0.005.

SYNOPSIS

    use Test::Vars;
    all_vars_ok(); # check libs in MANIFEST

DESCRIPTION

Test::Vars finds unused variables in order to keep the source code tidy.

INTERFACE

Exported

all_vars_ok(%args)

Tests libraries in your distribution with %args.

libraries are collected from the MANIFEST file.

If you want to ignore variables, for example $foo, you can tell it to the test routines:

"ignore_vars => { '$foo' => 1 }"
"ignore_vars => [qw($foo)]"
"ignore_if => sub{ $_ eq '$foo' }"

Note that $self will be ignored by default unless you pass explicitly "{ '$self' => 0 }" to "ignore_vars".

vars_ok($lib, %args)

Tests $lib with %args.

See "all_vars_ok".

MECHANISM

"Test::Vars" is similar to a part of "Test::Perl::Critic",but the mechanism is different.

While "Perl::Critic", the backend of "Test::Perl::Critic", scans the source code as texts, this modules scans the compiled opcode (or AST: abstract syntax tree) using the "B" module. See also "B" and its submodules.

CONFIGURATION

"TEST_VERBOSE = 1 | 2 " shows the way this module works.

CAVEATS

https://rt.cpan.org/Ticket/Display.html?id=60018

https://rt.cpan.org/Ticket/Display.html?id=82411

DEPENDENCIES

Perl 5.10.0 or later.

BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

SEE ALSO

Perl::Critic

warnings::unused

B

Test::Builder::Module

AUTHOR

Goro Fuji (gfx) <gfuji(at)cpan.org>

LICENSE AND COPYRIGHT

Copyright (c) 2010, Goro Fuji (gfx). All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic for details.

2014-05-02 perl v5.16.3