NAME
MooseX::SlurpyConstructor - Assign all unknown arguments to attribute in
object constructor.
SYNOPSIS
package ASDF;
use Moose;
use MooseX::SlurpyConstructor;
has fixed => (
is => 'ro',
);
has slurpy => (
is => 'ro',
slurpy => 1,
);
package main;
ASDF->new({
fixed => 100, unknown1 => "a", unknown2 => [ 1..3 ]
})->dump;
# returns:
# $VAR1 = bless( {
# 'slurpy' => {
# 'unknown2' => [
# 1,
# 2,
# 3
# ],
# 'unknown1' => 'a'
# },
# 'fixed' => 100
# }, 'ASDF' );
DESCRIPTION
Including this module within Moose-based classes, and declaring an
attribute as 'slurpy' will allow capturing of all unknown constructor
arguments in the given attribute.
When composing a class, an error will be raised if more than one
attribute of the class is marked as 'slurpy'. Also, at object
instatiation time, an error will be raised if the class being
instantiated uses this one, but does not declare a slurpy attribute.
SEE ALSO
MooseX::StrictConstructor
The opposite of this module, making constructors die on unknown
arguments. Note that if both of these are used together,
SlurpyConstructor will take precedence and strict constructor
explosions will never occour.
AUTHOR
Mark Morgan "<
[email protected]>"
Thanks to the folks from moose mailing list and IRC channels for helping
me find my way around some of the Moose bits I didn't know of before
writing this module.
BUGS
As usual, send bugs or feature requests to
"
[email protected]" or through web interface
<
http://rt.cpan.org>.
COPYRIGHT & LICENSE
Copyright 2009 Mark Morgan, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
