moosex::strictconstructor(3) [osx man page]

MooseX::StrictConstructor(3)				User Contributed Perl Documentation			      MooseX::StrictConstructor(3)

NAME

       MooseX::StrictConstructor - Make your object constructors blow up on unknown attributes

VERSION

       version 0.19

SYNOPSIS

	   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)

perl v5.16.2							    2012-01-17					      MooseX::StrictConstructor(3)