File | /usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm |
Statements Executed | 1707 |
Statement Execution Time | 6.13ms |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
1 | 1 | 1 | 578µs | 1.90ms | BEGIN@17 | Moose::Meta::Role::
104 | 4 | 2 | 564µs | 809µs | get_method_modifier_list | Moose::Meta::Role::
26 | 1 | 1 | 510µs | 141ms | apply | Moose::Meta::Role::
44 | 2 | 2 | 378µs | 2.51ms | add_attribute | Moose::Meta::Role::
1 | 1 | 1 | 294µs | 930µs | BEGIN@19 | Moose::Meta::Role::
1 | 1 | 1 | 264µs | 803µs | BEGIN@20 | Moose::Meta::Role::
24 | 2 | 1 | 230µs | 2.25ms | initialize | Moose::Meta::Role::
1 | 1 | 1 | 194µs | 287µs | BEGIN@18 | Moose::Meta::Role::
13 | 1 | 1 | 137µs | 208µs | add_role | Moose::Meta::Role::
44 | 1 | 1 | 135µs | 496µs | _attach_attribute | Moose::Meta::Role::
4 | 3 | 3 | 83µs | 236µs | add_required_methods | Moose::Meta::Role::
66 | 3 | 1 | 66µs | 66µs | __ANON__[:256] | Moose::Meta::Role::
44 | 2 | 1 | 59µs | 59µs | __ANON__[:83] | Moose::Meta::Role::
10 | 1 | 1 | 41µs | 951µs | find_method_by_name | Moose::Meta::Role::
22 | 1 | 1 | 32µs | 32µs | __ANON__[:301] | Moose::Meta::Role::
22 | 1 | 1 | 27µs | 27µs | __ANON__[:352] | Moose::Meta::Role::
1 | 1 | 1 | 21µs | 153µs | add_conflicting_method | Moose::Meta::Role::
13 | 1 | 1 | 21µs | 21µs | reset_package_cache_flag | Moose::Meta::Role::
1 | 1 | 1 | 15µs | 18µs | BEGIN@4 | Moose::Meta::Role::
1 | 1 | 1 | 10µs | 24µs | BEGIN@523 | Moose::Meta::Role::
1 | 1 | 1 | 9µs | 19µs | BEGIN@544 | Moose::Meta::Role::
1 | 1 | 1 | 8µs | 243µs | BEGIN@10 | Moose::Meta::Role::
1 | 1 | 1 | 8µs | 38µs | BEGIN@9 | Moose::Meta::Role::
1 | 1 | 1 | 8µs | 48µs | BEGIN@8 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 20µs | BEGIN@559 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 75µs | BEGIN@23 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 17µs | BEGIN@5 | Moose::Meta::Role::
1 | 1 | 1 | 7µs | 138µs | BEGIN@21 | Moose::Meta::Role::
1 | 1 | 1 | 6µs | 108µs | BEGIN@6 | Moose::Meta::Role::
1 | 1 | 1 | 5µs | 5µ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__[: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__[:482] | 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 | _role_for_combination | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | add_override_method_modifier | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | alias_method | 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 | get_override_method_modifier | Moose::Meta::Role::
0 | 0 | 0 | 0s | 0s | has_override_method_modifier | 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 | 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 | 21µ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 | 18µs | 2 | 26µs | # spent 17µs (7+9) within Moose::Meta::Role::BEGIN@5 which was called
# once (7µs+9µ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 | 25µs | 2 | 211µs | # spent 108µs (6+103) within Moose::Meta::Role::BEGIN@6 which was called
# once (6µs+103µs) by Moose::BEGIN@26 at line 6 # spent 108µs making 1 call to Moose::Meta::Role::BEGIN@6
# spent 103µs making 1 call to metaclass::import |
7 | |||||
8 | 3 | 24µs | 2 | 89µs | # spent 48µs (8+40) within Moose::Meta::Role::BEGIN@8 which was called
# once (8µs+40µs) by Moose::BEGIN@26 at line 8 # spent 48µs making 1 call to Moose::Meta::Role::BEGIN@8
# spent 40µs making 1 call to Exporter::import |
9 | 3 | 24µs | 2 | 67µs | # spent 38µs (8+29) within Moose::Meta::Role::BEGIN@9 which was called
# once (8µs+29µs) by Moose::BEGIN@26 at line 9 # spent 38µs making 1 call to Moose::Meta::Role::BEGIN@9
# spent 29µs making 1 call to Exporter::import |
10 | 3 | 50µs | 2 | 477µs | # spent 243µs (8+235) within Moose::Meta::Role::BEGIN@10 which was called
# once (8µs+235µs) by Moose::BEGIN@26 at line 10 # spent 243µs making 1 call to Moose::Meta::Role::BEGIN@10
# spent 235µs making 1 call to Sub::Exporter::__ANON__[Sub/Exporter.pm:756] |
11 | |||||
12 | 1 | 700ns | our $VERSION = '0.98'; | ||
13 | 1 | 20µs | $VERSION = eval $VERSION; | ||
14 | 1 | 300ns | our $AUTHORITY = 'cpan:STEVAN'; | ||
15 | |||||
16 | 3 | 21µs | 1 | 5µs | # spent 5µs within Moose::Meta::Role::BEGIN@16 which was called
# once (5µs+0s) by Moose::BEGIN@26 at line 16 # spent 5µs making 1 call to Moose::Meta::Role::BEGIN@16 |
17 | 3 | 118µs | 1 | 1.90ms | # spent 1.90ms (578µs+1.32) within Moose::Meta::Role::BEGIN@17 which was called
# once (578µs+1.32ms) by Moose::BEGIN@26 at line 17 # spent 1.90ms making 1 call to Moose::Meta::Role::BEGIN@17 |
18 | 3 | 111µs | 1 | 287µs | # spent 287µs (194+93) within Moose::Meta::Role::BEGIN@18 which was called
# once (194µs+93µs) by Moose::BEGIN@26 at line 18 # spent 287µs making 1 call to Moose::Meta::Role::BEGIN@18 |
19 | 3 | 104µs | 1 | 930µs | # spent 930µs (294+635) within Moose::Meta::Role::BEGIN@19 which was called
# once (294µs+635µs) by Moose::BEGIN@26 at line 19 # spent 930µs making 1 call to Moose::Meta::Role::BEGIN@19 |
20 | 3 | 105µs | 1 | 803µs | # spent 803µs (264+539) within Moose::Meta::Role::BEGIN@20 which was called
# once (264µs+539µs) by Moose::BEGIN@26 at line 20 # spent 803µs making 1 call to Moose::Meta::Role::BEGIN@20 |
21 | 3 | 28µs | 2 | 269µs | # spent 138µs (7+131) within Moose::Meta::Role::BEGIN@21 which was called
# once (7µs+131µs) by Moose::BEGIN@26 at line 21 # spent 138µs making 1 call to Moose::Meta::Role::BEGIN@21
# spent 131µs making 1 call to Sub::Exporter::__ANON__[Sub/Exporter.pm:756] |
22 | |||||
23 | 3 | 1.63ms | 2 | 144µ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 | 2µs | 1 | 18µs | my $META = __PACKAGE__->meta; # spent 18µ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 | 8µ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 | 2 | 1µs | my $attr_reader = $action->{attr_reader}; | ||
78 | 2 | 400ns | my $methods = $action->{methods}; | ||
79 | |||||
80 | # create the attribute | ||||
81 | $META->add_attribute($action->{name} => ( | ||||
82 | reader => $attr_reader, | ||||
83 | 44 | 90µs | # spent 59µs within Moose::Meta::Role::__ANON__[/usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm:83] which was called 44 times, avg 1µs/call:
# 22 times (31µs+0s) by Moose::Meta::Role::_new at line 11 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 1µs/call
# 22 times (28µs+0s) by Moose::Meta::Role::_new at line 88 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 1µs/call | ||
84 | 2 | 6µs | 2 | 590µs | )); # spent 590µs making 2 calls to Class::MOP::Mixin::HasAttributes::add_attribute, avg 295µ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 | 2 | 5µs | 1 | 29µs | }) if exists $methods->{add}; # spent 29µs making 1 call to Class::MOP::Mixin::HasMethods::add_method |
91 | |||||
92 | $META->add_method($methods->{get_keys} => sub { | ||||
93 | 26 | 19µs | my ($self) = @_; | ||
94 | 26 | 124µs | 26 | 53µs | keys %{$self->$attr_reader}; # spent 53µs making 26 calls to Moose::Meta::Role::get_excluded_roles_map, avg 2µs/call |
95 | 2 | 4µs | 1 | 26µs | }) if exists $methods->{get_keys}; # spent 26µs making 1 call to Class::MOP::Mixin::HasMethods::add_method |
96 | |||||
97 | $META->add_method($methods->{get_values} => sub { | ||||
98 | 26 | 19µs | my ($self) = @_; | ||
99 | 26 | 132µs | 26 | 63µs | values %{$self->$attr_reader}; # spent 63µs making 26 calls to Moose::Meta::Role::get_required_methods_map, avg 2µs/call |
100 | 2 | 5µs | 1 | 30µs | }) if exists $methods->{get_values}; # spent 30µ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 | 2 | 500ns | }) if exists $methods->{get}; | ||
106 | |||||
107 | $META->add_method($methods->{existence} => sub { | ||||
108 | 13 | 9µs | my ($self, $name) = @_; | ||
109 | 13 | 50µs | 13 | 27µs | exists $self->$attr_reader->{$name} ? 1 : 0; # spent 27µs making 13 calls to Moose::Meta::Role::get_excluded_roles_map, avg 2µs/call |
110 | 2 | 8µs | 2 | 61µs | }) if exists $methods->{existence}; # spent 61µs making 2 calls to Class::MOP::Mixin::HasMethods::add_method, avg 31µs/call |
111 | |||||
112 | $META->add_method($methods->{remove} => sub { | ||||
113 | my ($self, @values) = @_; | ||||
114 | delete $self->$attr_reader->{$_} foreach @values; | ||||
115 | 2 | 6µs | 1 | 27µs | }) if exists $methods->{remove}; # spent 27µs making 1 call to Class::MOP::Mixin::HasMethods::add_method |
116 | } | ||||
117 | |||||
118 | $META->add_attribute( | ||||
119 | 1 | 1µs | 1 | 288µs | 'method_metaclass', # spent 288µ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 | 1µs | 1 | 267µs | $META->add_attribute( # spent 267µ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 | 270µs | $META->add_attribute( # spent 270µ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 | 1µs | 1 | 282µs | $META->add_attribute( # spent 282µ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 | 1µs | 1 | 323µs | $META->add_attribute( # spent 323µ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 | 465µs | $META->add_attribute( # spent 465µ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 | # spent 2.25ms (230µs+2.02) within Moose::Meta::Role::initialize which was called 24 times, avg 94µs/call:
# 22 times (221µs+2.02ms) by Moose::Role::init_meta at line 129 of Moose/Role.pm, avg 102µs/call
# 2 times (10µs+3µs) by MooseX::AttributeHelpers::MethodProvider::Hash::meta at line 134 of Moose/Role.pm, avg 6µs/call | ||||
156 | 24 | 10µs | my $class = shift; | ||
157 | 24 | 7µs | my $pkg = shift; | ||
158 | 24 | 184µs | 46 | 2.02ms | return Class::MOP::get_metaclass_by_name($pkg) # spent 1.99ms making 22 calls to Class::MOP::Package::initialize, avg 90µs/call
# spent 35µs making 24 calls to Class::MOP::get_metaclass_by_name, avg 1µs/call |
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 | # spent 2.51ms (378µs+2.14) within Moose::Meta::Role::add_attribute which was called 44 times, avg 57µs/call:
# 30 times (251µs+1.17ms) by Moose::Meta::Role::Application::ToRole::apply_attributes at line 65 of Moose/Meta/Role/Application/ToRole.pm, avg 47µs/call
# 14 times (126µs+963µs) by Moose::Role::has at line 47 of Moose/Role.pm, avg 78µs/call | ||||
194 | 44 | 11µs | my $self = shift; | ||
195 | |||||
196 | 44 | 181µs | 74 | 47µs | if (blessed $_[0] && ! $_[0]->isa('Moose::Meta::Role::Attribute') ) { # spent 25µs making 44 calls to Scalar::Util::blessed, avg 566ns/call
# spent 22µs making 30 calls to UNIVERSAL::isa, avg 743ns/call |
197 | my $class = ref $_[0]; | ||||
198 | Moose->throw_error( "Cannot add a $class as an attribute to a role" ); | ||||
199 | } | ||||
200 | |||||
201 | 44 | 215µs | 44 | 2.09ms | return $self->SUPER::add_attribute(@_); # spent 2.09ms making 44 calls to Class::MOP::Mixin::HasAttributes::add_attribute, avg 47µs/call |
202 | } | ||||
203 | |||||
204 | # spent 496µs (135+361) within Moose::Meta::Role::_attach_attribute which was called 44 times, avg 11µs/call:
# 44 times (135µs+361µs) by Class::MOP::Mixin::HasAttributes::add_attribute at line 28 of Class/MOP/Mixin/HasAttributes.pm, avg 11µs/call | ||||
205 | 44 | 15µs | my ( $self, $attribute ) = @_; | ||
206 | |||||
207 | 44 | 97µs | 44 | 361µs | $attribute->attach_to_role($self); # spent 361µs making 44 calls to Moose::Meta::Role::Attribute::attach_to_role, avg 8µs/call |
208 | } | ||||
209 | |||||
210 | # spent 236µs (83+153) within Moose::Meta::Role::add_required_methods which was called 4 times, avg 59µs/call:
# 2 times (54µs+145µs) by Moose::Role::requires at line 32 of Moose/Role.pm, avg 100µs/call
# once (15µs+5µs) by Moose::Meta::Role::add_conflicting_method at line 235
# once (14µs+4µs) by Moose::Meta::Role::Application::ToRole::check_required_methods at line 43 of Moose/Meta/Role/Application/ToRole.pm | ||||
211 | 4 | 2µs | my $self = shift; | ||
212 | |||||
213 | 4 | 16µs | for (@_) { | ||
214 | 4 | 2µs | my $method = $_; | ||
215 | 4 | 33µs | 8 | 132µs | if (!blessed($method)) { # spent 122µs making 2 calls to Moose::Meta::Role::Method::Required::new, avg 61µs/call
# spent 8µs making 2 calls to Moose::Meta::Role::required_method_metaclass, avg 4µs/call
# spent 3µs making 4 calls to Scalar::Util::blessed, avg 650ns/call |
216 | $method = $self->required_method_metaclass->new( | ||||
217 | name => $method, | ||||
218 | ); | ||||
219 | } | ||||
220 | 4 | 23µs | 8 | 21µs | $self->get_required_methods_map->{$method->name} = $method; # spent 11µs making 4 calls to Moose::Meta::Role::Method::Required::name, avg 3µs/call
# spent 10µs making 4 calls to Moose::Meta::Role::get_required_methods_map, avg 3µs/call |
221 | } | ||||
222 | } | ||||
223 | |||||
224 | # spent 153µs (21+131) within Moose::Meta::Role::add_conflicting_method which was called
# once (21µs+131µs) by Moose::Meta::Role::Application::ToRole::apply_methods at line 77 of Moose/Meta/Role/Application/ToRole.pm | ||||
225 | 1 | 400ns | my $self = shift; | ||
226 | |||||
227 | 1 | 400ns | my $method; | ||
228 | 1 | 1µs | if (@_ == 1 && blessed($_[0])) { | ||
229 | $method = shift; | ||||
230 | } | ||||
231 | else { | ||||
232 | 1 | 12µs | 2 | 112µs | $method = $self->conflicting_method_metaclass->new(@_); # spent 108µs making 1 call to Moose::Meta::Role::Method::Required::new
# spent 4µs making 1 call to Moose::Meta::Role::conflicting_method_metaclass |
233 | } | ||||
234 | |||||
235 | 1 | 4µs | 1 | 20µs | $self->add_required_methods($method); # spent 20µs making 1 call to Moose::Meta::Role::add_required_methods |
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 | 1µs | foreach my $modifier_type (qw[ before around after ]) { | ||
250 | |||||
251 | 3 | 4µ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 | 66 | 115µs | # spent 66µs within Moose::Meta::Role::__ANON__[/usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm:256] which was called 66 times, avg 1µs/call:
# 22 times (28µs+0s) by Moose::Meta::Role::_new at line 31 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 1µs/call
# 22 times (21µs+0s) by Moose::Meta::Role::_new at line 55 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 941ns/call
# 22 times (18µs+0s) by Moose::Meta::Role::_new at line 60 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 800ns/call | ||
257 | 3 | 10µs | 3 | 918µs | )); # spent 918µs making 3 calls to Class::MOP::Mixin::HasAttributes::add_attribute, avg 306µs/call |
258 | |||||
259 | # and some helper methods ... | ||||
260 | $META->add_method("get_${modifier_type}_method_modifiers" => sub { | ||||
261 | 73 | 47µs | my ($self, $method_name) = @_; | ||
262 | #return () unless exists $self->$attr_reader->{$method_name}; | ||||
263 | 73 | 110µs | 73 | 86µs | my $mm = $self->$attr_reader->{$method_name}; # spent 46µs making 40 calls to Moose::Meta::Role::get_after_method_modifiers_map, avg 1µs/call
# spent 25µs making 23 calls to Moose::Meta::Role::get_before_method_modifiers_map, avg 1µs/call
# spent 15µs making 10 calls to Moose::Meta::Role::get_around_method_modifiers_map, avg 2µs/call |
264 | 73 | 175µs | $mm ? @$mm : (); | ||
265 | 3 | 14µs | 3 | 89µs | }); # spent 89µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 30µ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 | 3 | 16µs | 3 | 80µs | }); # spent 80µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 27µs/call |
274 | |||||
275 | $META->add_method("add_${modifier_type}_method_modifier" => sub { | ||||
276 | 49 | 23µs | my ($self, $method_name, $method) = @_; | ||
277 | |||||
278 | 49 | 151µs | 98 | 106µs | $self->$attr_reader->{$method_name} = [] # spent 49µs making 48 calls to Moose::Meta::Role::get_after_method_modifiers_map, avg 1µs/call
# spent 34µs making 30 calls to Moose::Meta::Role::get_before_method_modifiers_map, avg 1µs/call
# spent 23µs making 20 calls to Moose::Meta::Role::get_around_method_modifiers_map, avg 1µs/call |
279 | unless exists $self->$attr_reader->{$method_name}; | ||||
280 | |||||
281 | 49 | 59µs | 49 | 46µs | my $modifiers = $self->$attr_reader->{$method_name}; # spent 23µs making 24 calls to Moose::Meta::Role::get_after_method_modifiers_map, avg 942ns/call
# spent 14µs making 15 calls to Moose::Meta::Role::get_before_method_modifiers_map, avg 940ns/call
# spent 10µs making 10 calls to Moose::Meta::Role::get_around_method_modifiers_map, avg 970ns/call |
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 | 49 | 24µs | foreach my $modifier (@{$modifiers}) { | ||
288 | return if $modifier == $method; | ||||
289 | } | ||||
290 | |||||
291 | 49 | 109µs | push @{$modifiers} => $method; | ||
292 | 3 | 15µs | 3 | 79µs | }); # spent 79µs making 3 calls to Class::MOP::Mixin::HasMethods::add_method, avg 26µ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 | 22 | 47µs | # spent 32µs within Moose::Meta::Role::__ANON__[/usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm:301] which was called 22 times, avg 1µs/call:
# 22 times (32µs+0s) by Moose::Meta::Role::_new at line 73 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 1µs/call | ||
302 | 1 | 2µs | 1 | 279µs | )); # spent 279µ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 | # spent 809µs (564+245) within Moose::Meta::Role::get_method_modifier_list which was called 104 times, avg 8µs/call:
# 39 times (225µs+116µs) by Moose::Meta::Role::Application::ToClass::apply_method_modifiers at line 214 of Moose/Meta/Role/Application/ToClass.pm, avg 9µs/call
# 39 times (154µs+64µs) by Moose::Meta::Role::Application::ToRole::apply_method_modifiers at line 162 of Moose/Meta/Role/Application/ToRole.pm, avg 6µs/call
# 13 times (114µs+40µs) by Moose::Meta::Role::Application::ToClass::apply_override_method_modifiers at line 192 of Moose/Meta/Role/Application/ToClass.pm, avg 12µs/call
# 13 times (71µs+25µs) by Moose::Meta::Role::Application::ToRole::apply_override_method_modifiers at line 122 of Moose/Meta/Role/Application/ToRole.pm, avg 7µs/call | ||||
334 | 104 | 37µs | my ($self, $modifier_type) = @_; | ||
335 | 104 | 39µs | my $accessor = "get_${modifier_type}_method_modifiers_map"; | ||
336 | 104 | 438µs | 104 | 245µs | keys %{$self->$accessor}; # spent 66µs making 26 calls to Moose::Meta::Role::get_around_method_modifiers_map, avg 3µs/call
# spent 65µs making 26 calls to Moose::Meta::Role::get_override_method_modifiers_map, avg 3µs/call
# spent 59µs making 26 calls to Moose::Meta::Role::get_before_method_modifiers_map, avg 2µs/call
# spent 55µs making 26 calls to Moose::Meta::Role::get_after_method_modifiers_map, avg 2µs/call |
337 | } | ||||
338 | |||||
339 | 13 | 33µs | # spent 21µs within Moose::Meta::Role::reset_package_cache_flag which was called 13 times, avg 2µs/call:
# 13 times (21µs+0s) by Moose::Meta::Role::add_role at line 360, avg 2µs/call | ||
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 | 22 | 42µs | # spent 27µs within Moose::Meta::Role::__ANON__[/usr/local/lib/perl5/site_perl/5.10.1/darwin-2level/Moose/Meta/Role.pm:352] which was called 22 times, avg 1µs/call:
# 22 times (27µs+0s) by Moose::Meta::Role::_new at line 36 of (eval 0)[Class/MOP/Method/Generated.pm:54] at line 54 of Class/MOP/Method/Generated.pm, avg 1µs/call | ||
353 | 1 | 3µs | 1 | 271µs | )); # spent 271µs making 1 call to Class::MOP::Mixin::HasAttributes::add_attribute |
354 | |||||
355 | # spent 208µs (137+71) within Moose::Meta::Role::add_role which was called 13 times, avg 16µs/call:
# 13 times (137µs+71µs) by Moose::Meta::Role::Application::ToRole::apply at line 18 of Moose/Meta/Role/Application/ToRole.pm, avg 16µs/call | ||||
356 | 13 | 7µs | my ($self, $role) = @_; | ||
357 | 13 | 68µs | 26 | 21µs | (blessed($role) && $role->isa('Moose::Meta::Role')) # spent 11µs making 13 calls to UNIVERSAL::isa, avg 831ns/call
# spent 11µs making 13 calls to Scalar::Util::blessed, avg 808ns/call |
358 | || Moose->throw_error("Roles must be instances of Moose::Meta::Role"); | ||||
359 | 13 | 28µs | 13 | 29µs | push @{$self->get_roles} => $role; # spent 29µs making 13 calls to Moose::Meta::Role::get_roles, avg 2µs/call |
360 | 13 | 39µs | 13 | 21µs | $self->reset_package_cache_flag; # spent 21µs making 13 calls to Moose::Meta::Role::reset_package_cache_flag, avg 2µs/call |
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 | 10 | 38µs | 10 | 909µs | # spent 951µs (41+909) within Moose::Meta::Role::find_method_by_name which was called 10 times, avg 95µs/call:
# 10 times (41µs+909µs) by Moose::Meta::Role::Application::ToRole::check_required_methods at line 43 of Moose/Meta/Role/Application/ToRole.pm, avg 95µs/call # spent 909µs making 10 calls to Class::MOP::Mixin::HasMethods::get_method, avg 91µs/call |
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 | # spent 141ms (510µs+140) within Moose::Meta::Role::apply which was called 26 times, avg 5.41ms/call:
# 26 times (510µs+140ms) by Moose::Util::_apply_all_roles at line 132 of Moose/Util.pm, avg 5.41ms/call | ||||
402 | 26 | 20µs | my ($self, $other, @args) = @_; | ||
403 | |||||
404 | 26 | 66µs | 26 | 15µs | (blessed($other)) # spent 15µs making 26 calls to Scalar::Util::blessed, avg 588ns/call |
405 | || Moose->throw_error("You must pass in an blessed instance"); | ||||
406 | |||||
407 | 26 | 4µs | my $application_class; | ||
408 | 26 | 172µs | 65 | 130µs | if ($other->isa('Moose::Meta::Role')) { # spent 60µs making 13 calls to Moose::Meta::Role::application_to_class_class, avg 5µs/call
# spent 36µs making 13 calls to Moose::Meta::Role::application_to_role_class, avg 3µs/call
# spent 35µs making 39 calls to UNIVERSAL::isa, avg 895ns/call |
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 | 26 | 24µs | 26 | 0s | Class::MOP::load_class($application_class); # spent 722µs making 26 calls to Class::MOP::load_class, avg 28µs/call, recursion: max depth 2, time 722µs |
419 | 26 | 201µs | 52 | 139ms | return $application_class->new(@args)->apply($self, $other); # spent 106ms making 13 calls to Moose::Meta::Role::Application::ToClass::apply, avg 8.14ms/call
# spent 32.6ms making 13 calls to Moose::Meta::Role::Application::ToRole::apply, avg 2.51ms/call
# spent 710µs making 26 calls to Moose::Meta::Role::Application::new, avg 27µs/call |
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 | 2 | 600ns | 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 | 1 | 600ns | my $ANON_ROLE_PREFIX = 'Moose::Meta::Role::__ANON__::SERIAL::'; | ||
520 | |||||
521 | sub is_anon_role { | ||||
522 | my $self = shift; | ||||
523 | 3 | 97µs | 2 | 39µs | # spent 24µs (10+15) within Moose::Meta::Role::BEGIN@523 which was called
# once (10µs+15µs) by Moose::BEGIN@26 at line 523 # spent 24µs making 1 call to Moose::Meta::Role::BEGIN@523
# spent 15µ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 | 58µs | 2 | 30µs | # spent 19µs (9+10) within Moose::Meta::Role::BEGIN@544 which was called
# once (9µs+10µs) by Moose::BEGIN@26 at line 544 # spent 19µs making 1 call to Moose::Meta::Role::BEGIN@544
# spent 10µ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 | 106µs | 2 | 32µs | # spent 20µs (7+13) within Moose::Meta::Role::BEGIN@559 which was called
# once (7µs+13µs) by Moose::BEGIN@26 at line 559 # spent 20µs making 1 call to Moose::Meta::Role::BEGIN@559
# spent 13µ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 | 80µ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 |