File | /usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/TypeConstraint/Union.pm |
Statements Executed | 20 |
Statement Execution Time | 702µs |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
1 | 1 | 1 | 352µs | 592µs | BEGIN@8 | Moose::Meta::TypeConstraint::Union::
1 | 1 | 1 | 16µs | 19µs | BEGIN@4 | Moose::Meta::TypeConstraint::Union::
1 | 1 | 1 | 7µs | 20µs | BEGIN@5 | Moose::Meta::TypeConstraint::Union::
1 | 1 | 1 | 7µs | 47µs | BEGIN@14 | Moose::Meta::TypeConstraint::Union::
1 | 1 | 1 | 6µs | 126µs | BEGIN@6 | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | __ANON__[:18] | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | __ANON__[:32] | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | __ANON__[:50] | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | _actually_compile_type_constraint | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | create_child_type | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | equals | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | is_a_type_of | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | is_subtype_of | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | new | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | parents | Moose::Meta::TypeConstraint::Union::
0 | 0 | 0 | 0s | 0s | validate | Moose::Meta::TypeConstraint::Union::
Line | State ments |
Time on line |
Calls | Time in subs |
Code |
---|---|---|---|---|---|
1 | |||||
2 | package Moose::Meta::TypeConstraint::Union; | ||||
3 | |||||
4 | 3 | 21µs | 2 | 22µs | # spent 19µs (16+3) within Moose::Meta::TypeConstraint::Union::BEGIN@4 which was called
# once (16µs+3µs) by Moose::Util::TypeConstraints::BEGIN@29 at line 4 # spent 19µs making 1 call to Moose::Meta::TypeConstraint::Union::BEGIN@4
# spent 3µs making 1 call to strict::import |
5 | 3 | 25µs | 2 | 32µs | # spent 20µs (7+13) within Moose::Meta::TypeConstraint::Union::BEGIN@5 which was called
# once (7µs+13µs) by Moose::Util::TypeConstraints::BEGIN@29 at line 5 # spent 20µs making 1 call to Moose::Meta::TypeConstraint::Union::BEGIN@5
# spent 12µs making 1 call to warnings::import |
6 | 3 | 24µs | 2 | 246µs | # spent 126µs (6+120) within Moose::Meta::TypeConstraint::Union::BEGIN@6 which was called
# once (6µs+120µs) by Moose::Util::TypeConstraints::BEGIN@29 at line 6 # spent 126µs making 1 call to Moose::Meta::TypeConstraint::Union::BEGIN@6
# spent 120µs making 1 call to metaclass::import |
7 | |||||
8 | 3 | 130µs | 1 | 592µs | # spent 592µs (352+240) within Moose::Meta::TypeConstraint::Union::BEGIN@8 which was called
# once (352µs+240µs) by Moose::Util::TypeConstraints::BEGIN@29 at line 8 # spent 592µs making 1 call to Moose::Meta::TypeConstraint::Union::BEGIN@8 |
9 | |||||
10 | 1 | 700ns | our $VERSION = '0.98'; | ||
11 | 1 | 13µs | $VERSION = eval $VERSION; | ||
12 | 1 | 300ns | our $AUTHORITY = 'cpan:STEVAN'; | ||
13 | |||||
14 | 3 | 475µs | 2 | 88µs | # spent 47µs (7+41) within Moose::Meta::TypeConstraint::Union::BEGIN@14 which was called
# once (7µs+41µs) by Moose::Util::TypeConstraints::BEGIN@29 at line 14 # spent 47µs making 1 call to Moose::Meta::TypeConstraint::Union::BEGIN@14
# spent 41µs making 1 call to base::import |
15 | |||||
16 | __PACKAGE__->meta->add_attribute('type_constraints' => ( | ||||
17 | accessor => 'type_constraints', | ||||
18 | default => sub { [] } | ||||
19 | 1 | 5µs | 2 | 354µs | )); # spent 335µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 19µs making 1 call to Moose::Meta::TypeConstraint::Union::meta |
20 | |||||
21 | sub new { | ||||
22 | my ($class, %options) = @_; | ||||
23 | |||||
24 | my $name = join '|' => sort { $a cmp $b } | ||||
25 | map { $_->name } @{ $options{type_constraints} }; | ||||
26 | |||||
27 | my $self = $class->SUPER::new( | ||||
28 | name => $name, | ||||
29 | %options, | ||||
30 | ); | ||||
31 | |||||
32 | $self->_set_constraint(sub { $self->check($_[0]) }); | ||||
33 | $self->coercion(Moose::Meta::TypeCoercion::Union->new( | ||||
34 | type_constraint => $self | ||||
35 | )); | ||||
36 | return $self; | ||||
37 | } | ||||
38 | |||||
39 | sub _actually_compile_type_constraint { | ||||
40 | my $self = shift; | ||||
41 | |||||
42 | my @constraints = @{ $self->type_constraints }; | ||||
43 | |||||
44 | return sub { | ||||
45 | my $value = shift; | ||||
46 | foreach my $type (@constraints) { | ||||
47 | return 1 if $type->check($value); | ||||
48 | } | ||||
49 | return undef; | ||||
50 | }; | ||||
51 | } | ||||
52 | |||||
53 | |||||
54 | sub equals { | ||||
55 | my ( $self, $type_or_name ) = @_; | ||||
56 | |||||
57 | my $other = Moose::Util::TypeConstraints::find_type_constraint($type_or_name); | ||||
58 | |||||
59 | return unless $other->isa(__PACKAGE__); | ||||
60 | |||||
61 | my @self_constraints = @{ $self->type_constraints }; | ||||
62 | my @other_constraints = @{ $other->type_constraints }; | ||||
63 | |||||
64 | return unless @self_constraints == @other_constraints; | ||||
65 | |||||
66 | # FIXME presort type constraints for efficiency? | ||||
67 | constraint: foreach my $constraint ( @self_constraints ) { | ||||
68 | for ( my $i = 0; $i < @other_constraints; $i++ ) { | ||||
69 | if ( $constraint->equals($other_constraints[$i]) ) { | ||||
70 | splice @other_constraints, $i, 1; | ||||
71 | next constraint; | ||||
72 | } | ||||
73 | } | ||||
74 | } | ||||
75 | |||||
76 | return @other_constraints == 0; | ||||
77 | } | ||||
78 | |||||
79 | sub parents { | ||||
80 | my $self = shift; | ||||
81 | $self->type_constraints; | ||||
82 | } | ||||
83 | |||||
84 | sub validate { | ||||
85 | my ($self, $value) = @_; | ||||
86 | my $message; | ||||
87 | foreach my $type (@{$self->type_constraints}) { | ||||
88 | my $err = $type->validate($value); | ||||
89 | return unless defined $err; | ||||
90 | $message .= ($message ? ' and ' : '') . $err | ||||
91 | if defined $err; | ||||
92 | } | ||||
93 | return ($message . ' in (' . $self->name . ')') ; | ||||
94 | } | ||||
95 | |||||
96 | sub is_a_type_of { | ||||
97 | my ($self, $type_name) = @_; | ||||
98 | foreach my $type (@{$self->type_constraints}) { | ||||
99 | return 1 if $type->is_a_type_of($type_name); | ||||
100 | } | ||||
101 | return 0; | ||||
102 | } | ||||
103 | |||||
104 | sub is_subtype_of { | ||||
105 | my ($self, $type_name) = @_; | ||||
106 | foreach my $type (@{$self->type_constraints}) { | ||||
107 | return 1 if $type->is_subtype_of($type_name); | ||||
108 | } | ||||
109 | return 0; | ||||
110 | } | ||||
111 | |||||
112 | sub create_child_type { | ||||
113 | my ( $self, %opts ) = @_; | ||||
114 | |||||
115 | my $constraint | ||||
116 | = Moose::Meta::TypeConstraint->new( %opts, parent => $self ); | ||||
117 | |||||
118 | # if we have a type constraint union, and no | ||||
119 | # type check, this means we are just aliasing | ||||
120 | # the union constraint, which means we need to | ||||
121 | # handle this differently. | ||||
122 | # - SL | ||||
123 | if ( not( defined $opts{constraint} ) | ||||
124 | && $self->has_coercion ) { | ||||
125 | $constraint->coercion( | ||||
126 | Moose::Meta::TypeCoercion::Union->new( | ||||
127 | type_constraint => $self, | ||||
128 | ) | ||||
129 | ); | ||||
130 | } | ||||
131 | |||||
132 | return $constraint; | ||||
133 | } | ||||
134 | |||||
135 | 1 | 8µs | 1; | ||
136 | |||||
137 | __END__ | ||||
138 | |||||
139 | =pod | ||||
140 | |||||
141 | =head1 NAME | ||||
142 | |||||
143 | Moose::Meta::TypeConstraint::Union - A union of Moose type constraints | ||||
144 | |||||
145 | =head1 DESCRIPTION | ||||
146 | |||||
147 | This metaclass represents a union of type constraints. A union takes | ||||
148 | multiple type constraints, and is true if any one of its member | ||||
149 | constraints is true. | ||||
150 | |||||
151 | =head1 INHERITANCE | ||||
152 | |||||
153 | C<Moose::Meta::TypeConstraint::Union> is a subclass of | ||||
154 | L<Moose::Meta::TypeConstraint>. | ||||
155 | |||||
156 | =over 4 | ||||
157 | |||||
158 | =item B<< Moose::Meta::TypeConstraint::Union->new(%options) >> | ||||
159 | |||||
160 | This creates a new class type constraint based on the given | ||||
161 | C<%options>. | ||||
162 | |||||
163 | It takes the same options as its parent. It also requires an | ||||
164 | additional option, C<type_constraints>. This is an array reference | ||||
165 | containing the L<Moose::Meta::TypeConstraint> objects that are the | ||||
166 | members of the union type. The C<name> option defaults to the names | ||||
167 | all of these member types sorted and then joined by a pipe (|). | ||||
168 | |||||
169 | The constructor sets the implementation of the constraint so that is | ||||
170 | simply calls C<check> on the newly created object. | ||||
171 | |||||
172 | Finally, the constructor also makes sure that the object's C<coercion> | ||||
173 | attribute is a L<Moose::Meta::TypeCoercion::Union> object. | ||||
174 | |||||
175 | =item B<< $constraint->type_constraints >> | ||||
176 | |||||
177 | This returns the array reference of C<type_constraints> provided to | ||||
178 | the constructor. | ||||
179 | |||||
180 | =item B<< $constraint->parents >> | ||||
181 | |||||
182 | This returns the same constraint as the C<type_constraints> method. | ||||
183 | |||||
184 | =item B<< $constraint->check($value) >> | ||||
185 | |||||
186 | =item B<< $constraint->validate($value) >> | ||||
187 | |||||
188 | These two methods simply call the relevant method on each of the | ||||
189 | member type constraints in the union. If any type accepts the value, | ||||
190 | the value is valid. | ||||
191 | |||||
192 | With C<validate> the error message returned includes all of the error | ||||
193 | messages returned by the member type constraints. | ||||
194 | |||||
195 | =item B<< $constraint->equals($type_name_or_object) >> | ||||
196 | |||||
197 | A type is considered equal if it is also a union type, and the two | ||||
198 | unions have the same member types. | ||||
199 | |||||
200 | =item B<< $constraint->is_a_type_of($type_name_or_object) >> | ||||
201 | |||||
202 | This returns true if any of the member type constraints return true | ||||
203 | for the C<is_a_type_of> method. | ||||
204 | |||||
205 | =item B<< $constraint->is_subtype_of >> | ||||
206 | |||||
207 | This returns true if any of the member type constraints return true | ||||
208 | for the C<is_a_subtype_of> method. | ||||
209 | |||||
210 | =item B<< $constraint->create_child_type(%options) >> | ||||
211 | |||||
212 | This returns a new L<Moose::Meta::TypeConstraint> object with the type | ||||
213 | as its parent. | ||||
214 | |||||
215 | =back | ||||
216 | |||||
217 | =head1 BUGS | ||||
218 | |||||
219 | See L<Moose/BUGS> for details on reporting bugs. | ||||
220 | |||||
221 | =head1 AUTHOR | ||||
222 | |||||
223 | Stevan Little E<lt>stevan@iinteractive.comE<gt> | ||||
224 | |||||
225 | =head1 COPYRIGHT AND LICENSE | ||||
226 | |||||
227 | Copyright 2006-2010 by Infinity Interactive, Inc. | ||||
228 | |||||
229 | L<http://www.iinteractive.com> | ||||
230 | |||||
231 | This library is free software; you can redistribute it and/or modify | ||||
232 | it under the same terms as Perl itself. | ||||
233 | |||||
234 | =cut |