File | /usr/local/lib/perl/5.10.0/Moose/Meta/TypeCoercion.pm |
Statements Executed | 22 |
Total Time | 0.000948 seconds |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
0 | 0 | 0 | 0s | 0s | BEGIN | 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 | Stmts. | Exclusive Time | Avg. | Code |
---|---|---|---|---|
1 | ||||
2 | package Moose::Meta::TypeCoercion; | |||
3 | ||||
4 | 3 | 27µs | 9µs | use strict; # spent 9µs making 1 call to strict::import |
5 | 3 | 28µs | 9µs | use warnings; # spent 30µs making 1 call to warnings::import |
6 | 3 | 50µs | 17µs | use metaclass; # spent 946µs making 1 call to metaclass::import |
7 | ||||
8 | 3 | 145µs | 48µs | use Moose::Meta::Attribute; # spent 5µs making 1 call to import |
9 | 3 | 588µs | 196µs | use Moose::Util::TypeConstraints (); |
10 | ||||
11 | 1 | 800ns | 800ns | our $VERSION = '1.15'; |
12 | 1 | 25µs | 25µs | $VERSION = eval $VERSION; |
13 | 1 | 700ns | 700ns | our $AUTHORITY = 'cpan:STEVAN'; |
14 | ||||
15 | __PACKAGE__->meta->add_attribute('type_coercion_map' => ( | |||
16 | reader => 'type_coercion_map', | |||
17 | default => sub { [] } | |||
18 | 1 | 20µs | 20µs | )); # spent 653µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 32µs making 1 call to Moose::Meta::TypeCoercion::meta |
19 | ||||
20 | 1 | 32µs | 32µs | __PACKAGE__->meta->add_attribute( # spent 3.72ms making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 1.79ms making 1 call to Moose::Meta::Attribute::new
# spent 22µ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 | 12µs | 12µs | __PACKAGE__->meta->add_attribute('compiled_type_coercion' => ( # spent 583µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute
# spent 24µ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 | 20µs | 20µ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 |