| 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 | Moose::Meta::Role::BEGIN@17 |
| 1 | 1 | 1 | 309µs | 985µs | Moose::Meta::Role::BEGIN@19 |
| 1 | 1 | 1 | 259µs | 789µs | Moose::Meta::Role::BEGIN@20 |
| 1 | 1 | 1 | 189µs | 299µs | Moose::Meta::Role::BEGIN@18 |
| 1 | 1 | 1 | 15µs | 18µs | Moose::Meta::Role::BEGIN@4 |
| 1 | 1 | 1 | 13µs | 34µs | Moose::Meta::Role::BEGIN@559 |
| 1 | 1 | 1 | 12µs | 26µs | Moose::Meta::Role::BEGIN@544 |
| 1 | 1 | 1 | 11µs | 68µs | Moose::Meta::Role::BEGIN@8 |
| 1 | 1 | 1 | 10µs | 35µs | Moose::Meta::Role::BEGIN@523 |
| 1 | 1 | 1 | 8µs | 251µs | Moose::Meta::Role::BEGIN@10 |
| 1 | 1 | 1 | 8µs | 34µs | Moose::Meta::Role::BEGIN@9 |
| 1 | 1 | 1 | 7µs | 158µs | Moose::Meta::Role::BEGIN@6 |
| 1 | 1 | 1 | 7µs | 17µs | Moose::Meta::Role::BEGIN@5 |
| 1 | 1 | 1 | 7µs | 136µs | Moose::Meta::Role::BEGIN@21 |
| 1 | 1 | 1 | 7µs | 75µs | Moose::Meta::Role::BEGIN@23 |
| 1 | 1 | 1 | 6µs | 6µs | Moose::Meta::Role::BEGIN@16 |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::DESTROY |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:100] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:105] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:110] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:115] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:256] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:265] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:273] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:292] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:301] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:352] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:482] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:83] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:90] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::__ANON__[:95] |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::_attach_attribute |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::_role_for_combination |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_attribute |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_conflicting_method |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_override_method_modifier |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_required_methods |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_role |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::alias_method |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::apply |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::calculate_all_roles |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::combine |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::composition_class_roles |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::create |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::create_anon_role |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::does_role |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::find_method_by_name |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::get_method_modifier_list |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::get_override_method_modifier |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::has_override_method_modifier |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::initialize |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::is_anon_role |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::reinitialize |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::reset_package_cache_flag |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::update_package_cache_flag |
| 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 | 2 | 3µs | my $attr_reader = $action->{attr_reader}; | ||
| 78 | 2 | 800ns | my $methods = $action->{methods}; | ||
| 79 | |||||
| 80 | # create the attribute | ||||
| 81 | $META->add_attribute($action->{name} => ( | ||||
| 82 | reader => $attr_reader, | ||||
| 83 | default => sub { {} } | ||||
| 84 | 2 | 10µs | 2 | 890µs | )); # 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 | 2 | 9µs | 1 | 50µs | }) 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 | 2 | 7µs | 1 | 48µs | }) 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 | 2 | 10µs | 1 | 49µs | }) 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 | 2 | 1µs | }) 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 | 2 | 16µs | 2 | 93µs | }) 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 | 2 | 13µs | 1 | 51µs | }) 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 | 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 | default => sub { {} } | ||||
| 257 | 3 | 10µs | 3 | 812µs | )); # 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 | 3 | 14µs | 3 | 85µs | }); # 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 | 3 | 12µs | 3 | 77µs | }); # 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 | 3 | 15µs | 3 | 82µs | }); # 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 | 2 | 500ns | 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 | 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 |