# NAME

# NAME

Smart::Args - argument validation for you

# SYNOPSIS

use Smart::Args;

sub func2 {
args my $p => 'Int',
my $q => { isa => 'Int', optional => 1 };
}
func2(p => 3, q => 4); # p => 3, q => 4
func2(p => 3); # p => 3, q => undef

sub func3 {
args my $p => {isa => 'Int', default => 3},
}
func3(p => 4); # p => 4
func3(); # p => 3

package F;
use Moose;
use Smart::Args;

sub method {
args my $self,
my $p => 'Int';
}
sub class_method {
args my $class => 'ClassName',
my $p => 'Int';
}

sub simple_method {
args_pos my $self, my $p;
}

my $f = F->new();
$f->method(p => 3);

F->class_method(p => 3);

F->simple_method(3);

# DESCRIPTION

Smart::Args is yet another argument validation library.

This module makes your module more readable, and writable =)

# FUNCTIONS

## `args my $var [, $rule], ...`

Checks parameters and fills them into lexical variables. All the parameters
are mandatory by default, and unknown parameters (i.e. possibly typos) are
reported as `void` warnings.

The arguments of `args()` consist of lexical <$var>s and optional _$rule_s.

_$vars_ must be a declaration of a lexical variable.

_$rule_ can be a type name (e.g. `Int`), a HASH reference (with
`type`, `default`, and `optional`), or a type constraint object.

Note that if the first variable is named _$class_ or _$self_, it
is dealt as a method call.

See the SYNOPSIS section for examples.

## `args_pos my $var[, $rule, ...`

Check parameters and fills them into lexical variables. All the parameters
are mandatory by default.

The arguments of `args()` consist of lexical <$var>s and optional _$rule_s.
_$vars_ must be a declaration of a lexical variable.

_$rule_ can be a type name (e.g. `Int`), a HASH reference (with
`type`, `default`, and `optional`), or a type constraint object.

Note that if the first variable is named _$class_ or _$self_, it
is dealt as a method call.

See the SYNOPSIS section for examples.

# TYPES

The types that `Smart::Args` uses are type constraints of `Mouse`.
That is, you can define your types in the way Mouse does.

In addition, `Smart::Args` also allows Moose type constraint objects,
so you can use any `MooseX::Types::*` libraries on CPAN.

Type coercions are automatically tried if validations fail.

See [Mouse::Util::TypeConstraints](http://search.cpan.org/perldoc?Mouse::Util::TypeConstraints) for details.

# AUTHOR

Tokuhiro Matsuno <[email protected]>

# SEE ALSO

[Params::Validate](http://search.cpan.org/perldoc?Params::Validate)

# LICENSE

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