Filename | /usr/share/perl5/Class/C3/Componentised.pm |
Statements | Executed 21651 statements in 212ms |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
6544 | 8 | 6 | 297ms | 1.32s | ensure_class_loaded (recurses: max depth 3, inclusive time 117ms) | Class::C3::Componentised::
1 | 1 | 1 | 1.45ms | 1.85ms | BEGIN@48 | Class::C3::Componentised::
16 | 1 | 1 | 405µs | 405µs | __ANON__[:199] | Class::C3::Componentised::
4 | 2 | 1 | 132µs | 70.8ms | _load_components (recurses: max depth 2, inclusive time 39.0ms) | Class::C3::Componentised::
3 | 3 | 3 | 114µs | 70.8ms | load_components (recurses: max depth 1, inclusive time 24.9ms) | Class::C3::Componentised::
1 | 1 | 1 | 30µs | 2.23ms | load_optional_class | Class::C3::Componentised::
1 | 1 | 1 | 24µs | 14.2ms | load_own_components | Class::C3::Componentised::
1 | 1 | 1 | 14µs | 20µs | BEGIN@40 | Class::C3::Componentised::
1 | 1 | 1 | 10µs | 18µs | BEGIN@133 | Class::C3::Componentised::
1 | 1 | 1 | 9µs | 15µs | BEGIN@198 | Class::C3::Componentised::
1 | 1 | 1 | 8µs | 12µs | BEGIN@41 | Class::C3::Componentised::
1 | 1 | 1 | 6µs | 6µs | BEGIN@50 | Class::C3::Componentised::
1 | 1 | 1 | 4µs | 4µs | BEGIN@51 | Class::C3::Componentised::
0 | 0 | 0 | 0s | 0s | __ANON__[:204] | Class::C3::Componentised::
0 | 0 | 0 | 0s | 0s | ensure_class_found | Class::C3::Componentised::
0 | 0 | 0 | 0s | 0s | inject_base | Class::C3::Componentised::
0 | 0 | 0 | 0s | 0s | load_optional_components | Class::C3::Componentised::
Line | State ments |
Time on line |
Calls | Time in subs |
Code |
---|---|---|---|---|---|
1 | package Class::C3::Componentised; | ||||
2 | |||||
3 | =head1 NAME | ||||
4 | |||||
5 | Class::C3::Componentised - load mix-ins or components to your C3-based class | ||||
6 | |||||
7 | =head1 DESCRIPTION | ||||
8 | |||||
9 | Load mix-ins or components to your C3-based class. | ||||
10 | |||||
11 | =head1 SYNOPSIS | ||||
12 | |||||
13 | package MyModule; | ||||
14 | |||||
15 | use strict; | ||||
16 | use warnings; | ||||
17 | |||||
18 | use base 'Class::C3::Componentised'; | ||||
19 | |||||
20 | sub component_base_class { "MyModule::Component" } | ||||
21 | |||||
22 | package main; | ||||
23 | |||||
24 | MyModule->load_components( qw/Foo Bar/ ); | ||||
25 | # Will load MyModule::Component::Foo and MyModule::Component::Bar | ||||
26 | |||||
27 | =head1 DESCRIPTION | ||||
28 | |||||
29 | This will inject base classes to your module using the L<Class::C3> method | ||||
30 | resolution order. | ||||
31 | |||||
32 | Please note: these are not plugins that can take precedence over methods | ||||
33 | declared in MyModule. If you want something like that, consider | ||||
34 | L<MooseX::Object::Pluggable>. | ||||
35 | |||||
36 | =head1 METHODS | ||||
37 | |||||
38 | =cut | ||||
39 | |||||
40 | 2 | 36µs | 2 | 27µs | # spent 20µs (14+7) within Class::C3::Componentised::BEGIN@40 which was called:
# once (14µs+7µs) by base::import at line 40 # spent 20µs making 1 call to Class::C3::Componentised::BEGIN@40
# spent 6µs making 1 call to strict::import |
41 | 2 | 33µs | 2 | 16µs | # spent 12µs (8+4) within Class::C3::Componentised::BEGIN@41 which was called:
# once (8µs+4µs) by base::import at line 41 # spent 12µs making 1 call to Class::C3::Componentised::BEGIN@41
# spent 4µs making 1 call to warnings::import |
42 | |||||
43 | # This will prime the Class::C3 namespace (either by loading it proper on 5.8 | ||||
44 | # or by installing compat shims on 5.10+). A user might have a reasonable | ||||
45 | # expectation that using Class::C3::<something> will give him access to | ||||
46 | # Class::C3 itself, and this module has been providing this historically. | ||||
47 | # Therefore leaving it in indefinitely. | ||||
48 | 2 | 140µs | 1 | 1.85ms | # spent 1.85ms (1.45+401µs) within Class::C3::Componentised::BEGIN@48 which was called:
# once (1.45ms+401µs) by base::import at line 48 # spent 1.85ms making 1 call to Class::C3::Componentised::BEGIN@48 |
49 | |||||
50 | 2 | 22µs | 1 | 6µs | # spent 6µs within Class::C3::Componentised::BEGIN@50 which was called:
# once (6µs+0s) by base::import at line 50 # spent 6µs making 1 call to Class::C3::Componentised::BEGIN@50 |
51 | 2 | 402µs | 1 | 4µs | # spent 4µs within Class::C3::Componentised::BEGIN@51 which was called:
# once (4µs+0s) by base::import at line 51 # spent 4µs making 1 call to Class::C3::Componentised::BEGIN@51 |
52 | |||||
53 | 1 | 500ns | our $VERSION = '1.001000'; | ||
54 | |||||
55 | 1 | 10µs | 1 | 3µs | $VERSION = eval $VERSION if $VERSION =~ /_/; # numify for warning-free dev releases # spent 3µs making 1 call to Class::C3::Componentised::CORE:match |
56 | |||||
57 | 1 | 8µs | 1 | 4µs | my $invalid_class = qr/(?: \b:\b | \:{3,} | \:\:$ )/x; # spent 4µs making 1 call to Class::C3::Componentised::CORE:qr |
58 | |||||
59 | =head2 load_components( @comps ) | ||||
60 | |||||
61 | Loads the given components into the current module. If a module begins with a | ||||
62 | C<+> character, it is taken to be a fully qualified class name, otherwise | ||||
63 | C<< $class->component_base_class >> is prepended to it. | ||||
64 | |||||
65 | Calling this will call C<Class::C3::reinitialize>. | ||||
66 | |||||
67 | =cut | ||||
68 | |||||
69 | # spent 70.8ms (114µs+70.7) within Class::C3::Componentised::load_components which was called 3 times, avg 23.6ms/call:
# once (49µs+70.8ms) by base::import at line 8 of DBIx/Class/Core.pm
# once (38µs+-38µs) by Class::C3::Componentised::ensure_class_loaded at line 9 of DBIx/Class/Relationship/Helpers.pm
# once (26µs+-26µs) by DBIx::Class::ResultSourceProxy::Table::BEGIN@8 at line 9 of DBIx/Class/ResultSource/Table.pm | ||||
70 | 3 | 2µs | my $class = shift; | ||
71 | 11 | 43µs | 22 | 12µs | $class->_load_components( map { # spent 9µs making 11 calls to DBIx::Class::component_base_class, avg 845ns/call
# spent 3µs making 11 calls to Class::C3::Componentised::CORE:match, avg 245ns/call |
72 | 11 | 27µs | 11 | 6µs | /^\+(.*)$/ # spent 6µs making 11 calls to Class::C3::Componentised::CORE:match, avg 564ns/call |
73 | ? $1 | ||||
74 | : join ('::', $class->component_base_class, $_) | ||||
75 | 3 | 41µs | 3 | 70.8ms | } grep { $_ !~ /^#/ } @_ # spent 95.6ms making 3 calls to Class::C3::Componentised::_load_components, avg 31.9ms/call, recursion: max depth 2, sum of overlapping time 24.8ms |
76 | ); | ||||
77 | } | ||||
78 | |||||
79 | =head2 load_own_components( @comps ) | ||||
80 | |||||
81 | Similar to L<load_components>, but assumes every class is C<"$class::$comp">. | ||||
82 | |||||
83 | =cut | ||||
84 | |||||
85 | # spent 14.2ms (24µs+14.2) within Class::C3::Componentised::load_own_components which was called:
# once (24µs+14.2ms) by Class::C3::Componentised::ensure_class_loaded at line 8 of DBIx/Class/Relationship.pm | ||||
86 | 1 | 700ns | my $class = shift; | ||
87 | 6 | 25µs | 6 | 2µs | $class->_load_components( map { "${class}::$_" } grep { $_ !~ /^#/ } @_ ); # spent 2µs making 5 calls to Class::C3::Componentised::CORE:match, avg 380ns/call
# spent 14.2ms making 1 call to Class::C3::Componentised::_load_components, recursion: max depth 1, sum of overlapping time 14.2ms |
88 | } | ||||
89 | |||||
90 | # spent 70.8ms (132µs+70.6) within Class::C3::Componentised::_load_components which was called 4 times, avg 17.7ms/call:
# 3 times (94µs+70.7ms) by Class::C3::Componentised::load_components at line 75, avg 23.6ms/call
# once (37µs+-37µs) by Class::C3::Componentised::load_own_components at line 87 | ||||
91 | 4 | 2µs | my $class = shift; | ||
92 | 4 | 2µs | return unless @_; | ||
93 | |||||
94 | 4 | 65µs | 16 | 0s | $class->ensure_class_loaded($_) for @_; # spent 106ms making 16 calls to Class::C3::Componentised::ensure_class_loaded, avg 6.60ms/call, recursion: max depth 3, sum of overlapping time 106ms |
95 | 4 | 29µs | 4 | 4.04ms | $class->inject_base($class => @_); # spent 4.04ms making 4 calls to DBIx::Class::Componentised::inject_base, avg 1.01ms/call |
96 | 4 | 25µs | 4 | 10µs | Class::C3::reinitialize(); # spent 10µs making 4 calls to MRO::Compat::__ANON__[MRO/Compat.pm:41], avg 2µs/call |
97 | } | ||||
98 | |||||
99 | =head2 load_optional_components | ||||
100 | |||||
101 | As L<load_components>, but will silently ignore any components that cannot be | ||||
102 | found. | ||||
103 | |||||
104 | =cut | ||||
105 | |||||
106 | sub load_optional_components { | ||||
107 | my $class = shift; | ||||
108 | $class->_load_components( grep | ||||
109 | { $class->load_optional_class( $_ ) } | ||||
110 | ( map | ||||
111 | { /^\+(.*)$/ | ||||
112 | ? $1 | ||||
113 | : join ('::', $class->component_base_class, $_) | ||||
114 | } | ||||
115 | grep { $_ !~ /^#/ } @_ | ||||
116 | ) | ||||
117 | ); | ||||
118 | } | ||||
119 | |||||
120 | =head2 ensure_class_loaded | ||||
121 | |||||
122 | Given a class name, tests to see if it is already loaded or otherwise | ||||
123 | defined. If it is not yet loaded, the package is require'd, and an exception | ||||
124 | is thrown if the class is still not loaded. | ||||
125 | |||||
126 | BUG: For some reason, packages with syntax errors are added to %INC on | ||||
127 | require | ||||
128 | =cut | ||||
129 | |||||
130 | # spent 1.32s (297ms+1.02) within Class::C3::Componentised::ensure_class_loaded which was called 6544 times, avg 202µs/call:
# 6000 times (43.0ms+0s) by DBIx::Class::ResultSet::result_class at line 1558 of DBIx/Class/ResultSet.pm, avg 7µs/call
# 176 times (1.57ms+7.06ms) by DBIx::Class::AccessorGroup::get_component_class at line 19 of DBIx/Class/AccessorGroup.pm, avg 49µs/call
# 174 times (218ms+988ms) by DBIx::Class::Schema::load_namespaces at line 239 of DBIx/Class/Schema.pm, avg 6.93ms/call
# 174 times (1.07ms+-1.07ms) by DBIx::Class::ResultSourceProxy::Table::table at line 87 of DBIx/Class/ResultSourceProxy/Table.pm, avg 0s/call
# 16 times (16.9ms+-16.9ms) by Class::C3::Componentised::_load_components at line 94, avg 0s/call
# 2 times (1.59ms+-1.59ms) by DBIx::Class::Relationship::BelongsTo::belongs_to at line 43 of DBIx/Class/Relationship/BelongsTo.pm, avg 0s/call
# once (13.1ms+46.7ms) by Try::Tiny::try at line 807 of DBIx/Class/Schema.pm
# once (1.74ms+459µs) by Class::C3::Componentised::load_optional_class at line 227 | ||||
131 | 6544 | 2.08ms | my ($class, $f_class) = @_; | ||
132 | |||||
133 | 2 | 309µs | 2 | 25µs | # spent 18µs (10+7) within Class::C3::Componentised::BEGIN@133 which was called:
# once (10µs+7µs) by base::import at line 133 # spent 18µs making 1 call to Class::C3::Componentised::BEGIN@133
# spent 7µs making 1 call to strict::unimport |
134 | |||||
135 | # ripped from Class::Inspector for speed | ||||
136 | # note that the order is important (faster items are first) | ||||
137 | 6544 | 22.9ms | return if ${"${f_class}::VERSION"}; | ||
138 | |||||
139 | 6544 | 43.8ms | return if @{"${f_class}::ISA"}; | ||
140 | |||||
141 | 192 | 834µs | my $file = (join ('/', split ('::', $f_class) ) ) . '.pm'; | ||
142 | 192 | 194µs | return if $INC{$file}; | ||
143 | |||||
144 | 192 | 506µs | for ( keys %{"${f_class}::"} ) { | ||
145 | 387 | 551µs | return if ( *{"${f_class}::$_"}{CODE} ); | ||
146 | } | ||||
147 | |||||
148 | # require always returns true on success | ||||
149 | # ill-behaved modules might very well obliterate $_ | ||||
150 | 576 | 135ms | eval { local $_; require($file) } or do { | ||
151 | |||||
152 | $@ = "Invalid class name '$f_class'" if $f_class =~ $invalid_class; | ||||
153 | |||||
154 | if ($class->can('throw_exception')) { | ||||
155 | $class->throw_exception($@); | ||||
156 | } else { | ||||
157 | Carp::croak $@; | ||||
158 | } | ||||
159 | }; | ||||
160 | |||||
161 | 192 | 704µs | return; | ||
162 | } | ||||
163 | |||||
164 | =head2 ensure_class_found | ||||
165 | |||||
166 | Returns true if the specified class is installed or already loaded, false | ||||
167 | otherwise. | ||||
168 | |||||
169 | Note that the underlying mechanism (Class::Inspector->installed()) used by this | ||||
170 | sub will not, at the time of writing, correctly function when @INC includes | ||||
171 | coderefs. Since PAR relies upon coderefs in @INC, this function should be | ||||
172 | avoided in modules that are likely to be included within a PAR. | ||||
173 | |||||
174 | =cut | ||||
175 | |||||
176 | sub ensure_class_found { | ||||
177 | #my ($class, $f_class) = @_; | ||||
178 | require Class::Inspector; | ||||
179 | return Class::Inspector->loaded($_[1]) || | ||||
180 | Class::Inspector->installed($_[1]); | ||||
181 | } | ||||
182 | |||||
183 | |||||
184 | =head2 inject_base | ||||
185 | |||||
186 | Does the actual magic of adjusting @ISA on the target module. | ||||
187 | |||||
188 | =cut | ||||
189 | |||||
190 | sub inject_base { | ||||
191 | 4 | 2µs | my $class = shift; | ||
192 | 4 | 1µs | my $target = shift; | ||
193 | |||||
194 | 4 | 2.74ms | 4 | 10µs | mro::set_mro($target, 'c3'); # spent 10µs making 4 calls to mro::set_mro, avg 3µs/call |
195 | |||||
196 | 4 | 7µs | for my $comp (reverse @_) { | ||
197 | 16 | 6µs | my $apply = do { | ||
198 | 2 | 289µs | 2 | 21µs | # spent 15µs (9+6) within Class::C3::Componentised::BEGIN@198 which was called:
# once (9µs+6µs) by base::import at line 198 # spent 15µs making 1 call to Class::C3::Componentised::BEGIN@198
# spent 6µs making 1 call to strict::unimport |
199 | 32 | 461µs | # spent 405µs within Class::C3::Componentised::__ANON__[/usr/share/perl5/Class/C3/Componentised.pm:199] which was called 16 times, avg 25µs/call:
# 16 times (405µs+0s) by DBIx::Class::Componentised::inject_base at line 208, avg 25µs/call | ||
200 | }; | ||||
201 | 16 | 243µs | 16 | 41µs | unless ($target eq $comp || $target->isa($comp)) { # spent 41µs making 16 calls to UNIVERSAL::isa, avg 3µs/call |
202 | 16 | 3µs | our %APPLICATOR_FOR; | ||
203 | 16 | 104µs | 32 | 68µs | if (my $apply_class # spent 40µs making 16 calls to List::Util::first, avg 3µs/call
# spent 28µs making 16 calls to mro::get_linear_isa, avg 2µs/call |
204 | 83 | 49µs | = List::Util::first { $APPLICATOR_FOR{$_} } @{mro::get_linear_isa($comp)} | ||
205 | ) { | ||||
206 | $APPLICATOR_FOR{$apply_class}->_apply_component_to_class($comp,$target,$apply); | ||||
207 | } else { | ||||
208 | 16 | 17µs | 16 | 405µs | $apply->(); # spent 405µs making 16 calls to Class::C3::Componentised::__ANON__[Class/C3/Componentised.pm:199], avg 25µs/call |
209 | } | ||||
210 | } | ||||
211 | } | ||||
212 | } | ||||
213 | |||||
214 | =head2 load_optional_class | ||||
215 | |||||
216 | Returns a true value if the specified class is installed and loaded | ||||
217 | successfully, throws an exception if the class is found but not loaded | ||||
218 | successfully, and false if the class is not installed | ||||
219 | |||||
220 | =cut | ||||
221 | |||||
222 | # spent 2.23ms (30µs+2.20) within Class::C3::Componentised::load_optional_class which was called:
# once (30µs+2.20ms) by DBIx::Class::Storage::DBI::_determine_driver at line 1264 of DBIx/Class/Storage/DBI.pm | ||||
223 | 1 | 1µs | my ($class, $f_class) = @_; | ||
224 | |||||
225 | # ensure_class_loaded either returns a () (*not* true) or throws | ||||
226 | 1 | 6µs | eval { | ||
227 | 1 | 23µs | 1 | 2.20ms | $class->ensure_class_loaded($f_class); # spent 2.20ms making 1 call to Class::C3::Componentised::ensure_class_loaded |
228 | 1 | 500ns | 1; | ||
229 | } && return 1; | ||||
230 | |||||
231 | my $err = $@; # so we don't lose it | ||||
232 | |||||
233 | if ($f_class =~ $invalid_class) { | ||||
234 | $err = "Invalid class name '$f_class'"; | ||||
235 | } | ||||
236 | else { | ||||
237 | my $fn = quotemeta( (join ('/', split ('::', $f_class) ) ) . '.pm' ); | ||||
238 | return 0 if ($err =~ /Can't locate ${fn} in \@INC/ ); | ||||
239 | } | ||||
240 | |||||
241 | if ($class->can('throw_exception')) { | ||||
242 | $class->throw_exception($err); | ||||
243 | } | ||||
244 | else { | ||||
245 | die $err; | ||||
246 | } | ||||
247 | } | ||||
248 | |||||
249 | =head1 AUTHORS | ||||
250 | |||||
251 | Matt S. Trout and the L<DBIx::Class team|DBIx::Class/CONTRIBUTORS> | ||||
252 | |||||
253 | Pulled out into separate module by Ash Berlin C<< <ash@cpan.org> >> | ||||
254 | |||||
255 | Optimizations and overall bolt-tightening by Peter "ribasushi" Rabbitson | ||||
256 | C<< <ribasushi@cpan.org> >> | ||||
257 | |||||
258 | =head1 COPYRIGHT | ||||
259 | |||||
260 | Copyright (c) 2006 - 2011 the Class::C3::Componentised L</AUTHORS> as listed | ||||
261 | above. | ||||
262 | |||||
263 | =head1 LICENSE | ||||
264 | |||||
265 | You may distribute this code under the same terms as Perl itself. | ||||
266 | |||||
267 | =cut | ||||
268 | |||||
269 | 1 | 5µs | 1; |