File | /usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/TypeCoercion.pm |
Statements Executed | 22 |
Statement Execution Time | 648µs |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
1 | 1 | 1 | 3.09ms | 55.1ms | BEGIN@8 | Moose::Meta::TypeCoercion::
1 | 1 | 1 | 46µs | 56µs | BEGIN@4 | Moose::Meta::TypeCoercion::
1 | 1 | 1 | 8µs | 23µs | BEGIN@5 | Moose::Meta::TypeCoercion::
1 | 1 | 1 | 6µs | 108µs | BEGIN@6 | Moose::Meta::TypeCoercion::
1 | 1 | 1 | 4µs | 4µs | BEGIN@9 | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | __ANON__[:17] | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | __ANON__[:67] | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | add_type_coercions | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | coerce | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | compile_type_coercion | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | has_coercion_for_type | Moose::Meta::TypeCoercion::
0 | 0 | 0 | 0s | 0s | new | Moose::Meta::TypeCoercion::
Line | State ments |
Time on line |
Calls | Time in subs |
Code |
---|---|---|---|---|---|
1 | |||||
2 | package Moose::Meta::TypeCoercion; | ||||
3 | |||||
4 | 3 | 42µs | 2 | 65µs | # spent 56µs (46+10) within Moose::Meta::TypeCoercion::BEGIN@4 which was called
# once (46µs+10µs) by Moose::BEGIN@20 at line 4 # spent 56µs making 1 call to Moose::Meta::TypeCoercion::BEGIN@4
# spent 10µs making 1 call to strict::import |
5 | 3 | 20µs | 2 | 38µs | # spent 23µs (8+15) within Moose::Meta::TypeCoercion::BEGIN@5 which was called
# once (8µs+15µs) by Moose::BEGIN@20 at line 5 # spent 23µs making 1 call to Moose::Meta::TypeCoercion::BEGIN@5
# spent 15µs making 1 call to warnings::import |
6 | 3 | 24µs | 2 | 209µs | # spent 108µs (6+102) within Moose::Meta::TypeCoercion::BEGIN@6 which was called
# once (6µs+102µs) by Moose::BEGIN@20 at line 6 # spent 108µs making 1 call to Moose::Meta::TypeCoercion::BEGIN@6
# spent 102µs making 1 call to metaclass::import |
7 | |||||
8 | 3 | 143µs | 1 | 55.1ms | # spent 55.1ms (3.09+52.1) within Moose::Meta::TypeCoercion::BEGIN@8 which was called
# once (3.09ms+52.1ms) by Moose::BEGIN@20 at line 8 # spent 55.1ms making 1 call to Moose::Meta::TypeCoercion::BEGIN@8 |
9 | 3 | 371µs | 1 | 4µs | # spent 4µs within Moose::Meta::TypeCoercion::BEGIN@9 which was called
# once (4µs+0s) by Moose::BEGIN@20 at line 9 # spent 4µs making 1 call to Moose::Meta::TypeCoercion::BEGIN@9 |
10 | |||||
11 | 1 | 500ns | our $VERSION = '0.98'; | ||
12 | 1 | 19µs | $VERSION = eval $VERSION; | ||
13 | 1 | 400ns | our $AUTHORITY = 'cpan:STEVAN'; | ||
14 | |||||
15 | __PACKAGE__->meta->add_attribute('type_coercion_map' => ( | ||||
16 | reader => 'type_coercion_map', | ||||
17 | default => sub { [] } | ||||
18 | 1 | 6µs | 2 | 293µs | )); # spent 274µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 19µs making 1 call to Moose::Meta::TypeCoercion::meta |
19 | |||||
20 | 1 | 5µs | 3 | 2.50ms | __PACKAGE__->meta->add_attribute( # spent 1.56ms making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 927µs making 1 call to Moose::Meta::Attribute::new
# spent 11µs making 1 call to Moose::Meta::TypeCoercion::meta |
21 | Moose::Meta::Attribute->new('type_constraint' => ( | ||||
22 | reader => 'type_constraint', | ||||
23 | weak_ref => 1 | ||||
24 | )) | ||||
25 | ); | ||||
26 | |||||
27 | # private accessor | ||||
28 | 1 | 3µs | 2 | 284µs | __PACKAGE__->meta->add_attribute('compiled_type_coercion' => ( # spent 273µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 11µs making 1 call to Moose::Meta::TypeCoercion::meta |
29 | accessor => '_compiled_type_coercion' | ||||
30 | )); | ||||
31 | |||||
32 | sub new { | ||||
33 | my $class = shift; | ||||
34 | my $self = Class::MOP::class_of($class)->new_object(@_); | ||||
35 | $self->compile_type_coercion; | ||||
36 | return $self; | ||||
37 | } | ||||
38 | |||||
39 | sub compile_type_coercion { | ||||
40 | my $self = shift; | ||||
41 | my @coercion_map = @{$self->type_coercion_map}; | ||||
42 | my @coercions; | ||||
43 | while (@coercion_map) { | ||||
44 | my ($constraint_name, $action) = splice(@coercion_map, 0, 2); | ||||
45 | my $type_constraint = ref $constraint_name ? $constraint_name : Moose::Util::TypeConstraints::find_or_parse_type_constraint($constraint_name); | ||||
46 | |||||
47 | unless ( defined $type_constraint ) { | ||||
48 | require Moose; | ||||
49 | Moose->throw_error("Could not find the type constraint ($constraint_name) to coerce from"); | ||||
50 | } | ||||
51 | |||||
52 | push @coercions => [ | ||||
53 | $type_constraint->_compiled_type_constraint, | ||||
54 | $action | ||||
55 | ]; | ||||
56 | } | ||||
57 | $self->_compiled_type_coercion(sub { | ||||
58 | my $thing = shift; | ||||
59 | foreach my $coercion (@coercions) { | ||||
60 | my ($constraint, $converter) = @$coercion; | ||||
61 | if ($constraint->($thing)) { | ||||
62 | local $_ = $thing; | ||||
63 | return $converter->($thing); | ||||
64 | } | ||||
65 | } | ||||
66 | return $thing; | ||||
67 | }); | ||||
68 | } | ||||
69 | |||||
70 | sub has_coercion_for_type { | ||||
71 | my ($self, $type_name) = @_; | ||||
72 | my %coercion_map = @{$self->type_coercion_map}; | ||||
73 | exists $coercion_map{$type_name} ? 1 : 0; | ||||
74 | } | ||||
75 | |||||
76 | sub add_type_coercions { | ||||
77 | my ($self, @new_coercion_map) = @_; | ||||
78 | |||||
79 | my $coercion_map = $self->type_coercion_map; | ||||
80 | my %has_coercion = @$coercion_map; | ||||
81 | |||||
82 | while (@new_coercion_map) { | ||||
83 | my ($constraint_name, $action) = splice(@new_coercion_map, 0, 2); | ||||
84 | |||||
85 | if ( exists $has_coercion{$constraint_name} ) { | ||||
86 | require Moose; | ||||
87 | Moose->throw_error("A coercion action already exists for '$constraint_name'") | ||||
88 | } | ||||
89 | |||||
90 | push @{$coercion_map} => ($constraint_name, $action); | ||||
91 | } | ||||
92 | |||||
93 | # and re-compile ... | ||||
94 | $self->compile_type_coercion; | ||||
95 | } | ||||
96 | |||||
97 | sub coerce { $_[0]->_compiled_type_coercion->($_[1]) } | ||||
98 | |||||
99 | |||||
100 | 1 | 14µs | 1; | ||
101 | |||||
102 | __END__ | ||||
103 | |||||
104 | =pod | ||||
105 | |||||
106 | =head1 NAME | ||||
107 | |||||
108 | Moose::Meta::TypeCoercion - The Moose Type Coercion metaclass | ||||
109 | |||||
110 | =head1 DESCRIPTION | ||||
111 | |||||
112 | A type coercion object is basically a mapping of one or more type | ||||
113 | constraints and the associated coercions subroutines. | ||||
114 | |||||
115 | It's unlikely that you will need to instantiate an object of this | ||||
116 | class directly, as it's part of the deep internals of Moose. | ||||
117 | |||||
118 | =head1 METHODS | ||||
119 | |||||
120 | =over 4 | ||||
121 | |||||
122 | =item B<< Moose::Meta::TypeCoercion->new(%options) >> | ||||
123 | |||||
124 | Creates a new type coercion object, based on the options provided. | ||||
125 | |||||
126 | =over 8 | ||||
127 | |||||
128 | =item * type_constraint | ||||
129 | |||||
130 | This is the L<Moose::Meta::TypeConstraint> object for the type that is | ||||
131 | being coerced I<to>. | ||||
132 | |||||
133 | =back | ||||
134 | |||||
135 | =item B<< $coercion->type_coercion_map >> | ||||
136 | |||||
137 | This returns the map of type constraints to coercions as an array | ||||
138 | reference. The values of the array alternate between type names and | ||||
139 | subroutine references which implement the coercion. | ||||
140 | |||||
141 | The value is an array reference because coercions are tried in the | ||||
142 | order they are added. | ||||
143 | |||||
144 | =item B<< $coercion->type_constraint >> | ||||
145 | |||||
146 | This returns the L<Moose::Meta::TypeConstraint> that was passed to the | ||||
147 | constructor. | ||||
148 | |||||
149 | =item B<< $coercion->has_coercion_for_type($type_name) >> | ||||
150 | |||||
151 | Returns true if the coercion can coerce the named type. | ||||
152 | |||||
153 | =item B<< $coercion->add_type_coercions( $type_name => $sub, ... ) >> | ||||
154 | |||||
155 | This method takes a list of type names and subroutine references. If | ||||
156 | the coercion already has a mapping for a given type, it throws an | ||||
157 | exception. | ||||
158 | |||||
159 | Coercions are actually | ||||
160 | |||||
161 | =item B<< $coercion->coerce($value) >> | ||||
162 | |||||
163 | This method takes a value and applies the first valid coercion it | ||||
164 | finds. | ||||
165 | |||||
166 | This means that if the value could belong to more than type in the | ||||
167 | coercion object, the first coercion added is used. | ||||
168 | |||||
169 | =item B<< Moose::Meta::TypeCoercion->meta >> | ||||
170 | |||||
171 | This will return a L<Class::MOP::Class> instance for this class. | ||||
172 | |||||
173 | =back | ||||
174 | |||||
175 | =head1 BUGS | ||||
176 | |||||
177 | See L<Moose/BUGS> for details on reporting bugs. | ||||
178 | |||||
179 | =head1 AUTHOR | ||||
180 | |||||
181 | Stevan Little E<lt>stevan@iinteractive.comE<gt> | ||||
182 | |||||
183 | =head1 COPYRIGHT AND LICENSE | ||||
184 | |||||
185 | Copyright 2006-2010 by Infinity Interactive, Inc. | ||||
186 | |||||
187 | L<http://www.iinteractive.com> | ||||
188 | |||||
189 | This library is free software; you can redistribute it and/or modify | ||||
190 | it under the same terms as Perl itself. | ||||
191 | |||||
192 | =cut |