| 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 | Moose::Meta::Role::BEGIN@17 |
| 104 | 4 | 2 | 564µs | 809µs | Moose::Meta::Role::get_method_modifier_list |
| 26 | 1 | 1 | 510µs | 141ms | Moose::Meta::Role::apply |
| 44 | 2 | 2 | 378µs | 2.51ms | Moose::Meta::Role::add_attribute |
| 1 | 1 | 1 | 294µs | 930µs | Moose::Meta::Role::BEGIN@19 |
| 1 | 1 | 1 | 264µs | 803µs | Moose::Meta::Role::BEGIN@20 |
| 24 | 2 | 1 | 230µs | 2.25ms | Moose::Meta::Role::initialize |
| 1 | 1 | 1 | 194µs | 287µs | Moose::Meta::Role::BEGIN@18 |
| 13 | 1 | 1 | 137µs | 208µs | Moose::Meta::Role::add_role |
| 44 | 1 | 1 | 135µs | 496µs | Moose::Meta::Role::_attach_attribute |
| 4 | 3 | 3 | 83µs | 236µs | Moose::Meta::Role::add_required_methods |
| 66 | 3 | 1 | 66µs | 66µs | Moose::Meta::Role::__ANON__[:256] |
| 44 | 2 | 1 | 59µs | 59µs | Moose::Meta::Role::__ANON__[:83] |
| 10 | 1 | 1 | 41µs | 951µs | Moose::Meta::Role::find_method_by_name |
| 22 | 1 | 1 | 32µs | 32µs | Moose::Meta::Role::__ANON__[:301] |
| 22 | 1 | 1 | 27µs | 27µs | Moose::Meta::Role::__ANON__[:352] |
| 1 | 1 | 1 | 21µs | 153µs | Moose::Meta::Role::add_conflicting_method |
| 13 | 1 | 1 | 21µs | 21µs | Moose::Meta::Role::reset_package_cache_flag |
| 1 | 1 | 1 | 15µs | 18µs | Moose::Meta::Role::BEGIN@4 |
| 1 | 1 | 1 | 10µs | 24µs | Moose::Meta::Role::BEGIN@523 |
| 1 | 1 | 1 | 9µs | 19µs | Moose::Meta::Role::BEGIN@544 |
| 1 | 1 | 1 | 8µs | 243µs | Moose::Meta::Role::BEGIN@10 |
| 1 | 1 | 1 | 8µs | 38µs | Moose::Meta::Role::BEGIN@9 |
| 1 | 1 | 1 | 8µs | 48µs | Moose::Meta::Role::BEGIN@8 |
| 1 | 1 | 1 | 7µs | 20µs | Moose::Meta::Role::BEGIN@559 |
| 1 | 1 | 1 | 7µs | 75µs | Moose::Meta::Role::BEGIN@23 |
| 1 | 1 | 1 | 7µs | 17µs | Moose::Meta::Role::BEGIN@5 |
| 1 | 1 | 1 | 7µs | 138µs | Moose::Meta::Role::BEGIN@21 |
| 1 | 1 | 1 | 6µs | 108µs | Moose::Meta::Role::BEGIN@6 |
| 1 | 1 | 1 | 5µs | 5µ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__[: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__[:482] |
| 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::_role_for_combination |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::add_override_method_modifier |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::alias_method |
| 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::get_override_method_modifier |
| 0 | 0 | 0 | 0s | 0s | Moose::Meta::Role::has_override_method_modifier |
| 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::update_package_cache_flag |
| 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 |