Params-Util 0.20 review

Params-Util is a simple, compact and correct param-checking functions. SYNOPSIS # Import some functions use Params

License: Perl Artistic License File size: 33K Developer: Adam Kennedy

0

Params-Util is a simple, compact and correct param-checking functions.

SYNOPSIS

# Import some functions
use Params::Util qw{_SCALAR _HASH _INSTANCE};

# If you are lazy, or need a lot of them...
use Params::Util ':ALL';

sub foo {
my $object = _INSTANCE(shift, 'Foo') or return undef;
my $image = _SCALAR(shift) or return undef;
my $options = _HASH(shift) or return undef;
# etc...
}

"Params::Util" provides a basic set of importable functions that makes checking parameters a hell of a lot easier

While they can be (and are) used in other contexts, the main point behind this module is that the functions both Do What You Mean, and Do The Right Thing, so they are most useful when you are getting params passed into your code from someone and/or somewhere else and you can't really trust the quality.

Thus, "Params::Util" is of most use at the edges of your API, where params and data are coming in from outside your code.

The functions provided by "Params::Util" check in the most strictly correct manner known, are documented as thoroughly as possible so their exact behaviour is clear, and heavily tested so make sure they are not fooled by weird data and Really Bad Things.

To use, simply load the module providing the functions you want to use as arguments (as shown in the SYNOPSIS).

To aid in maintainability, "Params::Util" will never export by default.

You must explicitly name the functions you want to export, or use the ":ALL" param to just have it export everything (although this is not recommended if you have any _FOO functions yourself with which future additions to "Params::Util" may clash)

Requirements:
Perl