table of contents
MooseX::StrictConstructor(3pm) | User Contributed Perl Documentation | MooseX::StrictConstructor(3pm) |
NAME¶
MooseX::StrictConstructor - Make your object constructors blow up on unknown attributesVERSION¶
version 0.19SYNOPSIS¶
package My::Class; use Moose; use MooseX::StrictConstructor; has 'size' => ...; # then later ... # this blows up because color is not a known attribute My::Class->new( size => 5, color => 'blue' );
DESCRIPTION¶
Simply loading this module makes your constructors "strict". If your constructor is called with an attribute init argument that your class does not declare, then it calls "Moose->throw_error()". This is a great way to catch small typos.Subverting Strictness¶
You may find yourself wanting to have your constructor accept a parameter which does not correspond to an attribute.In that case, you'll probably also be writing a "BUILD()" or "BUILDARGS()" method to deal with that parameter. In a "BUILDARGS()" method, you can simply make sure that this parameter is not included in the hash reference you return. Otherwise, in a "BUILD()" method, you can delete it from the hash reference of parameters.
sub BUILD { my $self = shift; my $params = shift; if ( delete $params->{do_something} ) { ... } }
BUGS¶
Please report any bugs or feature requests to "bug-moosex-strictconstructor@rt.cpan.org", or through the web interface at <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.AUTHOR¶
Dave Rolsky <autarch@urth.org>COPYRIGHT AND LICENSE¶
This software is Copyright (c) 2012 by Dave Rolsky.This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
2012-01-17 | perl v5.14.2 |