File | /usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm |
Statements Executed | 99 |
Statement Execution Time | 3.39ms |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
1 | 1 | 1 | 1.58ms | 2.97ms | BEGIN@17 | Moose::Meta::Role::
1 | 1 | 1 | 309µs | 985µs | BEGIN@19 | Moose::Meta::Role::
1 | 1 | 1 | 259µs | 789µs | BEGIN@20 | Moose::Meta::Role::
1 | 1 | 1 | 189µs | 299µs | BEGIN@18 | Moose::Meta::Role::
1 | 1 | 1 | 15µs | 18µs | BEGIN@4 | Moose::Meta::Role::
1 | 1 | 1 | 13µs | 34µs | BEGIN@559 | Moose::Meta::Role::
1 | 1 | 1 | 12µs | 26µs | BEGIN@544 | Moose::Meta::Role::
1 | 1 | 1 | 11µs | 68µs | BEGIN@8 | Moose::Meta::Role::
1 | 1 | 1 | 10µs | 35µs | BEGIN@523 | Moose::Meta::Role::
1 | 1 | 1 | 8µs | 251µs | BEGIN@10 | Moose::Meta::Role::
1 | 1 | 1 | 8µs | 34µs | BEGIN@9 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 158µs | BEGIN@6 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 17µs | BEGIN@5 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 136µs | BEGIN@21 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 75µs | BEGIN@23 | Moose::Meta::Role::
1 | 1 | 1 | 6µs | 6µs | BEGIN@16 | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | DESTROY | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:100] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:105] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:110] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:115] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:256] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:265] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:273] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:292] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:301] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:352] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:482] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:83] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:90] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | __ANON__[:95] | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | _attach_attribute | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | _role_for_combination | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_attribute | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_conflicting_method | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_override_method_modifier | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_required_methods | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_role | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | alias_method | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | apply | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | calculate_all_roles | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | combine | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | composition_class_roles | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | create | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | create_anon_role | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | does_role | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | find_method_by_name | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | get_method_modifier_list | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | get_override_method_modifier | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | has_override_method_modifier | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | initialize | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | is_anon_role | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | reinitialize | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | reset_package_cache_flag | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | update_package_cache_flag | Moose::Meta::Role::
Line | State ments |
Time on line |
Calls | Time in subs |
Code |
---|---|---|---|---|---|
1 | |||||
2 | package Moose::Meta::Role; | ||||
3 | |||||
4 | 3 | 22µs | 2 | 21µs | # spent 18µs (15+3) within Moose::Meta::Role::BEGIN@4 which was called
# once (15µs+3µs) by Moose::BEGIN@26 at line 4 # spent 18µs making 1 call to Moose::Meta::Role::BEGIN@4
# spent 3µs making 1 call to strict::import |
5 | 3 | 20µs | 2 | 27µs | # spent 17µs (7+10) within Moose::Meta::Role::BEGIN@5 which was called
# once (7µs+10µs) by Moose::BEGIN@26 at line 5 # spent 17µs making 1 call to Moose::Meta::Role::BEGIN@5
# spent 10µs making 1 call to warnings::import |
6 | 3 | 37µs | 2 | 310µs | # spent 158µs (7+151) within Moose::Meta::Role::BEGIN@6 which was called
# once (7µs+151µs) by Moose::BEGIN@26 at line 6 # spent 158µs making 1 call to Moose::Meta::Role::BEGIN@6
# spent 151µs making 1 call to metaclass::import |
7 | |||||
8 | 3 | 29µs | 2 | 126µs | # spent 68µs (11+57) within Moose::Meta::Role::BEGIN@8 which was called
# once (11µs+57µs) by Moose::BEGIN@26 at line 8 # spent 68µs making 1 call to Moose::Meta::Role::BEGIN@8
# spent 57µs making 1 call to Exporter::import |
9 | 3 | 24µs | 2 | 61µs | # spent 34µs (8+26) within Moose::Meta::Role::BEGIN@9 which was called
# once (8µs+26µs) by Moose::BEGIN@26 at line 9 # spent 34µs making 1 call to Moose::Meta::Role::BEGIN@9
# spent 26µs making 1 call to Exporter::import |
10 | 3 | 51µs | 2 | 494µs | # spent 251µs (8+243) within Moose::Meta::Role::BEGIN@10 which was called
# once (8µs+243µs) by Moose::BEGIN@26 at line 10 # spent 251µs making 1 call to Moose::Meta::Role::BEGIN@10
# spent 243µs making 1 call to Sub::Exporter::__ANON__[Sub/Exporter.pm:756] |
11 | |||||
12 | 1 | 1µs | our $VERSION = '0.98'; | ||
13 | 1 | 31µs | $VERSION = eval $VERSION; | ||
14 | 1 | 800ns | our $AUTHORITY = 'cpan:STEVAN'; | ||
15 | |||||
16 | 3 | 21µs | 1 | 6µs | # spent 6µs within Moose::Meta::Role::BEGIN@16 which was called
# once (6µs+0s) by Moose::BEGIN@26 at line 16 # spent 6µs making 1 call to Moose::Meta::Role::BEGIN@16 |
17 | 3 | 594µs | 1 | 2.97ms | # spent 2.97ms (1.58+1.39) within Moose::Meta::Role::BEGIN@17 which was called
# once (1.58ms+1.39ms) by Moose::BEGIN@26 at line 17 # spent 2.97ms making 1 call to Moose::Meta::Role::BEGIN@17 |
18 | 3 | 99µs | 1 | 299µs | # spent 299µs (189+110) within Moose::Meta::Role::BEGIN@18 which was called
# once (189µs+110µs) by Moose::BEGIN@26 at line 18 # spent 299µs making 1 call to Moose::Meta::Role::BEGIN@18 |
19 | 3 | 96µs | 1 | 985µs | # spent 985µs (309+676) within Moose::Meta::Role::BEGIN@19 which was called
# once (309µs+676µs) by Moose::BEGIN@26 at line 19 # spent 985µs making 1 call to Moose::Meta::Role::BEGIN@19 |
20 | 3 | 102µs | 1 | 789µs | # spent 789µs (259+530) within Moose::Meta::Role::BEGIN@20 which was called
# once (259µs+530µs) by Moose::BEGIN@26 at line 20 # spent 789µs making 1 call to Moose::Meta::Role::BEGIN@20 |
21 | 3 | 28µs | 2 | 265µs | # spent 136µs (7+129) within Moose::Meta::Role::BEGIN@21 which was called
# once (7µs+129µs) by Moose::BEGIN@26 at line 21 # spent 136µs making 1 call to Moose::Meta::Role::BEGIN@21
# spent 129µs making 1 call to Sub::Exporter::__ANON__[Sub/Exporter.pm:756] |
22 | |||||
23 | 3 | 1.59ms | 2 | 143µs | # spent 75µs (7+68) within Moose::Meta::Role::BEGIN@23 which was called
# once (7µs+68µs) by Moose::BEGIN@26 at line 23 # spent 75µs making 1 call to Moose::Meta::Role::BEGIN@23
# spent 68µs making 1 call to base::import |
24 | |||||
25 | ## ------------------------------------------------------------------ | ||||
26 | ## NOTE: | ||||
27 | ## I normally don't do this, but I am doing | ||||
28 | ## a whole bunch of meta-programmin in this | ||||
29 | ## module, so it just makes sense. For a clearer | ||||
30 | ## picture of what is going on in the next | ||||
31 | ## several lines of code, look at the really | ||||
32 | ## big comment at the end of this file (right | ||||
33 | ## before the POD). | ||||
34 | ## - SL | ||||
35 | ## ------------------------------------------------------------------ | ||||
36 | |||||
37 | 1 | 3µs | 1 | 27µs | my $META = __PACKAGE__->meta; # spent 27µs making 1 call to Moose::Meta::Role::meta |
38 | |||||
39 | ## ------------------------------------------------------------------ | ||||
40 | ## attributes ... | ||||
41 | |||||
42 | # NOTE: | ||||
43 | # since roles are lazy, we hold all the attributes | ||||
44 | # of the individual role in 'statis' until which | ||||
45 | # time when it is applied to a class. This means | ||||
46 | # keeping a lot of things in hash maps, so we are | ||||
47 | # using a little of that meta-programmin' magic | ||||
48 | # here an saving lots of extra typin. And since | ||||
49 | # many of these attributes above require similar | ||||
50 | # functionality to support them, so we again use | ||||
51 | # the wonders of meta-programmin' to deliver a | ||||
52 | # very compact solution to this normally verbose | ||||
53 | # problem. | ||||
54 | # - SL | ||||
55 | |||||
56 | 1 | 17µs | foreach my $action ( | ||
57 | { | ||||
58 | name => 'excluded_roles_map', | ||||
59 | attr_reader => 'get_excluded_roles_map' , | ||||
60 | methods => { | ||||
61 | add => 'add_excluded_roles', | ||||
62 | get_keys => 'get_excluded_roles_list', | ||||
63 | existence => 'excludes_role', | ||||
64 | } | ||||
65 | }, | ||||
66 | { | ||||
67 | name => 'required_methods', | ||||
68 | attr_reader => 'get_required_methods_map', | ||||
69 | methods => { | ||||
70 | remove => 'remove_required_methods', | ||||
71 | get_values => 'get_required_method_list', | ||||
72 | existence => 'requires_method', | ||||
73 | } | ||||
74 | }, | ||||
75 | ) { | ||||
76 | |||||
77 | 18 | 70µs | my $attr_reader = $action->{attr_reader}; | ||
78 | my $methods = $action->{methods}; | ||||
79 | |||||
80 | # create the attribute | ||||
81 | $META->add_attribute($action->{name} => ( | ||||
82 | reader => $attr_reader, | ||||
83 | default => sub { {} } | ||||
84 | )); # spent 890µs making 2 calls to Class::MOP::Mixin::HasAttributes::add_attribute, avg 445µs/call | ||||
85 | |||||
86 | # create some helper methods | ||||
87 | $META->add_method($methods->{add} => sub { | ||||
88 | my ($self, @values) = @_; | ||||
89 | $self->$attr_reader->{$_} = undef foreach @values; | ||||
90 | }) if exists $methods->{add}; # spent 50µs making 1 call to Class::MOP::Mixin::HasMethods::add_method | ||||
91 | |||||
92 | $META->add_method($methods->{get_keys} => sub { | ||||
93 | my ($self) = @_; | ||||
94 | keys %{$self->$attr_reader}; | ||||
95 | }) if exists $methods->{get_keys}; # spent 48µs making 1 call to Class::MOP::Mixin::HasMethods::add_method | ||||
96 | |||||
97 | $META->add_method($methods->{get_values} => sub { | ||||
98 | my ($self) = @_; | ||||
99 | values %{$self->$attr_reader}; | ||||
100 | }) if exists $methods->{get_values}; # spent 49µs making 1 call to Class::MOP::Mixin::HasMethods::add_method | ||||
101 | |||||
102 | $META->add_method($methods->{get} => sub { | ||||
103 | my ($self, $name) = @_; | ||||
104 | $self->$attr_reader->{$name} | ||||
105 | }) if exists $methods->{get}; | ||||
106 | |||||
107 | $META->add_method($methods->{existence} => sub { | ||||
108 | my ($self, $name) = @_; | ||||
109 | exists $self->$attr_reader->{$name} ? 1 : 0; | ||||
110 | }) if exists $methods->{existence}; # spent 93µs making 2 calls to Class::MOP::Mixin::HasMethods::add_method, avg 46µs/call | ||||
111 | |||||
112 | $META->add_method($methods->{remove} => sub { | ||||
113 | my ($self, @values) = @_; | ||||
114 | delete $self->$attr_reader->{$_} foreach @values; | ||||
115 | }) if exists $methods->{remove}; # spent 51µs making 1 call to Class::MOP::Mixin::HasMethods::add_method | ||||
116 | } | ||||
117 | |||||
118 | $META->add_attribute( | ||||
119 | 1 | 3µs | 1 | 291µs | 'method_metaclass', # spent 291µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
120 | reader => 'method_metaclass', | ||||
121 | default => 'Moose::Meta::Role::Method', | ||||
122 | ); | ||||
123 | |||||
124 | 1 | 2µs | 1 | 252µs | $META->add_attribute( # spent 252µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
125 | 'required_method_metaclass', | ||||
126 | reader => 'required_method_metaclass', | ||||
127 | default => 'Moose::Meta::Role::Method::Required', | ||||
128 | ); | ||||
129 | |||||
130 | 1 | 1µs | 1 | 250µs | $META->add_attribute( # spent 250µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
131 | 'conflicting_method_metaclass', | ||||
132 | reader => 'conflicting_method_metaclass', | ||||
133 | default => 'Moose::Meta::Role::Method::Conflicting', | ||||
134 | ); | ||||
135 | |||||
136 | 1 | 2µs | 1 | 345µs | $META->add_attribute( # spent 345µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
137 | 'application_to_class_class', | ||||
138 | reader => 'application_to_class_class', | ||||
139 | default => 'Moose::Meta::Role::Application::ToClass', | ||||
140 | ); | ||||
141 | |||||
142 | 1 | 2µs | 1 | 321µs | $META->add_attribute( # spent 321µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
143 | 'application_to_role_class', | ||||
144 | reader => 'application_to_role_class', | ||||
145 | default => 'Moose::Meta::Role::Application::ToRole', | ||||
146 | ); | ||||
147 | |||||
148 | 1 | 2µs | 1 | 280µs | $META->add_attribute( # spent 280µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
149 | 'application_to_instance_class', | ||||
150 | reader => 'application_to_instance_class', | ||||
151 | default => 'Moose::Meta::Role::Application::ToInstance', | ||||
152 | ); | ||||
153 | |||||
154 | # More or less copied from Moose::Meta::Class | ||||
155 | sub initialize { | ||||
156 | my $class = shift; | ||||
157 | my $pkg = shift; | ||||
158 | return Class::MOP::get_metaclass_by_name($pkg) | ||||
159 | || $class->SUPER::initialize( | ||||
160 | $pkg, | ||||
161 | 'attribute_metaclass' => 'Moose::Meta::Role::Attribute', | ||||
162 | @_ | ||||
163 | ); | ||||
164 | } | ||||
165 | |||||
166 | sub reinitialize { | ||||
167 | my $self = shift; | ||||
168 | my $pkg = shift; | ||||
169 | |||||
170 | my $meta = blessed $pkg ? $pkg : Class::MOP::class_of($pkg); | ||||
171 | |||||
172 | my %existing_classes; | ||||
173 | if ($meta) { | ||||
174 | %existing_classes = map { $_ => $meta->$_() } qw( | ||||
175 | attribute_metaclass | ||||
176 | method_metaclass | ||||
177 | wrapped_method_metaclass | ||||
178 | required_method_metaclass | ||||
179 | conflicting_method_metaclass | ||||
180 | application_to_class_class | ||||
181 | application_to_role_class | ||||
182 | application_to_instance_class | ||||
183 | ); | ||||
184 | } | ||||
185 | |||||
186 | return $self->SUPER::reinitialize( | ||||
187 | $pkg, | ||||
188 | %existing_classes, | ||||
189 | @_, | ||||
190 | ); | ||||
191 | } | ||||
192 | |||||
193 | sub add_attribute { | ||||
194 | my $self = shift; | ||||
195 | |||||
196 | if (blessed $_[0] && ! $_[0]->isa('Moose::Meta::Role::Attribute') ) { | ||||
197 | my $class = ref $_[0]; | ||||
198 | Moose->throw_error( "Cannot add a $class as an attribute to a role" ); | ||||
199 | } | ||||
200 | |||||
201 | return $self->SUPER::add_attribute(@_); | ||||
202 | } | ||||
203 | |||||
204 | sub _attach_attribute { | ||||
205 | my ( $self, $attribute ) = @_; | ||||
206 | |||||
207 | $attribute->attach_to_role($self); | ||||
208 | } | ||||
209 | |||||
210 | sub add_required_methods { | ||||
211 | my $self = shift; | ||||
212 | |||||
213 | for (@_) { | ||||
214 | my $method = $_; | ||||
215 | if (!blessed($method)) { | ||||
216 | $method = $self->required_method_metaclass->new( | ||||
217 | name => $method, | ||||
218 | ); | ||||
219 | } | ||||
220 | $self->get_required_methods_map->{$method->name} = $method; | ||||
221 | } | ||||
222 | } | ||||
223 | |||||
224 | sub add_conflicting_method { | ||||
225 | my $self = shift; | ||||
226 | |||||
227 | my $method; | ||||
228 | if (@_ == 1 && blessed($_[0])) { | ||||
229 | $method = shift; | ||||
230 | } | ||||
231 | else { | ||||
232 | $method = $self->conflicting_method_metaclass->new(@_); | ||||
233 | } | ||||
234 | |||||
235 | $self->add_required_methods($method); | ||||
236 | } | ||||
237 | |||||
238 | ## ------------------------------------------------------------------ | ||||
239 | ## method modifiers | ||||
240 | |||||
241 | # NOTE: | ||||
242 | # the before/around/after method modifiers are | ||||
243 | # stored by name, but there can be many methods | ||||
244 | # then associated with that name. So again we have | ||||
245 | # lots of similar functionality, so we can do some | ||||
246 | # meta-programmin' and save some time. | ||||
247 | # - SL | ||||
248 | |||||
249 | 1 | 2µs | foreach my $modifier_type (qw[ before around after ]) { | ||
250 | |||||
251 | 15 | 54µs | my $attr_reader = "get_${modifier_type}_method_modifiers_map"; | ||
252 | |||||
253 | # create the attribute ... | ||||
254 | $META->add_attribute("${modifier_type}_method_modifiers" => ( | ||||
255 | reader => $attr_reader, | ||||
256 | default => sub { {} } | ||||
257 | )); # spent 812µs making 3 calls to Class::MOP::Mixin::HasAttributes::add_attribute, avg 271µs/call | ||||
258 | |||||
259 | # and some helper methods ... | ||||
260 | $META->add_method("get_${modifier_type}_method_modifiers" => sub { | ||||
261 | my ($self, $method_name) = @_; | ||||
262 | #return () unless exists $self->$attr_reader->{$method_name}; | ||||
263 | my $mm = $self->$attr_reader->{$method_name}; | ||||
264 | $mm ? @$mm : (); | ||||
265 | }); # spent 85µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 28µs/call | ||||
266 | |||||
267 | $META->add_method("has_${modifier_type}_method_modifiers" => sub { | ||||
268 | my ($self, $method_name) = @_; | ||||
269 | # NOTE: | ||||
270 | # for now we assume that if it exists,.. | ||||
271 | # it has at least one modifier in it | ||||
272 | (exists $self->$attr_reader->{$method_name}) ? 1 : 0; | ||||
273 | }); # spent 77µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 26µs/call | ||||
274 | |||||
275 | $META->add_method("add_${modifier_type}_method_modifier" => sub { | ||||
276 | my ($self, $method_name, $method) = @_; | ||||
277 | |||||
278 | $self->$attr_reader->{$method_name} = [] | ||||
279 | unless exists $self->$attr_reader->{$method_name}; | ||||
280 | |||||
281 | my $modifiers = $self->$attr_reader->{$method_name}; | ||||
282 | |||||
283 | # NOTE: | ||||
284 | # check to see that we aren't adding the | ||||
285 | # same code twice. We err in favor of the | ||||
286 | # first on here, this may not be as expected | ||||
287 | foreach my $modifier (@{$modifiers}) { | ||||
288 | return if $modifier == $method; | ||||
289 | } | ||||
290 | |||||
291 | push @{$modifiers} => $method; | ||||
292 | }); # spent 82µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 27µs/call | ||||
293 | |||||
294 | } | ||||
295 | |||||
296 | ## ------------------------------------------------------------------ | ||||
297 | ## override method mofidiers | ||||
298 | |||||
299 | $META->add_attribute('override_method_modifiers' => ( | ||||
300 | reader => 'get_override_method_modifiers_map', | ||||
301 | default => sub { {} } | ||||
302 | 1 | 3µs | 1 | 256µs | )); # spent 256µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
303 | |||||
304 | # NOTE: | ||||
305 | # these are a little different because there | ||||
306 | # can only be one per name, whereas the other | ||||
307 | # method modifiers can have multiples. | ||||
308 | # - SL | ||||
309 | |||||
310 | sub add_override_method_modifier { | ||||
311 | my ($self, $method_name, $method) = @_; | ||||
312 | (!$self->has_method($method_name)) | ||||
313 | || Moose->throw_error("Cannot add an override of method '$method_name' " . | ||||
314 | "because there is a local version of '$method_name'"); | ||||
315 | $self->get_override_method_modifiers_map->{$method_name} = $method; | ||||
316 | } | ||||
317 | |||||
318 | sub has_override_method_modifier { | ||||
319 | my ($self, $method_name) = @_; | ||||
320 | # NOTE: | ||||
321 | # for now we assume that if it exists,.. | ||||
322 | # it has at least one modifier in it | ||||
323 | (exists $self->get_override_method_modifiers_map->{$method_name}) ? 1 : 0; | ||||
324 | } | ||||
325 | |||||
326 | sub get_override_method_modifier { | ||||
327 | my ($self, $method_name) = @_; | ||||
328 | $self->get_override_method_modifiers_map->{$method_name}; | ||||
329 | } | ||||
330 | |||||
331 | ## general list accessor ... | ||||
332 | |||||
333 | sub get_method_modifier_list { | ||||
334 | my ($self, $modifier_type) = @_; | ||||
335 | my $accessor = "get_${modifier_type}_method_modifiers_map"; | ||||
336 | keys %{$self->$accessor}; | ||||
337 | } | ||||
338 | |||||
339 | sub reset_package_cache_flag { (shift)->{'_package_cache_flag'} = undef } | ||||
340 | sub update_package_cache_flag { | ||||
341 | my $self = shift; | ||||
342 | $self->{'_package_cache_flag'} = Class::MOP::check_package_cache_flag($self->name); | ||||
343 | } | ||||
344 | |||||
345 | |||||
346 | |||||
347 | ## ------------------------------------------------------------------ | ||||
348 | ## subroles | ||||
349 | |||||
350 | $META->add_attribute('roles' => ( | ||||
351 | reader => 'get_roles', | ||||
352 | default => sub { [] } | ||||
353 | 1 | 3µs | 1 | 280µs | )); # spent 280µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
354 | |||||
355 | sub add_role { | ||||
356 | my ($self, $role) = @_; | ||||
357 | (blessed($role) && $role->isa('Moose::Meta::Role')) | ||||
358 | || Moose->throw_error("Roles must be instances of Moose::Meta::Role"); | ||||
359 | push @{$self->get_roles} => $role; | ||||
360 | $self->reset_package_cache_flag; | ||||
361 | } | ||||
362 | |||||
363 | sub calculate_all_roles { | ||||
364 | my $self = shift; | ||||
365 | my %seen; | ||||
366 | grep { | ||||
367 | !$seen{$_->name}++ | ||||
368 | } ($self, map { | ||||
369 | $_->calculate_all_roles | ||||
370 | } @{ $self->get_roles }); | ||||
371 | } | ||||
372 | |||||
373 | sub does_role { | ||||
374 | my ($self, $role) = @_; | ||||
375 | (defined $role) | ||||
376 | || Moose->throw_error("You must supply a role name to look for"); | ||||
377 | my $role_name = blessed $role ? $role->name : $role; | ||||
378 | # if we are it,.. then return true | ||||
379 | return 1 if $role_name eq $self->name; | ||||
380 | # otherwise.. check our children | ||||
381 | foreach my $role (@{$self->get_roles}) { | ||||
382 | return 1 if $role->does_role($role_name); | ||||
383 | } | ||||
384 | return 0; | ||||
385 | } | ||||
386 | |||||
387 | sub find_method_by_name { (shift)->get_method(@_) } | ||||
388 | |||||
389 | sub alias_method { | ||||
390 | Carp::cluck("The alias_method method is deprecated. Use add_method instead.\n"); | ||||
391 | |||||
392 | my $self = shift; | ||||
393 | |||||
394 | $self->add_method(@_); | ||||
395 | } | ||||
396 | |||||
397 | ## ------------------------------------------------------------------ | ||||
398 | ## role construction | ||||
399 | ## ------------------------------------------------------------------ | ||||
400 | |||||
401 | sub apply { | ||||
402 | my ($self, $other, @args) = @_; | ||||
403 | |||||
404 | (blessed($other)) | ||||
405 | || Moose->throw_error("You must pass in an blessed instance"); | ||||
406 | |||||
407 | my $application_class; | ||||
408 | if ($other->isa('Moose::Meta::Role')) { | ||||
409 | $application_class = $self->application_to_role_class; | ||||
410 | } | ||||
411 | elsif ($other->isa('Moose::Meta::Class')) { | ||||
412 | $application_class = $self->application_to_class_class; | ||||
413 | } | ||||
414 | else { | ||||
415 | $application_class = $self->application_to_instance_class; | ||||
416 | } | ||||
417 | |||||
418 | Class::MOP::load_class($application_class); | ||||
419 | return $application_class->new(@args)->apply($self, $other); | ||||
420 | } | ||||
421 | |||||
422 | sub composition_class_roles { } | ||||
423 | |||||
424 | sub combine { | ||||
425 | my ($class, @role_specs) = @_; | ||||
426 | |||||
427 | require Moose::Meta::Role::Composite; | ||||
428 | |||||
429 | my (@roles, %role_params); | ||||
430 | while (@role_specs) { | ||||
431 | my ($role, $params) = @{ splice @role_specs, 0, 1 }; | ||||
432 | my $requested_role | ||||
433 | = blessed $role | ||||
434 | ? $role | ||||
435 | : Class::MOP::class_of($role); | ||||
436 | |||||
437 | my $actual_role = $requested_role->_role_for_combination($params); | ||||
438 | push @roles => $actual_role; | ||||
439 | |||||
440 | next unless defined $params; | ||||
441 | $role_params{$actual_role->name} = $params; | ||||
442 | } | ||||
443 | |||||
444 | my $c = Moose::Meta::Role::Composite->new(roles => \@roles); | ||||
445 | return $c->apply_params(\%role_params); | ||||
446 | } | ||||
447 | |||||
448 | sub _role_for_combination { | ||||
449 | my ($self, $params) = @_; | ||||
450 | return $self; | ||||
451 | } | ||||
452 | |||||
453 | sub create { | ||||
454 | my ( $role, $package_name, %options ) = @_; | ||||
455 | |||||
456 | $options{package} = $package_name; | ||||
457 | |||||
458 | (ref $options{attributes} eq 'HASH') | ||||
459 | || confess "You must pass a HASH ref of attributes" | ||||
460 | if exists $options{attributes}; | ||||
461 | |||||
462 | (ref $options{methods} eq 'HASH') | ||||
463 | || confess "You must pass a HASH ref of methods" | ||||
464 | if exists $options{methods}; | ||||
465 | |||||
466 | my (%initialize_options) = %options; | ||||
467 | delete @initialize_options{qw( | ||||
468 | package | ||||
469 | attributes | ||||
470 | methods | ||||
471 | version | ||||
472 | authority | ||||
473 | )}; | ||||
474 | |||||
475 | my $meta = $role->initialize( $package_name => %initialize_options ); | ||||
476 | |||||
477 | $meta->_instantiate_module( $options{version}, $options{authority} ); | ||||
478 | |||||
479 | # FIXME totally lame | ||||
480 | $meta->add_method('meta' => sub { | ||||
481 | $role->initialize(ref($_[0]) || $_[0]); | ||||
482 | }); | ||||
483 | |||||
484 | if (exists $options{attributes}) { | ||||
485 | foreach my $attribute_name (keys %{$options{attributes}}) { | ||||
486 | my $attr = $options{attributes}->{$attribute_name}; | ||||
487 | $meta->add_attribute( | ||||
488 | $attribute_name => blessed $attr ? $attr : %{$attr} ); | ||||
489 | } | ||||
490 | } | ||||
491 | |||||
492 | if (exists $options{methods}) { | ||||
493 | foreach my $method_name (keys %{$options{methods}}) { | ||||
494 | $meta->add_method($method_name, $options{methods}->{$method_name}); | ||||
495 | } | ||||
496 | } | ||||
497 | |||||
498 | Class::MOP::weaken_metaclass($meta->name) | ||||
499 | if $meta->is_anon_role; | ||||
500 | |||||
501 | return $meta; | ||||
502 | } | ||||
503 | |||||
504 | # anonymous roles. most of it is copied straight out of Class::MOP::Class. | ||||
505 | # an intrepid hacker might find great riches if he unifies this code with that | ||||
506 | # code in Class::MOP::Module or Class::MOP::Package | ||||
507 | { | ||||
508 | # NOTE: | ||||
509 | # this should be sufficient, if you have a | ||||
510 | # use case where it is not, write a test and | ||||
511 | # I will change it. | ||||
512 | 3 | 1µs | my $ANON_ROLE_SERIAL = 0; | ||
513 | |||||
514 | # NOTE: | ||||
515 | # we need a sufficiently annoying prefix | ||||
516 | # this should suffice for now, this is | ||||
517 | # used in a couple of places below, so | ||||
518 | # need to put it up here for now. | ||||
519 | my $ANON_ROLE_PREFIX = 'Moose::Meta::Role::__ANON__::SERIAL::'; | ||||
520 | |||||
521 | sub is_anon_role { | ||||
522 | my $self = shift; | ||||
523 | 3 | 119µs | 2 | 61µs | # spent 35µs (10+25) within Moose::Meta::Role::BEGIN@523 which was called
# once (10µs+25µs) by Moose::BEGIN@26 at line 523 # spent 35µs making 1 call to Moose::Meta::Role::BEGIN@523
# spent 25µs making 1 call to warnings::unimport |
524 | $self->name =~ /^$ANON_ROLE_PREFIX/; | ||||
525 | } | ||||
526 | |||||
527 | sub create_anon_role { | ||||
528 | my ($role, %options) = @_; | ||||
529 | my $package_name = $ANON_ROLE_PREFIX . ++$ANON_ROLE_SERIAL; | ||||
530 | return $role->create($package_name, %options); | ||||
531 | } | ||||
532 | |||||
533 | # NOTE: | ||||
534 | # this will only get called for | ||||
535 | # anon-roles, all other calls | ||||
536 | # are assumed to occur during | ||||
537 | # global destruction and so don't | ||||
538 | # really need to be handled explicitly | ||||
539 | sub DESTROY { | ||||
540 | my $self = shift; | ||||
541 | |||||
542 | return if in_global_destruction(); # it'll happen soon anyway and this just makes things more complicated | ||||
543 | |||||
544 | 3 | 116µs | 2 | 40µs | # spent 26µs (12+14) within Moose::Meta::Role::BEGIN@544 which was called
# once (12µs+14µs) by Moose::BEGIN@26 at line 544 # spent 26µs making 1 call to Moose::Meta::Role::BEGIN@544
# spent 14µs making 1 call to warnings::unimport |
545 | return unless $self->name =~ /^$ANON_ROLE_PREFIX/; | ||||
546 | |||||
547 | # XXX: is this necessary for us? I don't understand what it's doing | ||||
548 | # -sartak | ||||
549 | |||||
550 | # Moose does a weird thing where it replaces the metaclass for | ||||
551 | # class when fixing metaclass incompatibility. In that case, | ||||
552 | # we don't want to clean out the namespace now. We can detect | ||||
553 | # that because Moose will explicitly update the singleton | ||||
554 | # cache in Class::MOP. | ||||
555 | #my $current_meta = Class::MOP::get_metaclass_by_name($self->name); | ||||
556 | #return if $current_meta ne $self; | ||||
557 | |||||
558 | my ($serial_id) = ($self->name =~ /^$ANON_ROLE_PREFIX(\d+)/); | ||||
559 | 3 | 168µs | 2 | 55µs | # spent 34µs (13+21) within Moose::Meta::Role::BEGIN@559 which was called
# once (13µs+21µs) by Moose::BEGIN@26 at line 559 # spent 34µs making 1 call to Moose::Meta::Role::BEGIN@559
# spent 21µs making 1 call to strict::unimport |
560 | foreach my $key (keys %{$ANON_ROLE_PREFIX . $serial_id}) { | ||||
561 | delete ${$ANON_ROLE_PREFIX . $serial_id}{$key}; | ||||
562 | } | ||||
563 | delete ${'main::' . $ANON_ROLE_PREFIX}{$serial_id . '::'}; | ||||
564 | } | ||||
565 | } | ||||
566 | |||||
567 | ##################################################################### | ||||
568 | ## NOTE: | ||||
569 | ## This is Moose::Meta::Role as defined by Moose (plus the use of | ||||
570 | ## MooseX::AttributeHelpers module). It is here as a reference to | ||||
571 | ## make it easier to see what is happening above with all the meta | ||||
572 | ## programming. - SL | ||||
573 | ##################################################################### | ||||
574 | # | ||||
575 | # has 'roles' => ( | ||||
576 | # metaclass => 'Array', | ||||
577 | # reader => 'get_roles', | ||||
578 | # isa => 'ArrayRef[Moose::Meta::Role]', | ||||
579 | # default => sub { [] }, | ||||
580 | # provides => { | ||||
581 | # 'push' => 'add_role', | ||||
582 | # } | ||||
583 | # ); | ||||
584 | # | ||||
585 | # has 'excluded_roles_map' => ( | ||||
586 | # metaclass => 'Hash', | ||||
587 | # reader => 'get_excluded_roles_map', | ||||
588 | # isa => 'HashRef[Str]', | ||||
589 | # provides => { | ||||
590 | # # Not exactly set, cause it sets multiple | ||||
591 | # 'set' => 'add_excluded_roles', | ||||
592 | # 'keys' => 'get_excluded_roles_list', | ||||
593 | # 'exists' => 'excludes_role', | ||||
594 | # } | ||||
595 | # ); | ||||
596 | # | ||||
597 | # has 'required_methods' => ( | ||||
598 | # metaclass => 'Hash', | ||||
599 | # reader => 'get_required_methods_map', | ||||
600 | # isa => 'HashRef[Moose::Meta::Role::Method::Required]', | ||||
601 | # provides => { | ||||
602 | # # not exactly set, or delete since it works for multiple | ||||
603 | # 'set' => 'add_required_methods', | ||||
604 | # 'delete' => 'remove_required_methods', | ||||
605 | # 'keys' => 'get_required_method_list', | ||||
606 | # 'exists' => 'requires_method', | ||||
607 | # } | ||||
608 | # ); | ||||
609 | # | ||||
610 | # # the before, around and after modifiers are | ||||
611 | # # HASH keyed by method-name, with ARRAY of | ||||
612 | # # CODE refs to apply in that order | ||||
613 | # | ||||
614 | # has 'before_method_modifiers' => ( | ||||
615 | # metaclass => 'Hash', | ||||
616 | # reader => 'get_before_method_modifiers_map', | ||||
617 | # isa => 'HashRef[ArrayRef[CodeRef]]', | ||||
618 | # provides => { | ||||
619 | # 'keys' => 'get_before_method_modifiers', | ||||
620 | # 'exists' => 'has_before_method_modifiers', | ||||
621 | # # This actually makes sure there is an | ||||
622 | # # ARRAY at the given key, and pushed onto | ||||
623 | # # it. It also checks for duplicates as well | ||||
624 | # # 'add' => 'add_before_method_modifier' | ||||
625 | # } | ||||
626 | # ); | ||||
627 | # | ||||
628 | # has 'after_method_modifiers' => ( | ||||
629 | # metaclass => 'Hash', | ||||
630 | # reader =>'get_after_method_modifiers_map', | ||||
631 | # isa => 'HashRef[ArrayRef[CodeRef]]', | ||||
632 | # provides => { | ||||
633 | # 'keys' => 'get_after_method_modifiers', | ||||
634 | # 'exists' => 'has_after_method_modifiers', | ||||
635 | # # This actually makes sure there is an | ||||
636 | # # ARRAY at the given key, and pushed onto | ||||
637 | # # it. It also checks for duplicates as well | ||||
638 | # # 'add' => 'add_after_method_modifier' | ||||
639 | # } | ||||
640 | # ); | ||||
641 | # | ||||
642 | # has 'around_method_modifiers' => ( | ||||
643 | # metaclass => 'Hash', | ||||
644 | # reader =>'get_around_method_modifiers_map', | ||||
645 | # isa => 'HashRef[ArrayRef[CodeRef]]', | ||||
646 | # provides => { | ||||
647 | # 'keys' => 'get_around_method_modifiers', | ||||
648 | # 'exists' => 'has_around_method_modifiers', | ||||
649 | # # This actually makes sure there is an | ||||
650 | # # ARRAY at the given key, and pushed onto | ||||
651 | # # it. It also checks for duplicates as well | ||||
652 | # # 'add' => 'add_around_method_modifier' | ||||
653 | # } | ||||
654 | # ); | ||||
655 | # | ||||
656 | # # override is similar to the other modifiers | ||||
657 | # # except that it is not an ARRAY of code refs | ||||
658 | # # but instead just a single name->code mapping | ||||
659 | # | ||||
660 | # has 'override_method_modifiers' => ( | ||||
661 | # metaclass => 'Hash', | ||||
662 | # reader =>'get_override_method_modifiers_map', | ||||
663 | # isa => 'HashRef[CodeRef]', | ||||
664 | # provides => { | ||||
665 | # 'keys' => 'get_override_method_modifier', | ||||
666 | # 'exists' => 'has_override_method_modifier', | ||||
667 | # 'add' => 'add_override_method_modifier', # checks for local method .. | ||||
668 | # } | ||||
669 | # ); | ||||
670 | # | ||||
671 | ##################################################################### | ||||
672 | |||||
673 | |||||
674 | 1 | 76µs | 1; | ||
675 | |||||
676 | __END__ | ||||
677 | |||||
678 | =pod | ||||
679 | |||||
680 | =head1 NAME | ||||
681 | |||||
682 | Moose::Meta::Role - The Moose Role metaclass | ||||
683 | |||||
684 | =head1 DESCRIPTION | ||||
685 | |||||
686 | This class is a subclass of L<Class::MOP::Module> that provides | ||||
687 | additional Moose-specific functionality. | ||||
688 | |||||
689 | It's API looks a lot like L<Moose::Meta::Class>, but internally it | ||||
690 | implements many things differently. This may change in the future. | ||||
691 | |||||
692 | =head1 INHERITANCE | ||||
693 | |||||
694 | C<Moose::Meta::Role> is a subclass of L<Class::MOP::Module>. | ||||
695 | |||||
696 | =head1 METHODS | ||||
697 | |||||
698 | =head2 Construction | ||||
699 | |||||
700 | =over 4 | ||||
701 | |||||
702 | =item B<< Moose::Meta::Role->initialize($role_name) >> | ||||
703 | |||||
704 | This method creates a new role object with the provided name. | ||||
705 | |||||
706 | =item B<< Moose::Meta::Role->combine( [ $role => { ... } ], [ $role ], ... ) >> | ||||
707 | |||||
708 | This method accepts a list of array references. Each array reference | ||||
709 | should contain a role name or L<Moose::Meta::Role> object as its first element. The second element is | ||||
710 | an optional hash reference. The hash reference can contain C<-excludes> | ||||
711 | and C<-alias> keys to control how methods are composed from the role. | ||||
712 | |||||
713 | The return value is a new L<Moose::Meta::Role::Composite> that | ||||
714 | represents the combined roles. | ||||
715 | |||||
716 | =item B<< $metarole->composition_class_roles >> | ||||
717 | |||||
718 | When combining multiple roles using C<combine>, this method is used to obtain a | ||||
719 | list of role names to be applied to the L<Moose::Meta::Role::Composite> | ||||
720 | instance returned by C<combine>. The default implementation returns an empty | ||||
721 | list. Extensions that need to hook into role combination may wrap this method | ||||
722 | to return additional role names. | ||||
723 | |||||
724 | =item B<< Moose::Meta::Role->create($name, %options) >> | ||||
725 | |||||
726 | This method is identical to the L<Moose::Meta::Class> C<create> | ||||
727 | method. | ||||
728 | |||||
729 | =item B<< Moose::Meta::Role->create_anon_role >> | ||||
730 | |||||
731 | This method is identical to the L<Moose::Meta::Class> | ||||
732 | C<create_anon_class> method. | ||||
733 | |||||
734 | =item B<< $metarole->is_anon_role >> | ||||
735 | |||||
736 | Returns true if the role is an anonymous role. | ||||
737 | |||||
738 | =back | ||||
739 | |||||
740 | =head2 Role application | ||||
741 | |||||
742 | =over 4 | ||||
743 | |||||
744 | =item B<< $metarole->apply( $thing, @options ) >> | ||||
745 | |||||
746 | This method applies a role to the given C<$thing>. That can be another | ||||
747 | L<Moose::Meta::Role>, object, a L<Moose::Meta::Class> object, or a | ||||
748 | (non-meta) object instance. | ||||
749 | |||||
750 | The options are passed directly to the constructor for the appropriate | ||||
751 | L<Moose::Meta::Role::Application> subclass. | ||||
752 | |||||
753 | Note that this will apply the role even if the C<$thing> in question already | ||||
754 | C<does> this role. L<Moose::Util/does_role> is a convenient wrapper for | ||||
755 | finding out if role application is necessary. | ||||
756 | |||||
757 | =back | ||||
758 | |||||
759 | =head2 Roles and other roles | ||||
760 | |||||
761 | =over 4 | ||||
762 | |||||
763 | =item B<< $metarole->get_roles >> | ||||
764 | |||||
765 | This returns an array reference of roles which this role does. This | ||||
766 | list may include duplicates. | ||||
767 | |||||
768 | =item B<< $metarole->calculate_all_roles >> | ||||
769 | |||||
770 | This returns a I<unique> list of all roles that this role does, and | ||||
771 | all the roles that its roles do. | ||||
772 | |||||
773 | =item B<< $metarole->does_role($role) >> | ||||
774 | |||||
775 | Given a role I<name> or L<Moose::Meta::Role> object, returns true if this role | ||||
776 | does the given role. | ||||
777 | |||||
778 | =item B<< $metarole->add_role($role) >> | ||||
779 | |||||
780 | Given a L<Moose::Meta::Role> object, this adds the role to the list of | ||||
781 | roles that the role does. | ||||
782 | |||||
783 | =item B<< $metarole->get_excluded_roles_list >> | ||||
784 | |||||
785 | Returns a list of role names which this role excludes. | ||||
786 | |||||
787 | =item B<< $metarole->excludes_role($role_name) >> | ||||
788 | |||||
789 | Given a role I<name>, returns true if this role excludes the named | ||||
790 | role. | ||||
791 | |||||
792 | =item B<< $metarole->add_excluded_roles(@role_names) >> | ||||
793 | |||||
794 | Given one or more role names, adds those roles to the list of excluded | ||||
795 | roles. | ||||
796 | |||||
797 | =back | ||||
798 | |||||
799 | =head2 Methods | ||||
800 | |||||
801 | The methods for dealing with a role's methods are all identical in API | ||||
802 | and behavior to the same methods in L<Class::MOP::Class>. | ||||
803 | |||||
804 | =over 4 | ||||
805 | |||||
806 | =item B<< $metarole->method_metaclass >> | ||||
807 | |||||
808 | Returns the method metaclass name for the role. This defaults to | ||||
809 | L<Moose::Meta::Role::Method>. | ||||
810 | |||||
811 | =item B<< $metarole->get_method($name) >> | ||||
812 | |||||
813 | =item B<< $metarole->has_method($name) >> | ||||
814 | |||||
815 | =item B<< $metarole->add_method( $name, $body ) >> | ||||
816 | |||||
817 | =item B<< $metarole->get_method_list >> | ||||
818 | |||||
819 | =item B<< $metarole->find_method_by_name($name) >> | ||||
820 | |||||
821 | These methods are all identical to the methods of the same name in | ||||
822 | L<Class::MOP::Package> | ||||
823 | |||||
824 | =back | ||||
825 | |||||
826 | =head2 Attributes | ||||
827 | |||||
828 | As with methods, the methods for dealing with a role's attribute are | ||||
829 | all identical in API and behavior to the same methods in | ||||
830 | L<Class::MOP::Class>. | ||||
831 | |||||
832 | However, attributes stored in this class are I<not> stored as | ||||
833 | objects. Rather, the attribute definition is stored as a hash | ||||
834 | reference. When a role is composed into a class, this hash reference | ||||
835 | is passed directly to the metaclass's C<add_attribute> method. | ||||
836 | |||||
837 | This is quite likely to change in the future. | ||||
838 | |||||
839 | =over 4 | ||||
840 | |||||
841 | =item B<< $metarole->get_attribute($attribute_name) >> | ||||
842 | |||||
843 | =item B<< $metarole->has_attribute($attribute_name) >> | ||||
844 | |||||
845 | =item B<< $metarole->get_attribute_list >> | ||||
846 | |||||
847 | =item B<< $metarole->add_attribute($name, %options) >> | ||||
848 | |||||
849 | =item B<< $metarole->remove_attribute($attribute_name) >> | ||||
850 | |||||
851 | =back | ||||
852 | |||||
853 | =head2 Required methods | ||||
854 | |||||
855 | =over 4 | ||||
856 | |||||
857 | =item B<< $metarole->get_required_method_list >> | ||||
858 | |||||
859 | Returns the list of methods required by the role. | ||||
860 | |||||
861 | =item B<< $metarole->requires_method($name) >> | ||||
862 | |||||
863 | Returns true if the role requires the named method. | ||||
864 | |||||
865 | =item B<< $metarole->add_required_methods(@names) >> | ||||
866 | |||||
867 | Adds the named methods to the role's list of required methods. | ||||
868 | |||||
869 | =item B<< $metarole->remove_required_methods(@names) >> | ||||
870 | |||||
871 | Removes the named methods from the role's list of required methods. | ||||
872 | |||||
873 | =item B<< $metarole->add_conflicting_method(%params) >> | ||||
874 | |||||
875 | Instantiate the parameters as a L<Moose::Meta::Role::Method::Conflicting> | ||||
876 | object, then add it to the required method list. | ||||
877 | |||||
878 | =back | ||||
879 | |||||
880 | =head2 Method modifiers | ||||
881 | |||||
882 | These methods act like their counterparts in L<Class::MOP::Class> and | ||||
883 | L<Moose::Meta::Class>. | ||||
884 | |||||
885 | However, method modifiers are simply stored internally, and are not | ||||
886 | applied until the role itself is applied to a class. | ||||
887 | |||||
888 | =over 4 | ||||
889 | |||||
890 | =item B<< $metarole->add_after_method_modifier($method_name, $method) >> | ||||
891 | |||||
892 | =item B<< $metarole->add_around_method_modifier($method_name, $method) >> | ||||
893 | |||||
894 | =item B<< $metarole->add_before_method_modifier($method_name, $method) >> | ||||
895 | |||||
896 | =item B<< $metarole->add_override_method_modifier($method_name, $method) >> | ||||
897 | |||||
898 | These methods all add an appropriate modifier to the internal list of | ||||
899 | modifiers. | ||||
900 | |||||
901 | =item B<< $metarole->has_after_method_modifiers >> | ||||
902 | |||||
903 | =item B<< $metarole->has_around_method_modifiers >> | ||||
904 | |||||
905 | =item B<< $metarole->has_before_method_modifiers >> | ||||
906 | |||||
907 | =item B<< $metarole->has_override_method_modifier >> | ||||
908 | |||||
909 | Return true if the role has any modifiers of the given type. | ||||
910 | |||||
911 | =item B<< $metarole->get_after_method_modifiers($method_name) >> | ||||
912 | |||||
913 | =item B<< $metarole->get_around_method_modifiers($method_name) >> | ||||
914 | |||||
915 | =item B<< $metarole->get_before_method_modifiers($method_name) >> | ||||
916 | |||||
917 | Given a method name, returns a list of the appropriate modifiers for | ||||
918 | that method. | ||||
919 | |||||
920 | =item B<< $metarole->get_override_method_modifier($method_name) >> | ||||
921 | |||||
922 | Given a method name, returns the override method modifier for that | ||||
923 | method, if it has one. | ||||
924 | |||||
925 | =back | ||||
926 | |||||
927 | =head2 Introspection | ||||
928 | |||||
929 | =over 4 | ||||
930 | |||||
931 | =item B<< Moose::Meta::Role->meta >> | ||||
932 | |||||
933 | This will return a L<Class::MOP::Class> instance for this class. | ||||
934 | |||||
935 | =back | ||||
936 | |||||
937 | =head1 BUGS | ||||
938 | |||||
939 | See L<Moose/BUGS> for details on reporting bugs. | ||||
940 | |||||
941 | =head1 AUTHOR | ||||
942 | |||||
943 | Stevan Little E<lt>stevan@iinteractive.comE<gt> | ||||
944 | |||||
945 | =head1 COPYRIGHT AND LICENSE | ||||
946 | |||||
947 | Copyright 2006-2010 by Infinity Interactive, Inc. | ||||
948 | |||||
949 | L<http://www.iinteractive.com> | ||||
950 | |||||
951 | This library is free software; you can redistribute it and/or modify | ||||
952 | it under the same terms as Perl itself. | ||||
953 | |||||
954 | =cut |