1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
package MooseX::StrictConstructor;
BEGIN {
$MooseX::StrictConstructor::VERSION = '0.10';
}
use strict;
use warnings;
use Moose 0.94 ();
use Moose::Exporter;
use Moose::Util::MetaRole;
use MooseX::StrictConstructor::Role::Object;
use MooseX::StrictConstructor::Role::Meta::Method::Constructor;
Moose::Exporter->setup_import_methods(
class_metaroles => {
constructor =>
['MooseX::StrictConstructor::Role::Meta::Method::Constructor']
},
base_class_roles => ['MooseX::StrictConstructor::Role::Object'],
);
1;
# ABSTRACT: Make your object constructors blow up on unknown attributes
=pod
=head1 NAME
MooseX::StrictConstructor - Make your object constructors blow up on unknown attributes
=head1 VERSION
version 0.10
=head1 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' );
=head1 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 "Carp::confess()". This is a great way
to catch small typos.
=head2 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 C<BUILD()> or
C<BUILDARGS()> method to deal with that parameter. In a C<BUILDARGS()>
method, you can simply make sure that this parameter is not included
in the hash reference you return. Otherwise, in a C<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} ) {
...
}
}
=head1 BUGS
Please report any bugs or feature requests to
C<bug-moosex-strictconstructor@rt.cpan.org>, or through the web
interface at L<http://rt.cpan.org>. I will be notified, and then
you'll automatically be notified of progress on your bug as I make
changes.
=head1 AUTHOR
Dave Rolsky <autarch@urth.org>
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2010 by Dave Rolsky.
This is free software, licensed under:
The Artistic License 2.0
=cut
__END__
|
