bionic (3) MooseX::StrictConstructor.3pm.gz

NAME

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

VERSION

       version 0.21

SYNOPSIS

           package My::Class;

           use Moose;
           use MooseX::StrictConstructor;

           has 'size' => ( is => 'ro' );

           # 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.

       Bugs may be submitted at <https://github.com/moose/MooseX-StrictConstructor/issues>.

       I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".

SOURCE

       The source code repository for MooseX-StrictConstructor can be found at
       <https://github.com/moose/MooseX-StrictConstructor>.

DONATIONS

       If you'd like to thank me for the work I've done on this module, please consider making a "donation" to
       me via PayPal. I spend a lot of free time creating free software, and would appreciate any support you'd
       care to offer.

       Please note that I am not suggesting that you must do this in order for me to continue working on this
       particular software. I will continue to do so, inasmuch as I have in the past, for as long as it
       interests me.

       Similarly, a donation made in this way will probably not make me work on this software much more, unless
       I get so many donations that I can consider working on free software full time (let's all have a chuckle
       at that together).

       To donate, log into PayPal and send money to autarch@urth.org, or use the button at
       <http://www.urth.org/~autarch/fs-donation.html>.

AUTHOR

       Dave Rolsky <autarch@urth.org>

CONTRIBUTORS

       •   Jesse Luehrs <doy@tozt.net>

       •   Karen Etheridge <ether@cpan.org>

       •   Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2007 - 2017 by Dave Rolsky.

       This is free software, licensed under:

         The Artistic License 2.0 (GPL Compatible)

       The full text of the license can be found in the LICENSE file included with this distribution.