phpman > man > MooseX::StrictConstructor

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 AT rt.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 AT urth.org, or use the button at
    <http://www.urth.org/~autarch/fs-donation.html>.

AUTHOR
    Dave Rolsky <autarch AT urth.org>

CONTRIBUTORS
    *   Jesse Luehrs <doy AT tozt.net>

    *   Karen Etheridge <ether AT cpan.org>

    *   Ricardo Signes <rjbs AT 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.