Profile of /usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Moose.pm

File	/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Moose.pm
Statements Executed	1459
Statement Execution Time	41.4ms

Subroutines — ordered by exclusive time
Calls	P	F	Exclusive Time	Inclusive Time	Subroutine
1	1	1	14.7ms	58.4ms	Moose::::BEGIN@18Moose::BEGIN@18
1	1	1	11.7ms	414ms	Moose::::BEGIN@14Moose::BEGIN@14
1	1	1	8.67ms	55.5ms	Moose::::BEGIN@26Moose::BEGIN@26
1	1	1	8.33ms	8.48ms	Moose::::BEGIN@3Moose::BEGIN@3
184	92	23	8.25ms	1.19s	Moose::::hasMoose::has
1	1	1	7.41ms	10.8ms	Moose::::BEGIN@29Moose::BEGIN@29
1	1	1	6.84ms	36.6ms	Moose::::BEGIN@19Moose::BEGIN@19
34	1	1	6.28ms	209ms	Moose::::init_metaMoose::init_meta
1	1	1	6.28ms	11.7ms	Moose::::BEGIN@11Moose::BEGIN@11
1	1	1	4.55ms	10.6ms	Moose::::BEGIN@30Moose::BEGIN@30
1	1	1	3.58ms	4.91ms	Moose::::BEGIN@31Moose::BEGIN@31
1	1	1	3.09ms	12.2ms	Moose::::BEGIN@24Moose::BEGIN@24
1	1	1	3.09ms	9.09ms	Moose::::BEGIN@37Moose::BEGIN@37
1	1	1	2.81ms	10.4ms	Moose::::BEGIN@27Moose::BEGIN@27
1	1	1	2.73ms	8.61ms	Moose::::BEGIN@28Moose::BEGIN@28
1	1	1	2.50ms	351ms	Moose::::BEGIN@20Moose::BEGIN@20
1	1	1	1.95ms	2.17ms	Moose::::BEGIN@2Moose::BEGIN@2
1	1	1	1.54ms	1.72ms	Moose::::BEGIN@12Moose::BEGIN@12
1	1	1	1.17ms	5.70ms	Moose::::BEGIN@32Moose::BEGIN@32
28	15	15	748µs	1.53s	Moose::::extendsMoose::extends
1	1	1	736µs	1.19ms	Moose::::BEGIN@22Moose::BEGIN@22
34	18	17	726µs	2.43s	Moose::::withMoose::with
24	13	9	509µs	36.8ms	Moose::::aroundMoose::around
8	4	3	181µs	12.3ms	Moose::::beforeMoose::before
1	1	1	170µs	170µs	Moose::::BEGIN@5Moose::BEGIN@5
1	1	1	78µs	78µs	Moose::::BEGIN@21Moose::BEGIN@21
2	2	2	56µs	2.52ms	Moose::::afterMoose::after
1	1	2	54µs	54µs	Moose::::bootstrapMoose::bootstrap (xsub)
1	1	1	40µs	87µs	Moose::::BEGIN@16Moose::BEGIN@16
1	1	1	33µs	8.12ms	Moose::::BEGIN@34Moose::BEGIN@34
1	1	1	19µs	19µs	Moose::::BEGIN@35Moose::BEGIN@35
0	0	0	0s	0s	Moose::::__ANON__[:221]Moose::__ANON__[:221]
0	0	0	0s	0s	Moose::::_get_callerMoose::_get_caller
0	0	0	0s	0s	Moose::::augmentMoose::augment
0	0	0	0s	0s	Moose::::innerMoose::inner
0	0	0	0s	0s	Moose::::overrideMoose::override
0	0	0	0s	0s	Moose::::superMoose::super
0	0	0	0s	0s	Moose::::throw_errorMoose::throw_error

Call graph for these subroutines as a Graphviz dot language file.

Line	State ments	Time on line	Calls	Time in subs	Code
1					package Moose;
2	3	1.87ms	2	2.18ms	# spent 2.17ms (1.95+220µs) within Moose::BEGIN@2 which was called # once (1.95ms+220µs) by Catalyst::Engine::HTTP::BEGIN@3 at line 2 use strict; # spent 2.17ms making 1 call to Moose::BEGIN@2 # spent 15µs making 1 call to strict::import
3	3	7.57ms	2	8.58ms	# spent 8.48ms (8.33+155µs) within Moose::BEGIN@3 which was called # once (8.33ms+155µs) by Catalyst::Engine::HTTP::BEGIN@3 at line 3 use warnings; # spent 8.48ms making 1 call to Moose::BEGIN@3 # spent 97µs making 1 call to warnings::import
4
5	3	467µs	1	170µs	# spent 170µs within Moose::BEGIN@5 which was called # once (170µs+0s) by Catalyst::Engine::HTTP::BEGIN@3 at line 5 use 5.008; # spent 170µs making 1 call to Moose::BEGIN@5
6
7	1	3µs			our $VERSION = '1.01';
8	1	52µs			$VERSION = eval $VERSION;
9	1	2µs			our $AUTHORITY = 'cpan:STEVAN';
10
11	3	673µs	2	12.1ms	# spent 11.7ms (6.28+5.46) within Moose::BEGIN@11 which was called # once (6.28ms+5.46ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 11 use Scalar::Util 'blessed'; # spent 11.7ms making 1 call to Moose::BEGIN@11 # spent 372µs making 1 call to Exporter::import
12	3	1.59ms	2	1.89ms	# spent 1.72ms (1.54+177µs) within Moose::BEGIN@12 which was called # once (1.54ms+177µs) by Catalyst::Engine::HTTP::BEGIN@3 at line 12 use Carp 'confess'; # spent 1.72ms making 1 call to Moose::BEGIN@12 # spent 177µs making 1 call to Exporter::import
13
14	3	435µs	2	414ms	# spent 414ms (11.7+402) within Moose::BEGIN@14 which was called # once (11.7ms+402ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 14 use Moose::Exporter; # spent 414ms making 1 call to Moose::BEGIN@14 # spent 98µs making 1 call to Moose::Exporter::import
15
16	3	320µs	2	134µs	# spent 87µs (40+47) within Moose::BEGIN@16 which was called # once (40µs+47µs) by Catalyst::Engine::HTTP::BEGIN@3 at line 16 use Class::MOP 0.94; # spent 87µs making 1 call to Moose::BEGIN@16 # spent 47µs making 1 call to UNIVERSAL::VERSION
17
18	3	864µs	1	58.4ms	# spent 58.4ms (14.7+43.7) within Moose::BEGIN@18 which was called # once (14.7ms+43.7ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 18 use Moose::Meta::Class; # spent 58.4ms making 1 call to Moose::BEGIN@18
19	3	641µs	1	36.6ms	# spent 36.6ms (6.84+29.8) within Moose::BEGIN@19 which was called # once (6.84ms+29.8ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 19 use Moose::Meta::TypeConstraint; # spent 36.6ms making 1 call to Moose::BEGIN@19
20	3	508µs	1	351ms	# spent 351ms (2.50+349) within Moose::BEGIN@20 which was called # once (2.50ms+349ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 20 use Moose::Meta::TypeCoercion; # spent 351ms making 1 call to Moose::BEGIN@20
21	3	84µs	1	78µs	# spent 78µs within Moose::BEGIN@21 which was called # once (78µs+0s) by Catalyst::Engine::HTTP::BEGIN@3 at line 21 use Moose::Meta::Attribute; # spent 78µs making 1 call to Moose::BEGIN@21
22	3	483µs	1	1.19ms	# spent 1.19ms (736µs+451µs) within Moose::BEGIN@22 which was called # once (736µs+451µs) by Catalyst::Engine::HTTP::BEGIN@3 at line 22 use Moose::Meta::Instance; # spent 1.19ms making 1 call to Moose::BEGIN@22
23
24	3	366µs	1	12.2ms	# spent 12.2ms (3.09+9.11) within Moose::BEGIN@24 which was called # once (3.09ms+9.11ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 24 use Moose::Object; # spent 12.2ms making 1 call to Moose::BEGIN@24
25
26	3	928µs	1	55.5ms	# spent 55.5ms (8.67+46.9) within Moose::BEGIN@26 which was called # once (8.67ms+46.9ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 26 use Moose::Meta::Role; # spent 55.5ms making 1 call to Moose::BEGIN@26
27	3	474µs	1	10.4ms	# spent 10.4ms (2.81+7.63) within Moose::BEGIN@27 which was called # once (2.81ms+7.63ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 27 use Moose::Meta::Role::Composite; # spent 10.4ms making 1 call to Moose::BEGIN@27
28	3	462µs	1	8.61ms	# spent 8.61ms (2.73+5.89) within Moose::BEGIN@28 which was called # once (2.73ms+5.89ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 28 use Moose::Meta::Role::Application; # spent 8.61ms making 1 call to Moose::BEGIN@28
29	3	517µs	1	10.8ms	# spent 10.8ms (7.41+3.41) within Moose::BEGIN@29 which was called # once (7.41ms+3.41ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 29 use Moose::Meta::Role::Application::RoleSummation; # spent 10.8ms making 1 call to Moose::BEGIN@29
30	3	362µs	1	10.6ms	# spent 10.6ms (4.55+6.03) within Moose::BEGIN@30 which was called # once (4.55ms+6.03ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 30 use Moose::Meta::Role::Application::ToClass; # spent 10.6ms making 1 call to Moose::BEGIN@30
31	3	476µs	1	4.91ms	# spent 4.91ms (3.58+1.33) within Moose::BEGIN@31 which was called # once (3.58ms+1.33ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 31 use Moose::Meta::Role::Application::ToRole; # spent 4.91ms making 1 call to Moose::BEGIN@31
32	3	375µs	1	5.70ms	# spent 5.70ms (1.17+4.53) within Moose::BEGIN@32 which was called # once (1.17ms+4.53ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 32 use Moose::Meta::Role::Application::ToInstance; # spent 5.70ms making 1 call to Moose::BEGIN@32
33
34	3	107µs	2	16.2ms	# spent 8.12ms (33µs+8.09) within Moose::BEGIN@34 which was called # once (33µs+8.09ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 34 use Moose::Util::TypeConstraints; # spent 8.12ms making 1 call to Moose::BEGIN@34 # spent 8.09ms making 1 call to Moose::Exporter::__ANON__[Moose/Exporter.pm:389]
35	3	76µs	1	19µs	# spent 19µs within Moose::BEGIN@35 which was called # once (19µs+0s) by Catalyst::Engine::HTTP::BEGIN@3 at line 35 use Moose::Util (); # spent 19µs making 1 call to Moose::BEGIN@35
36
37	3	6.22ms	1	9.09ms	# spent 9.09ms (3.09+6.01) within Moose::BEGIN@37 which was called # once (3.09ms+6.01ms) by Catalyst::Engine::HTTP::BEGIN@3 at line 37 use Moose::Meta::Attribute::Native; # spent 9.09ms making 1 call to Moose::BEGIN@37
38
39					sub throw_error {
40					# FIXME This
41					shift;
42					goto \&confess
43					}
44
45					# spent 1.53s (748µs+1.53) within Moose::extends which was called 28 times, avg 54.8ms/call: # 14 times (344µs+665ms) by Moose::extends at line 293 of Moose/Exporter.pm, avg 47.5ms/call # once (86µs+365ms) by Catalyst::Controller::BEGIN@8 at line 8 of Catalyst/Controller.pm # once (21µs+223ms) by main::BEGIN@6 at line 4 of Catalyst/Engine/HTTP.pm # once (26µs+201ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 4 of Catalyst/Engine/CGI.pm # once (32µs+60.1ms) by Catalyst::Dispatcher::BEGIN@11 at line 4 of Catalyst/DispatchType/Default.pm # once (28µs+6.78ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 5 of Catalyst/Plugin/Session/State/Cookie.pm # once (27µs+2.03ms) by Catalyst::Exception::BEGIN@63 at line 64 of Catalyst/Exception.pm # once (28µs+1.89ms) by Catalyst::Dispatcher::BEGIN@12 at line 4 of Catalyst/DispatchType/Index.pm # once (29µs+1.85ms) by base::import at line 4 of Catalyst/Model.pm # once (33µs+1.71ms) by base::import at line 4 of Catalyst/View.pm # once (28µs+1.37ms) by Catalyst::Plugin::ConfigLoader::BEGIN@8 at line 18 of Data/Visitor/Callback.pm # once (18µs+1.23ms) by MooseX::Emulate::Class::Accessor::Fast::BEGIN@7 at line 5 of MooseX/Emulate/Class/Accessor/Fast/Meta/Accessor.pm # once (16µs+858µs) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 4 of Catalyst/DispatchType/Regex.pm # once (16µs+840µs) by Epoll::BEGIN@17 at line 5 of Catalyst.pm # once (16µs+824µs) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 4 of Catalyst/DispatchType/Path.pm sub extends {
46	14	29µs			my $meta = shift;
47
48	14	22µs			Moose->throw_error("Must derive at least one class") unless @_;
49
50					# this checks the metaclass to make sure
51					# it is correct, sometimes it can get out
52					# of sync when the classes are being built
53	14	286µs	14	665ms	$meta->superclasses(@_); # spent 867ms making 14 calls to Moose::Meta::Class::superclasses, avg 61.9ms/call, recursion: max depth 2, time 202ms
54					}
55
56					# spent 2.43s (726µs+2.43) within Moose::with which was called 34 times, avg 71.6ms/call: # 17 times (267µs+1.22s) by Moose::with at line 293 of Moose/Exporter.pm, avg 71.6ms/call # once (30µs+692ms) by Catalyst::BEGIN@8 at line 50 of Catalyst/Exception.pm # once (23µs+55.2ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 4 of Catalyst/Engine.pm # once (28µs+54.1ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 13 of MooseX/MethodAttributes/Inheritable.pm # once (33µs+51.4ms) by Catalyst::BEGIN@13 at line 4 of Catalyst/Request/Upload.pm # once (25µs+46.8ms) by Catalyst::BEGIN@9 at line 6 of Catalyst/Exception/Detach.pm # once (45µs+38.2ms) by Catalyst::BEGIN@14 at line 6 of Catalyst/Response.pm # once (28µs+34.6ms) by Catalyst::Dispatcher::BEGIN@9 at line 24 of Catalyst/Action.pm # once (30µs+33.8ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 14 of Catalyst/Component.pm # once (30µs+33.2ms) by Catalyst::Dispatcher::BEGIN@10 at line 19 of Catalyst/ActionContainer.pm # once (29µs+32.7ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 4 of Catalyst/DispatchType.pm # once (32µs+31.8ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 6 of Catalyst/Plugin/Session.pm # once (21µs+24.8ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 5 of Catalyst/Dispatcher.pm # once (30µs+24.0ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 15 of Catalyst/Component.pm # once (16µs+20.1ms) by Catalyst::BEGIN@10 at line 6 of Catalyst/Exception/Go.pm # once (27µs+16.2ms) by Catalyst::BEGIN@16 at line 14 of Catalyst/Controller.pm # once (16µs+14.4ms) by Catalyst::BEGIN@12 at line 15 of Catalyst/Request.pm # once (16µs+14.4ms) by Catalyst::BEGIN@11 at line 4 of Catalyst/Log.pm sub with {
57	17	223µs	17	1.22s	Moose::Util::apply_all_roles(shift, @_); # spent 1.22s making 17 calls to Moose::Util::apply_all_roles, avg 71.5ms/call
58					}
59
60					# spent 1.19s (8.25ms+1.18) within Moose::has which was called 184 times, avg 6.45ms/call: # 92 times (5.40ms+584ms) by Moose::has at line 293 of Moose/Exporter.pm, avg 6.41ms/call # 2 times (63µs+24.0ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 42 of Catalyst/Dispatcher.pm, avg 12.0ms/call # once (38µs+13.8ms) by Catalyst::BEGIN@13 at line 12 of Catalyst/Request/Upload.pm # once (35µs+13.7ms) by Catalyst::BEGIN@13 at line 11 of Catalyst/Request/Upload.pm # once (33µs+12.6ms) by Catalyst::BEGIN@14 at line 9 of Catalyst/Response.pm # once (30µs+12.2ms) by Catalyst::BEGIN@14 at line 24 of Catalyst/Response.pm # once (29µs+11.6ms) by Catalyst::BEGIN@12 at line 105 of Catalyst/Request.pm # once (29µs+11.5ms) by Catalyst::BEGIN@14 at line 27 of Catalyst/Response.pm # once (28µs+10.7ms) by Catalyst::BEGIN@12 at line 127 of Catalyst/Request.pm # once (24µs+10.2ms) by Catalyst::BEGIN@12 at line 64 of Catalyst/Request.pm # once (28µs+10.1ms) by Catalyst::BEGIN@13 at line 16 of Catalyst/Request/Upload.pm # once (139µs+9.92ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 16 of Catalyst/Engine.pm # once (27µs+9.50ms) by main::BEGIN@6 at line 21 of Catalyst/Engine/HTTP.pm # once (29µs+9.37ms) by main::BEGIN@6 at line 22 of Catalyst/Engine/HTTP.pm # once (86µs+9.24ms) by Catalyst::Utils::ensure_class_loaded at line 17 of Catalyst/Stats.pm # once (29µs+8.84ms) by Catalyst::BEGIN@12 at line 131 of Catalyst/Request.pm # once (27µs+8.66ms) by Catalyst::BEGIN@12 at line 103 of Catalyst/Request.pm # once (16µs+8.54ms) by Catalyst::BEGIN@12 at line 35 of Catalyst/Request.pm # once (17µs+8.48ms) by Catalyst::BEGIN@9 at line 8 of Catalyst/Exception/Detach.pm # once (30µs+8.22ms) by Catalyst::BEGIN@12 at line 125 of Catalyst/Request.pm # once (30µs+8.21ms) by Catalyst::Dispatcher::BEGIN@10 at line 21 of Catalyst/ActionContainer.pm # once (28µs+8.20ms) by Catalyst::Dispatcher::BEGIN@9 at line 27 of Catalyst/Action.pm # once (30µs+8.14ms) by Data::Visitor::Callback::BEGIN@6 at line 21 of Data/Visitor.pm # once (27µs+8.08ms) by Catalyst::Plugin::ConfigLoader::BEGIN@8 at line 30 of Data/Visitor/Callback.pm # once (81µs+7.75ms) by Catalyst::Dispatcher::BEGIN@12 at line 32 of Catalyst/DispatchType/Index.pm # once (29µs+7.71ms) by Catalyst::BEGIN@13 at line 34 of Catalyst/Request/Upload.pm # once (27µs+7.68ms) by Catalyst::Plugin::ConfigLoader::BEGIN@8 at line 32 of Data/Visitor/Callback.pm # once (26µs+7.54ms) by main::BEGIN@6 at line 20 of Catalyst/Engine/HTTP.pm # once (18µs+7.54ms) by Catalyst::BEGIN@10 at line 8 of Catalyst/Exception/Go.pm # once (28µs+7.47ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 36 of Catalyst/Dispatcher.pm # once (29µs+7.47ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 35 of Catalyst/Dispatcher.pm # once (30µs+7.37ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 33 of Catalyst/Dispatcher.pm # once (34µs+7.37ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 64 of Catalyst/Component.pm # once (29µs+7.37ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 32 of Catalyst/Dispatcher.pm # once (29µs+7.36ms) by Catalyst::Plugin::ConfigLoader::BEGIN@8 at line 24 of Data/Visitor/Callback.pm # once (30µs+7.25ms) by Catalyst::Utils::ensure_class_loaded at line 12 of Catalyst/Stats.pm # once (32µs+7.20ms) by Catalyst::BEGIN@14 at line 8 of Catalyst/Response.pm # once (29µs+7.13ms) by Catalyst::BEGIN@13 at line 14 of Catalyst/Request/Upload.pm # once (30µs+7.09ms) by Catalyst::BEGIN@13 at line 13 of Catalyst/Request/Upload.pm # once (29µs+7.02ms) by Catalyst::Utils::ensure_class_loaded at line 24 of Catalyst/Stats.pm # once (29µs+6.99ms) by Catalyst::Dispatcher::BEGIN@9 at line 39 of Catalyst/Action.pm # once (28µs+6.91ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 34 of Catalyst/Dispatcher.pm # once (31µs+6.88ms) by Catalyst::Dispatcher::BEGIN@10 at line 22 of Catalyst/ActionContainer.pm # once (28µs+6.84ms) by Catalyst::BEGIN@14 at line 17 of Catalyst/Response.pm # once (15µs+6.83ms) by Catalyst::BEGIN@16 at line 24 of Catalyst/Controller.pm # once (26µs+6.69ms) by Catalyst::BEGIN@13 at line 15 of Catalyst/Request/Upload.pm # once (29µs+6.63ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 31 of Catalyst/Dispatcher.pm # once (33µs+6.62ms) by Catalyst::BEGIN@14 at line 18 of Catalyst/Response.pm # once (26µs+6.59ms) by Catalyst::Dispatcher::BEGIN@9 at line 32 of Catalyst/Action.pm # once (31µs+6.51ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 12 of Catalyst/Plugin/Session/State/Cookie.pm # once (87µs+6.39ms) by Data::Visitor::Callback::BEGIN@6 at line 27 of Data/Visitor.pm # once (30µs+6.36ms) by Catalyst::BEGIN@14 at line 19 of Catalyst/Response.pm # once (26µs+6.31ms) by Catalyst::Dispatcher::BEGIN@9 at line 29 of Catalyst/Action.pm # once (28µs+6.30ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 19 of Catalyst/Engine.pm # once (27µs+6.23ms) by Catalyst::Dispatcher::BEGIN@9 at line 28 of Catalyst/Action.pm # once (27µs+6.15ms) by Catalyst::Dispatcher::BEGIN@9 at line 30 of Catalyst/Action.pm # once (26µs+6.06ms) by Catalyst::Dispatcher::BEGIN@9 at line 31 of Catalyst/Action.pm # once (56µs+5.93ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 6 of Catalyst/Engine/CGI.pm # once (16µs+5.32ms) by Catalyst::BEGIN@12 at line 39 of Catalyst/Request.pm # once (16µs+5.11ms) by Catalyst::BEGIN@12 at line 57 of Catalyst/Request.pm # once (15µs+4.18ms) by Catalyst::BEGIN@16 at line 16 of Catalyst/Controller.pm # once (23µs+3.91ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 20 of Catalyst/Engine.pm # once (15µs+3.86ms) by Catalyst::BEGIN@12 at line 28 of Catalyst/Request.pm # once (15µs+3.84ms) by Catalyst::BEGIN@12 at line 29 of Catalyst/Request.pm # once (16µs+3.80ms) by Catalyst::BEGIN@12 at line 27 of Catalyst/Request.pm # once (78µs+3.71ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 15 of Catalyst/DispatchType/Path.pm # once (14µs+3.75ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 15 of Catalyst/DispatchType/Regex.pm # once (15µs+3.59ms) by Epoll::BEGIN@17 at line 42 of Catalyst.pm # once (46µs+3.38ms) by Catalyst::BEGIN@12 at line 17 of Catalyst/Request.pm # once (14µs+3.40ms) by Catalyst::BEGIN@12 at line 51 of Catalyst/Request.pm # once (14µs+3.36ms) by Catalyst::BEGIN@16 at line 32 of Catalyst/Controller.pm # once (16µs+3.31ms) by Catalyst::BEGIN@12 at line 25 of Catalyst/Request.pm # once (14µs+3.25ms) by Epoll::BEGIN@17 at line 43 of Catalyst.pm # once (14µs+3.23ms) by Epoll::BEGIN@17 at line 38 of Catalyst.pm # once (14µs+3.14ms) by Catalyst::BEGIN@12 at line 18 of Catalyst/Request.pm # once (52µs+3.10ms) by Catalyst::BEGIN@12 at line 26 of Catalyst/Request.pm # once (15µs+3.13ms) by Epoll::BEGIN@17 at line 44 of Catalyst.pm # once (13µs+3.09ms) by Epoll::BEGIN@17 at line 37 of Catalyst.pm # once (14µs+3.08ms) by Catalyst::BEGIN@12 at line 24 of Catalyst/Request.pm # once (48µs+3.03ms) by Catalyst::BEGIN@12 at line 21 of Catalyst/Request.pm # once (15µs+3.02ms) by Catalyst::BEGIN@12 at line 20 of Catalyst/Request.pm # once (13µs+3.01ms) by Epoll::BEGIN@17 at line 40 of Catalyst.pm # once (107µs+2.90ms) by Catalyst::BEGIN@11 at line 13 of Catalyst/Log.pm # once (15µs+3.00ms) by Catalyst::BEGIN@12 at line 19 of Catalyst/Request.pm # once (15µs+2.96ms) by Catalyst::BEGIN@11 at line 12 of Catalyst/Log.pm # once (14µs+2.95ms) by Catalyst::BEGIN@12 at line 23 of Catalyst/Request.pm # once (13µs+2.89ms) by Catalyst::BEGIN@11 at line 14 of Catalyst/Log.pm # once (14µs+2.84ms) by Catalyst::BEGIN@12 at line 22 of Catalyst/Request.pm # once (100µs+2.75ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 22 of Catalyst/Engine.pm # once (15µs+2.81ms) by Epoll::BEGIN@17 at line 36 of Catalyst.pm # once (67µs+2.71ms) by Epoll::BEGIN@17 at line 41 of Catalyst.pm # once (13µs+2.66ms) by Epoll::BEGIN@17 at line 39 of Catalyst.pm sub has {
61	92	152µs			my $meta = shift;
62	92	154µs			my $name = shift;
63
64	92	331µs			Moose->throw_error('Usage: has \'name\' => ( key => value, ... )')
65					if @_ % 2 == 1;
66
67	92	1.22ms	92	3.14ms	my %options = ( definition_context => Moose::Util::_caller_info(), @_ ); # spent 3.14ms making 92 calls to Moose::Util::_caller_info, avg 34µs/call
68	92	396µs			my $attrs = ( ref($name) eq 'ARRAY' ) ? $name : [ ($name) ];
69	184	2.68ms	92	581ms	$meta->add_attribute( $_, %options ) for @$attrs; # spent 581ms making 92 calls to Moose::Meta::Class::add_attribute, avg 6.32ms/call
70					}
71
72					# spent 12.3ms (181µs+12.1) within Moose::before which was called 8 times, avg 1.53ms/call: # 4 times (62µs+5.93ms) by Moose::before at line 293 of Moose/Exporter.pm, avg 1.50ms/call # 2 times (57µs+2.44ms) by Catalyst::BEGIN@12 at line 78 of Catalyst/Request.pm, avg 1.25ms/call # once (24µs+1.92ms) by main::BEGIN@6 at line 106 of Catalyst/Engine/HTTP.pm # once (37µs+1.80ms) by main::BEGIN@6 at line 97 of Catalyst/Engine/HTTP.pm sub before {
73	4	61µs	4	5.93ms	Moose::Util::add_method_modifier(shift, 'before', \@_); # spent 5.93ms making 4 calls to Moose::Util::add_method_modifier, avg 1.48ms/call
74					}
75
76					# spent 2.52ms (56µs+2.46) within Moose::after which was called 2 times, avg 1.26ms/call: # once (36µs+1.26ms) by Catalyst::BEGIN@14 at line 16 of Catalyst/Response.pm # once (20µs+1.20ms) by Moose::after at line 293 of Moose/Exporter.pm sub after {
77	1	18µs	1	1.20ms	Moose::Util::add_method_modifier(shift, 'after', \@_); # spent 1.20ms making 1 call to Moose::Util::add_method_modifier
78					}
79
80					# spent 36.8ms (509µs+36.3) within Moose::around which was called 24 times, avg 1.54ms/call: # 12 times (144µs+17.9ms) by Moose::around at line 293 of Moose/Exporter.pm, avg 1.50ms/call # once (15µs+4.05ms) by Catalyst::BEGIN@16 at line 166 of Catalyst/Controller.pm # once (14µs+2.52ms) by Catalyst::BEGIN@16 at line 180 of Catalyst/Controller.pm # once (81µs+1.67ms) by main::BEGIN@6 at line 163 of Catalyst/Engine/HTTP.pm # once (21µs+1.55ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 263 of Catalyst/Engine/CGI.pm # once (89µs+1.42ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 74 of Catalyst/Component.pm # once (28µs+1.42ms) by Catalyst::Dispatcher::BEGIN@10 at line 28 of Catalyst/ActionContainer.pm # once (19µs+1.42ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 245 of Catalyst/Engine/CGI.pm # once (26µs+1.17ms) by Class::MOP::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Class/MOP.pm:103] at line 222 of Catalyst/Engine/CGI.pm # once (12µs+941µs) by Epoll::BEGIN@17 at line 917 of Catalyst.pm # once (30µs+787µs) by Catalyst::BEGIN@12 at line 93 of Catalyst/Request.pm # once (14µs+801µs) by Epoll::BEGIN@17 at line 474 of Catalyst.pm # once (17µs+688µs) by Catalyst::BEGIN@11 at line 54 of Catalyst/Log.pm sub around {
81	12	129µs	12	17.9ms	Moose::Util::add_method_modifier(shift, 'around', \@_); # spent 17.9ms making 12 calls to Moose::Util::add_method_modifier, avg 1.49ms/call
82					}
83
84	1	1µs			our $SUPER_PACKAGE;
85	1	1µs			our $SUPER_BODY;
86	1	2µs			our @SUPER_ARGS;
87
88					sub super {
89					# This check avoids a recursion loop - see
90					# t/100_bugs/020_super_recursion.t
91					return if defined $SUPER_PACKAGE && $SUPER_PACKAGE ne caller();
92					return unless $SUPER_BODY; $SUPER_BODY->(@SUPER_ARGS);
93					}
94
95					sub override {
96					my $meta = shift;
97					my ( $name, $method ) = @_;
98					$meta->add_override_method_modifier( $name => $method );
99					}
100
101					sub inner {
102					my $pkg = caller();
103					our ( %INNER_BODY, %INNER_ARGS );
104
105					if ( my $body = $INNER_BODY{$pkg} ) {
106					my @args = @{ $INNER_ARGS{$pkg} };
107					local $INNER_ARGS{$pkg};
108					local $INNER_BODY{$pkg};
109					return $body->(@args);
110					} else {
111					return;
112					}
113					}
114
115					sub augment {
116					my $meta = shift;
117					my ( $name, $method ) = @_;
118					$meta->add_augment_method_modifier( $name => $method );
119					}
120
121	1	24µs	1	4.34ms	Moose::Exporter->setup_import_methods( # spent 4.34ms making 1 call to Moose::Exporter::setup_import_methods
122					with_meta => [
123					qw( extends with has before after around override augment )
124					],
125					as_is => [
126					qw( super inner ),
127					\&Carp::confess,
128					\&Scalar::Util::blessed,
129					],
130					);
131
132					# spent 209ms (6.28+203) within Moose::init_meta which was called 34 times, avg 6.14ms/call: # 34 times (6.28ms+203ms) by Moose::Exporter::__ANON__[/usr/lib/perl5/vendor_perl/5.10.1/i386-linux-thread-multi/Moose/Exporter.pm:389] at line 354 of Moose/Exporter.pm, avg 6.14ms/call sub init_meta {
133					# This used to be called as a function. This hack preserves
134					# backwards compatibility.
135	34	78µs			if ( $_[0] ne __PACKAGE__ ) {
136					return __PACKAGE__->init_meta(
137					for_class => $_[0],
138					base_class => $_[1],
139					metaclass => $_[2],
140					);
141					}
142
143	34	54µs			shift;
144	34	198µs			my %args = @_;
145
146	34	91µs			my $class = $args{for_class}
147					or Moose->throw_error("Cannot call init_meta without specifying a for_class");
148	34	68µs			my $base_class = $args{base_class} \|\| 'Moose::Object';
149	34	80µs			my $metaclass = $args{metaclass} \|\| 'Moose::Meta::Class';
150
151	34	812µs	34	355µs	Moose->throw_error("The Metaclass $metaclass must be a subclass of Moose::Meta::Class.") # spent 355µs making 34 calls to UNIVERSAL::isa, avg 10µs/call
152					unless $metaclass->isa('Moose::Meta::Class');
153
154					# make a subtype for each Moose class
155	34	586µs	68	31.7ms	class_type($class) # spent 28.2ms making 33 calls to Moose::Util::TypeConstraints::class_type, avg 855µs/call # spent 3.42ms making 34 calls to Moose::Util::TypeConstraints::find_type_constraint, avg 100µs/call # spent 18µs making 1 call to Moose::Meta::TypeConstraint::__ANON__[Moose/Meta/TypeConstraint.pm:8]
156					unless find_type_constraint($class);
157
158	34	44µs			my $meta;
159
160	34	507µs	34	416µs	if ( $meta = Class::MOP::get_metaclass_by_name($class) ) { # spent 416µs making 34 calls to Class::MOP::get_metaclass_by_name, avg 12µs/call
161	1	8µs	1	2µs	unless ( $meta->isa("Moose::Meta::Class") ) { # spent 2µs making 1 call to UNIVERSAL::isa
162					my $error_message = "$class already has a metaclass, but it does not inherit $metaclass ($meta).";
163					if ( $meta->isa('Moose::Meta::Role') ) {
164					Moose->throw_error($error_message . ' You cannot make the same thing a role and a class. Remove either Moose or Moose::Role.');
165					} else {
166					Moose->throw_error($error_message);
167					}
168					}
169					} else {
170					# no metaclass, no 'meta' method
171
172					# now we check whether our ancestors have metaclass, and if so borrow that
173	33	1.14ms	33	388µs	my ( undef, @isa ) = @{ $class->mro::get_linear_isa }; # spent 388µs making 33 calls to mro::get_linear_isa, avg 12µs/call
174
175	33	154µs			foreach my $ancestor ( @isa ) {
176					my $ancestor_meta = Class::MOP::get_metaclass_by_name($ancestor) \|\| next;
177
178					my $ancestor_meta_class = ($ancestor_meta->is_immutable
179					? $ancestor_meta->_get_mutable_metaclass_name
180					: ref($ancestor_meta));
181
182					# if we have an ancestor metaclass that inherits $metaclass, we use
183					# that. This is like _fix_metaclass_incompatibility, but we can do it now.
184
185					# the case of having an ancestry is not very common, but arises in
186					# e.g. Reaction
187					unless ( $metaclass->isa( $ancestor_meta_class ) ) {
188					if ( $ancestor_meta_class->isa($metaclass) ) {
189					$metaclass = $ancestor_meta_class;
190					}
191					}
192					}
193
194	33	361µs	33	119ms	$meta = $metaclass->initialize($class); # spent 119ms making 33 calls to Moose::Meta::Class::initialize, avg 3.60ms/call
195					}
196
197	34	878µs	34	325µs	if ( $class->can('meta') ) { # spent 325µs making 34 calls to UNIVERSAL::can, avg 10µs/call
198					# check 'meta' method
199
200					# it may be inherited
201
202					# NOTE:
203					# this is the case where the metaclass pragma
204					# was used before the 'use Moose' statement to
205					# override a specific class
206	1	4µs	1	22µs	my $method_meta = $class->meta; # spent 22µs making 1 call to Catalyst::Dispatcher::meta
207
208	1	14µs	2	5µs	( blessed($method_meta) && $method_meta->isa('Moose::Meta::Class') ) # spent 3µs making 1 call to Scalar::Util::blessed # spent 2µs making 1 call to UNIVERSAL::isa
209					\|\| Moose->throw_error("$class already has a &meta function, but it does not return a Moose::Meta::Class ($method_meta)");
210
211	1	1µs			$meta = $method_meta;
212					}
213
214	34	1.06ms	67	11.4ms	unless ( $meta->has_method("meta") ) { # don't overwrite # spent 6.30ms making 33 calls to Class::MOP::Mixin::HasMethods::add_method, avg 191µs/call # spent 5.13ms making 34 calls to Class::MOP::Mixin::HasMethods::has_method, avg 151µs/call
215					# also check for inherited non moose 'meta' method?
216					# FIXME also skip this if the user requested by passing an option
217					$meta->add_method(
218					'meta' => sub {
219					# re-initialize so it inherits properly
220	36	1.43ms	36	1.01ms	$metaclass->initialize( ref($_[0]) \|\| $_[0] ); # spent 1.01ms making 36 calls to Moose::Meta::Class::initialize, avg 28µs/call
221					}
222					);
223					}
224
225					# make sure they inherit from Moose::Object
226	34	566µs	67	32.4ms	$meta->superclasses($base_class) # spent 39.3ms making 67 calls to Moose::Meta::Class::superclasses, avg 587µs/call, recursion: max depth 2, time 6.91ms
227					unless $meta->superclasses();
228
229	34	374µs			return $meta;
230					}
231
232					# This may be used in some older MooseX extensions.
233					sub _get_caller {
234					goto &Moose::Exporter::_get_caller;
235					}
236
237					## make 'em all immutable
238
239	22	147µs	22	106µs	$_->make_immutable( # spent 106µs making 22 calls to Class::MOP::Class::is_mutable, avg 5µs/call
240					inline_constructor => 1,
241					constructor_name => "_new",
242					# these are Class::MOP accessors, so they need inlining
243					inline_accessors => 1
244	23	962µs	44	246ms	) for grep { $_->is_mutable } # spent 244ms making 22 calls to Class::MOP::Class::make_immutable, avg 11.1ms/call # spent 2.06ms making 10 calls to Class::MOP::Object::meta, avg 206µs/call # spent 157µs making 1 call to Moose::Meta::TypeCoercion::Union::meta # spent 117µs making 2 calls to Moose::Meta::Role::Method::Required::meta, avg 59µs/call # spent 64µs making 1 call to Moose::Meta::Role::Application::ToClass::meta # spent 61µs making 1 call to Moose::Meta::Role::Application::ToRole::meta # spent 59µs making 1 call to Moose::Meta::Role::Application::meta # spent 57µs making 1 call to Moose::Meta::TypeCoercion::meta # spent 56µs making 1 call to Moose::Meta::Role::meta # spent 54µs making 1 call to Moose::Meta::Role::Application::RoleSummation::meta # spent 53µs making 1 call to Class::MOP::Mixin::meta # spent 53µs making 1 call to Moose::Meta::Role::Composite::meta # spent 52µs making 1 call to Moose::Meta::Role::Application::ToInstance::meta
245					map { $_->meta }
246					qw(
247					Moose::Meta::Attribute
248					Moose::Meta::Class
249					Moose::Meta::Instance
250
251					Moose::Meta::TypeCoercion
252					Moose::Meta::TypeCoercion::Union
253
254					Moose::Meta::Method
255					Moose::Meta::Method::Accessor
256					Moose::Meta::Method::Constructor
257					Moose::Meta::Method::Destructor
258					Moose::Meta::Method::Overridden
259					Moose::Meta::Method::Augmented
260
261					Moose::Meta::Role
262					Moose::Meta::Role::Attribute
263					Moose::Meta::Role::Method
264					Moose::Meta::Role::Method::Required
265					Moose::Meta::Role::Method::Conflicting
266
267					Moose::Meta::Role::Composite
268
269					Moose::Meta::Role::Application
270					Moose::Meta::Role::Application::RoleSummation
271					Moose::Meta::Role::Application::ToClass
272					Moose::Meta::Role::Application::ToRole
273					Moose::Meta::Role::Application::ToInstance
274	1	1µs			);
275
276	1	18µs	2	34.8ms	Moose::Meta::Mixin::AttributeCore->meta->make_immutable( # spent 34.8ms making 1 call to Class::MOP::Class::make_immutable # spent 60µs making 1 call to Class::MOP::Mixin::meta
277					inline_constructor => 0,
278					constructor_name => undef,
279					);
280
281	1	126µs			1;
282
283					__END__
284
285					=pod
286
287					=head1 NAME
288
289					Moose - A postmodern object system for Perl 5
290
291					=head1 SYNOPSIS
292
293					package Point;
294					use Moose; # automatically turns on strict and warnings
295
296					has 'x' => (is => 'rw', isa => 'Int');
297					has 'y' => (is => 'rw', isa => 'Int');
298
299					sub clear {
300					my $self = shift;
301					$self->x(0);
302					$self->y(0);
303					}
304
305					package Point3D;
306					use Moose;
307
308					extends 'Point';
309
310					has 'z' => (is => 'rw', isa => 'Int');
311
312					after 'clear' => sub {
313					my $self = shift;
314					$self->z(0);
315					};
316
317					=head1 DESCRIPTION
318
319					Moose is an extension of the Perl 5 object system.
320
321					The main goal of Moose is to make Perl 5 Object Oriented programming
322					easier, more consistent and less tedious. With Moose you can to think
323					more about what you want to do and less about the mechanics of OOP.
324
325					Additionally, Moose is built on top of L<Class::MOP>, which is a
326					metaclass system for Perl 5. This means that Moose not only makes
327					building normal Perl 5 objects better, but it provides the power of
328					metaclass programming as well.
329
330					=head2 New to Moose?
331
332					If you're new to Moose, the best place to start is the
333					L<Moose::Manual> docs, followed by the L<Moose::Cookbook>. The intro
334					will show you what Moose is, and how it makes Perl 5 OO better.
335
336					The cookbook recipes on Moose basics will get you up to speed with
337					many of Moose's features quickly. Once you have an idea of what Moose
338					can do, you can use the API documentation to get more detail on
339					features which interest you.
340
341					=head2 Moose Extensions
342
343					The C<MooseX::> namespace is the official place to find Moose extensions.
344					These extensions can be found on the CPAN. The easiest way to find them
345					is to search for them (L<http://search.cpan.org/search?query=MooseX::>),
346					or to examine L<Task::Moose> which aims to keep an up-to-date, easily
347					installable list of Moose extensions.
348
349					=head1 TRANSLATIONS
350
351					Much of the Moose documentation has been translated into other languages.
352
353					=over 4
354
355					=item Japanese
356
357					Japanese docs can be found at L<http://perldoc.perlassociation.org/pod/Moose-Doc-JA/index.html>. The source POD files can be found in GitHub: L<http://github.com/jpa/Moose-Doc-JA>
358
359					=back
360
361					=head1 BUILDING CLASSES WITH MOOSE
362
363					Moose makes every attempt to provide as much convenience as possible during
364					class construction/definition, but still stay out of your way if you want it
365					to. Here are a few items to note when building classes with Moose.
366
367					Unless specified with C<extends>, any class which uses Moose will
368					inherit from L<Moose::Object>.
369
370					Moose will also manage all attributes (including inherited ones) that are
371					defined with C<has>. And (assuming you call C<new>, which is inherited from
372					L<Moose::Object>) this includes properly initializing all instance slots,
373					setting defaults where appropriate, and performing any type constraint checking
374					or coercion.
375
376					=head1 PROVIDED METHODS
377
378					Moose provides a number of methods to all your classes, mostly through the
379					inheritance of L<Moose::Object>. There is however, one exception.
380
381					=over 4
382
383					=item B<meta>
384
385					This is a method which provides access to the current class's metaclass.
386
387					=back
388
389					=head1 EXPORTED FUNCTIONS
390
391					Moose will export a number of functions into the class's namespace which
392					may then be used to set up the class. These functions all work directly
393					on the current class.
394
395					=over 4
396
397					=item B<extends (@superclasses)>
398
399					This function will set the superclass(es) for the current class.
400
401					This approach is recommended instead of C<use base>, because C<use base>
402					actually C<push>es onto the class's C<@ISA>, whereas C<extends> will
403					replace it. This is important to ensure that classes which do not have
404					superclasses still properly inherit from L<Moose::Object>.
405
406					=item B<with (@roles)>
407
408					This will apply a given set of C<@roles> to the local class.
409
410					=item B<has $name\|@$names =E<gt> %options>
411
412					This will install an attribute of a given C<$name> into the current class. If
413					the first parameter is an array reference, it will create an attribute for
414					every C<$name> in the list. The C<%options> are the same as those provided by
415					L<Class::MOP::Attribute>, in addition to the list below which are provided by
416					Moose (L<Moose::Meta::Attribute> to be more specific):
417
418					=over 4
419
420					=item I<is =E<gt> 'rw'\|'ro'>
421
422					The I<is> option accepts either I<rw> (for read/write) or I<ro> (for read
423					only). These will create either a read/write accessor or a read-only
424					accessor respectively, using the same name as the C<$name> of the attribute.
425
426					If you need more control over how your accessors are named, you can
427					use the L<reader\|Class::MOP::Attribute/reader>,
428					L<writer\|Class::MOP::Attribute/writer> and
429					L<accessor\|Class::MOP::Attribute/accessor> options inherited from
430					L<Class::MOP::Attribute>, however if you use those, you won't need the
431					I<is> option.
432
433					=item I<isa =E<gt> $type_name>
434
435					The I<isa> option uses Moose's type constraint facilities to set up runtime
436					type checking for this attribute. Moose will perform the checks during class
437					construction, and within any accessors. The C<$type_name> argument must be a
438					string. The string may be either a class name or a type defined using
439					Moose's type definition features. (Refer to L<Moose::Util::TypeConstraints>
440					for information on how to define a new type, and how to retrieve type meta-data).
441
442					=item I<coerce =E<gt> (1\|0)>
443
444					This will attempt to use coercion with the supplied type constraint to change
445					the value passed into any accessors or constructors. You B<must> have supplied
446					a type constraint in order for this to work. See L<Moose::Cookbook::Basics::Recipe5>
447					for an example.
448
449					=item I<does =E<gt> $role_name>
450
451					This will accept the name of a role which the value stored in this attribute
452					is expected to have consumed.
453
454					=item I<required =E<gt> (1\|0)>
455
456					This marks the attribute as being required. This means a value must be
457					supplied during class construction, I<or> the attribute must be lazy
458					and have either a default or a builder. Note that c<required> does not
459					say anything about the attribute's value, which can be C<undef>.
460
461					=item I<weak_ref =E<gt> (1\|0)>
462
463					This will tell the class to store the value of this attribute as a weakened
464					reference. If an attribute is a weakened reference, it B<cannot> also be
465					coerced.
466
467					=item I<lazy =E<gt> (1\|0)>
468
469					This will tell the class to not create this slot until absolutely necessary.
470					If an attribute is marked as lazy it B<must> have a default supplied.
471
472					=item I<auto_deref =E<gt> (1\|0)>
473
474					This tells the accessor to automatically dereference the value of this
475					attribute when called in list context. The accessor will still return a
476					reference when called in scalar context. If this behavior isn't desirable,
477					L<Moose::Meta::Attribute::Native::Trait::Array/elements> or
478					L<Moose::Meta::Attribute::Native::Trait::Hash/elements> may be a better
479					choice. The I<auto_deref> option is only legal if your I<isa> option is
480					either C<ArrayRef> or C<HashRef>.
481
482					=item I<trigger =E<gt> $code>
483
484					The I<trigger> option is a CODE reference which will be called after
485					the value of the attribute is set. The CODE ref is passed the
486					instance itself, the updated value, and the original value if the
487					attribute was already set.
488
489					You B<can> have a trigger on a read-only attribute.
490
491					B<NOTE:> Triggers will only fire when you B<assign> to the attribute,
492					either in the constructor, or using the writer. Default and built values will
493					B<not> cause the trigger to be fired.
494
495					=item I<handles =E<gt> ARRAY \| HASH \| REGEXP \| ROLE \| ROLETYPE \| DUCKTYPE \| CODE>
496
497					The I<handles> option provides Moose classes with automated delegation features.
498					This is a pretty complex and powerful option. It accepts many different option
499					formats, each with its own benefits and drawbacks.
500
501					B<NOTE:> The class being delegated to does not need to be a Moose based class,
502					which is why this feature is especially useful when wrapping non-Moose classes.
503
504					All I<handles> option formats share the following traits:
505
506					You cannot override a locally defined method with a delegated method; an
507					exception will be thrown if you try. That is to say, if you define C<foo> in
508					your class, you cannot override it with a delegated C<foo>. This is almost never
509					something you would want to do, and if it is, you should do it by hand and not
510					use Moose.
511
512					You cannot override any of the methods found in Moose::Object, or the C<BUILD>
513					and C<DEMOLISH> methods. These will not throw an exception, but will silently
514					move on to the next method in the list. My reasoning for this is that you would
515					almost never want to do this, since it usually breaks your class. As with
516					overriding locally defined methods, if you do want to do this, you should do it
517					manually, not with Moose.
518
519					You do not I<need> to have a reader (or accessor) for the attribute in order
520					to delegate to it. Moose will create a means of accessing the value for you,
521					however this will be several times B<less> efficient then if you had given
522					the attribute a reader (or accessor) to use.
523
524					Below is the documentation for each option format:
525
526					=over 4
527
528					=item C<ARRAY>
529
530					This is the most common usage for I<handles>. You basically pass a list of
531					method names to be delegated, and Moose will install a delegation method
532					for each one.
533
534					=item C<HASH>
535
536					This is the second most common usage for I<handles>. Instead of a list of
537					method names, you pass a HASH ref where each key is the method name you
538					want installed locally, and its value is the name of the original method
539					in the class being delegated to.
540
541					This can be very useful for recursive classes like trees. Here is a
542					quick example (soon to be expanded into a Moose::Cookbook recipe):
543
544					package Tree;
545					use Moose;
546
547					has 'node' => (is => 'rw', isa => 'Any');
548
549					has 'children' => (
550					is => 'ro',
551					isa => 'ArrayRef',
552					default => sub { [] }
553					);
554
555					has 'parent' => (
556					is => 'rw',
557					isa => 'Tree',
558					weak_ref => 1,
559					handles => {
560					parent_node => 'node',
561					siblings => 'children',
562					}
563					);
564
565					In this example, the Tree package gets C<parent_node> and C<siblings> methods,
566					which delegate to the C<node> and C<children> methods (respectively) of the Tree
567					instance stored in the C<parent> slot.
568
569					You may also use an array reference to curry arguments to the original method.
570
571					has 'thing' => (
572					...
573					handles => { set_foo => [ set => 'foo' ] },
574					);
575
576					# $self->set_foo(...) calls $self->thing->set('foo', ...)
577
578					The first element of the array reference is the original method name, and the
579					rest is a list of curried arguments.
580
581					=item C<REGEXP>
582
583					The regexp option works very similar to the ARRAY option, except that it builds
584					the list of methods for you. It starts by collecting all possible methods of the
585					class being delegated to, then filters that list using the regexp supplied here.
586
587					B<NOTE:> An I<isa> option is required when using the regexp option format. This
588					is so that we can determine (at compile time) the method list from the class.
589					Without an I<isa> this is just not possible.
590
591					=item C<ROLE> or C<ROLETYPE>
592
593					With the role option, you specify the name of a role or a
594					L<role type\|Moose::Meta::TypeConstraint::Role> whose "interface" then becomes
595					the list of methods to handle. The "interface" can be defined as; the methods
596					of the role and any required methods of the role. It should be noted that this
597					does B<not> include any method modifiers or generated attribute methods (which
598					is consistent with role composition).
599
600					=item C<DUCKTYPE>
601
602					With the duck type option, you pass a duck type object whose "interface" then
603					becomes the list of methods to handle. The "interface" can be defined as; the
604					list of methods passed to C<duck_type> to create a duck type object. For more
605					information on C<duck_type> please check
606					L<Moose::Util::TypeConstraints>.
607
608					=item C<CODE>
609
610					This is the option to use when you really want to do something funky. You should
611					only use it if you really know what you are doing, as it involves manual
612					metaclass twiddling.
613
614					This takes a code reference, which should expect two arguments. The first is the
615					attribute meta-object this I<handles> is attached to. The second is the
616					metaclass of the class being delegated to. It expects you to return a hash (not
617					a HASH ref) of the methods you want mapped.
618
619					=back
620
621					=item I<metaclass =E<gt> $metaclass_name>
622
623					This tells the class to use a custom attribute metaclass for this particular
624					attribute. Custom attribute metaclasses are useful for extending the
625					capabilities of the I<has> keyword: they are the simplest way to extend the MOP,
626					but they are still a fairly advanced topic and too much to cover here, see
627					L<Moose::Cookbook::Meta::Recipe1> for more information.
628
629					See L<Metaclass and Trait Name Resolution> for details on how a metaclass name
630					is resolved to a class name.
631
632					=item I<traits =E<gt> [ @role_names ]>
633
634					This tells Moose to take the list of C<@role_names> and apply them to the
635					attribute meta-object. This is very similar to the I<metaclass> option, but
636					allows you to use more than one extension at a time.
637
638					See L<Metaclass and Trait Name Resolution> for details on how a trait name is
639					resolved to a role name.
640
641					Also see L<Moose::Cookbook::Meta::Recipe3> for a metaclass trait
642					example.
643
644					=item I<builder> => Str
645
646					The value of this key is the name of the method that will be called to
647					obtain the value used to initialize the attribute. See the L<builder
648					option docs in Class::MOP::Attribute\|Class::MOP::Attribute/builder>
649					and/or L<Moose::Cookbook::Basics::Recipe8> for more information.
650
651					=item I<default> => SCALAR \| CODE
652
653					The value of this key is the default value which will initialize the attribute.
654
655					NOTE: If the value is a simple scalar (string or number), then it can
656					be just passed as is. However, if you wish to initialize it with a
657					HASH or ARRAY ref, then you need to wrap that inside a CODE reference.
658					See the L<default option docs in
659					Class::MOP::Attribute\|Class::MOP::Attribute/default> for more
660					information.
661
662					=item I<clearer> => Str
663
664					Creates a method allowing you to clear the value, see the L<clearer option
665					docs in Class::MOP::Attribute\|Class::MOP::Attribute/clearer> for more
666					information.
667
668					=item I<predicate> => Str
669
670					Creates a method to perform a basic test to see if a value has been set in the
671					attribute, see the L<predicate option docs in
672					Class::MOP::Attribute\|Class::MOP::Attribute/predicate> for more information.
673
674					=item I<lazy_build> => (0\|1)
675
676					Automatically define lazy => 1 as well as builder => "_build_$attr", clearer =>
677					"clear_$attr', predicate => 'has_$attr' unless they are already defined.
678
679					=item I<initializer> => Str
680
681					This may be a method name (referring to a method on the class with
682					this attribute) or a CODE ref. The initializer is used to set the
683					attribute value on an instance when the attribute is set during
684					instance initialization (but not when the value is being assigned
685					to). See the L<initializer option docs in
686					Class::MOP::Attribute\|Class::MOP::Attribute/initializer> for more
687					information.
688
689					=item I<documentation> => $string
690
691					An arbitrary string that can be retrieved later by calling C<<
692					$attr->documentation >>.
693
694
695
696					=back
697
698					=item B<has +$name =E<gt> %options>
699
700					This is variation on the normal attribute creator C<has> which allows you to
701					clone and extend an attribute from a superclass or from a role. Here is an
702					example of the superclass usage:
703
704					package Foo;
705					use Moose;
706
707					has 'message' => (
708					is => 'rw',
709					isa => 'Str',
710					default => 'Hello, I am a Foo'
711					);
712
713					package My::Foo;
714					use Moose;
715
716					extends 'Foo';
717
718					has '+message' => (default => 'Hello I am My::Foo');
719
720					What is happening here is that B<My::Foo> is cloning the C<message> attribute
721					from its parent class B<Foo>, retaining the C<is =E<gt> 'rw'> and C<isa =E<gt>
722					'Str'> characteristics, but changing the value in C<default>.
723
724					Here is another example, but within the context of a role:
725
726					package Foo::Role;
727					use Moose::Role;
728
729					has 'message' => (
730					is => 'rw',
731					isa => 'Str',
732					default => 'Hello, I am a Foo'
733					);
734
735					package My::Foo;
736					use Moose;
737
738					with 'Foo::Role';
739
740					has '+message' => (default => 'Hello I am My::Foo');
741
742					In this case, we are basically taking the attribute which the role supplied
743					and altering it within the bounds of this feature.
744
745					Note that you can only extend an attribute from either a superclass or a role,
746					you cannot extend an attribute in a role that composes over an attribute from
747					another role.
748
749					Aside from where the attributes come from (one from superclass, the other
750					from a role), this feature works exactly the same. This feature is restricted
751					somewhat, so as to try and force at least I<some> sanity into it. You are only
752					allowed to change the following attributes:
753
754					=over 4
755
756					=item I<default>
757
758					Change the default value of an attribute.
759
760					=item I<coerce>
761
762					Change whether the attribute attempts to coerce a value passed to it.
763
764					=item I<required>
765
766					Change if the attribute is required to have a value.
767
768					=item I<documentation>
769
770					Change the documentation string associated with the attribute.
771
772					=item I<lazy>
773
774					Change if the attribute lazily initializes the slot.
775
776					=item I<isa>
777
778					You I<are> allowed to change the type without restriction.
779
780					It is recommended that you use this freedom with caution. We used to
781					only allow for extension only if the type was a subtype of the parent's
782					type, but we felt that was too restrictive and is better left as a
783					policy decision.
784
785					=item I<handles>
786
787					You are allowed to B<add> a new C<handles> definition, but you are B<not>
788					allowed to I<change> one.
789
790					=item I<builder>
791
792					You are allowed to B<add> a new C<builder> definition, but you are B<not>
793					allowed to I<change> one.
794
795					=item I<metaclass>
796
797					You are allowed to B<add> a new C<metaclass> definition, but you are
798					B<not> allowed to I<change> one.
799
800					=item I<traits>
801
802					You are allowed to B<add> additional traits to the C<traits> definition.
803					These traits will be composed into the attribute, but preexisting traits
804					B<are not> overridden, or removed.
805
806					=back
807
808					=item B<before $name\|@names\|\@names\|qr/.../ =E<gt> sub { ... }>
809
810					=item B<after $name\|@names\|\@names\|qr/.../ =E<gt> sub { ... }>
811
812					=item B<around $name\|@names\|\@names\|qr/.../ =E<gt> sub { ... }>
813
814					These three items are syntactic sugar for the before, after, and around method
815					modifier features that L<Class::MOP> provides. More information on these may be
816					found in L<Moose::Manual::MethodModifiers> and the
817					L<Class::MOP::Class documentation\|Class::MOP::Class/"Method Modifiers">.
818
819					=item B<super>
820
821					The keyword C<super> is a no-op when called outside of an C<override> method. In
822					the context of an C<override> method, it will call the next most appropriate
823					superclass method with the same arguments as the original method.
824
825					=item B<override ($name, &sub)>
826
827					An C<override> method is a way of explicitly saying "I am overriding this
828					method from my superclass". You can call C<super> within this method, and
829					it will work as expected. The same thing I<can> be accomplished with a normal
830					method call and the C<SUPER::> pseudo-package; it is really your choice.
831
832					=item B<inner>
833
834					The keyword C<inner>, much like C<super>, is a no-op outside of the context of
835					an C<augment> method. You can think of C<inner> as being the inverse of
836					C<super>; the details of how C<inner> and C<augment> work is best described in
837					the L<Moose::Cookbook::Basics::Recipe6>.
838
839					=item B<augment ($name, &sub)>
840
841					An C<augment> method, is a way of explicitly saying "I am augmenting this
842					method from my superclass". Once again, the details of how C<inner> and
843					C<augment> work is best described in the L<Moose::Cookbook::Basics::Recipe6>.
844
845					=item B<confess>
846
847					This is the C<Carp::confess> function, and exported here because I use it
848					all the time.
849
850					=item B<blessed>
851
852					This is the C<Scalar::Util::blessed> function, it is exported here because I
853					use it all the time. It is highly recommended that this is used instead of
854					C<ref> anywhere you need to test for an object's class name.
855
856					=back
857
858					=head1 METACLASS
859
860					When you use Moose, you can specify which metaclass to use:
861
862					use Moose -metaclass => 'My::Meta::Class';
863
864					You can also specify traits which will be applied to your metaclass:
865
866					use Moose -traits => 'My::Trait';
867
868					This is very similar to the attribute traits feature. When you do
869					this, your class's C<meta> object will have the specified traits
870					applied to it. See L<Metaclass and Trait Name Resolution> for more
871					details.
872
873					=head2 Metaclass and Trait Name Resolution
874
875					By default, when given a trait name, Moose simply tries to load a
876					class of the same name. If such a class does not exist, it then looks
877					for for a class matching
878					B<Moose::Meta::$type::Custom::Trait::$trait_name>. The C<$type>
879					variable here will be one of B<Attribute> or B<Class>, depending on
880					what the trait is being applied to.
881
882					If a class with this long name exists, Moose checks to see if it has
883					the method C<register_implementation>. This method is expected to
884					return the I<real> class name of the trait. If there is no
885					C<register_implementation> method, it will fall back to using
886					B<Moose::Meta::$type::Custom::Trait::$trait> as the trait name.
887
888					The lookup method for metaclasses is the same, except that it looks
889					for a class matching B<Moose::Meta::$type::Custom::$metaclass_name>.
890
891					If all this is confusing, take a look at
892					L<Moose::Cookbook::Meta::Recipe3>, which demonstrates how to create an
893					attribute trait.
894
895					=head1 UNIMPORTING FUNCTIONS
896
897					=head2 B<unimport>
898
899					Moose offers a way to remove the keywords it exports, through the C<unimport>
900					method. You simply have to say C<no Moose> at the bottom of your code for this
901					to work. Here is an example:
902
903					package Person;
904					use Moose;
905
906					has 'first_name' => (is => 'rw', isa => 'Str');
907					has 'last_name' => (is => 'rw', isa => 'Str');
908
909					sub full_name {
910					my $self = shift;
911					$self->first_name . ' ' . $self->last_name
912					}
913
914					no Moose; # keywords are removed from the Person package
915
916					=head1 EXTENDING AND EMBEDDING MOOSE
917
918					To learn more about extending Moose, we recommend checking out the
919					"Extending" recipes in the L<Moose::Cookbook>, starting with
920					L<Moose::Cookbook::Extending::Recipe1>, which provides an overview of
921					all the different ways you might extend Moose.
922
923					=head2 B<< Moose->init_meta(for_class => $class, base_class => $baseclass, metaclass => $metaclass) >>
924
925					The C<init_meta> method sets up the metaclass object for the class
926					specified by C<for_class>. This method injects a a C<meta> accessor
927					into the class so you can get at this object. It also sets the class's
928					superclass to C<base_class>, with L<Moose::Object> as the default.
929
930					C<init_meta> returns the metaclass object for C<$class>.
931
932					You can specify an alternate metaclass with the C<metaclass> option.
933
934					For more detail on this topic, see L<Moose::Cookbook::Extending::Recipe2>.
935
936					This method used to be documented as a function which accepted
937					positional parameters. This calling style will still work for
938					backwards compatibility, but is deprecated.
939
940					=head2 B<import>
941
942					Moose's C<import> method supports the L<Sub::Exporter> form of C<{into =E<gt> $pkg}>
943					and C<{into_level =E<gt> 1}>.
944
945					B<NOTE>: Doing this is more or less deprecated. Use L<Moose::Exporter>
946					instead, which lets you stack multiple C<Moose.pm>-alike modules
947					sanely. It handles getting the exported functions into the right place
948					for you.
949
950					=head2 B<throw_error>
951
952					An alias for C<confess>, used by internally by Moose.
953
954					=head1 METACLASS COMPATIBILITY AND MOOSE
955
956					Metaclass compatibility is a thorny subject. You should start by
957					reading the "About Metaclass compatibility" section in the
958					C<Class::MOP> docs.
959
960					Moose will attempt to resolve a few cases of metaclass incompatibility
961					when you set the superclasses for a class, unlike C<Class::MOP>, which
962					simply dies if the metaclasses are incompatible.
963
964					In actuality, Moose fixes incompatibility for I<all> of a class's
965					metaclasses, not just the class metaclass. That includes the instance
966					metaclass, attribute metaclass, as well as its constructor class and
967					destructor class. However, for simplicity this discussion will just
968					refer to "metaclass", meaning the class metaclass, most of the time.
969
970					Moose has two algorithms for fixing metaclass incompatibility.
971
972					The first algorithm is very simple. If all the metaclass for the
973					parent is a I<subclass> of the child's metaclass, then we simply
974					replace the child's metaclass with the parent's.
975
976					The second algorithm is more complicated. It tries to determine if the
977					metaclasses only "differ by roles". This means that the parent and
978					child's metaclass share a common ancestor in their respective
979					hierarchies, and that the subclasses under the common ancestor are
980					only different because of role applications. This case is actually
981					fairly common when you mix and match various C<MooseX::*> modules,
982					many of which apply roles to the metaclass.
983
984					If the parent and child do differ by roles, Moose replaces the
985					metaclass in the child with a newly created metaclass. This metaclass
986					is a subclass of the parent's metaclass, does all of the roles that
987					the child's metaclass did before being replaced. Effectively, this
988					means the new metaclass does all of the roles done by both the
989					parent's and child's original metaclasses.
990
991					Ultimately, this is all transparent to you except in the case of an
992					unresolvable conflict.
993
994					=head2 The MooseX:: namespace
995
996					Generally if you're writing an extension I<for> Moose itself you'll want
997					to put your extension in the C<MooseX::> namespace. This namespace is
998					specifically for extensions that make Moose better or different in some
999					fundamental way. It is traditionally B<not> for a package that just happens
1000					to use Moose. This namespace follows from the examples of the C<LWPx::>
1001					and C<DBIx::> namespaces that perform the same function for C<LWP> and C<DBI>
1002					respectively.
1003
1004					=head1 CAVEATS
1005
1006					=over 4
1007
1008					=item *
1009
1010					It should be noted that C<super> and C<inner> B<cannot> be used in the same
1011					method. However, they may be combined within the same class hierarchy; see
1012					F<t/014_override_augment_inner_super.t> for an example.
1013
1014					The reason for this is that C<super> is only valid within a method
1015					with the C<override> modifier, and C<inner> will never be valid within an
1016					C<override> method. In fact, C<augment> will skip over any C<override> methods
1017					when searching for its appropriate C<inner>.
1018
1019					This might seem like a restriction, but I am of the opinion that keeping these
1020					two features separate (yet interoperable) actually makes them easy to use, since
1021					their behavior is then easier to predict. Time will tell whether I am right or
1022					not (UPDATE: so far so good).
1023
1024					=back
1025
1026					=head1 GETTING HELP
1027
1028					We offer both a mailing list and a very active IRC channel.
1029
1030					The mailing list is L<moose@perl.org>. You must be subscribed to send
1031					a message. To subscribe, send an empty message to
1032					L<moose-subscribe@perl.org>
1033
1034					You can also visit us at C<#moose> on L<irc://irc.perl.org/#moose>
1035					This channel is quite active, and questions at all levels (on Moose-related
1036					topics ;) are welcome.
1037
1038					=head1 ACKNOWLEDGEMENTS
1039
1040					=over 4
1041
1042					=item I blame Sam Vilain for introducing me to the insanity that is meta-models.
1043
1044					=item I blame Audrey Tang for then encouraging my meta-model habit in #perl6.
1045
1046					=item Without Yuval "nothingmuch" Kogman this module would not be possible,
1047					and it certainly wouldn't have this name ;P
1048
1049					=item The basis of the TypeContraints module was Rob Kinyon's idea
1050					originally, I just ran with it.
1051
1052					=item Thanks to mst & chansen and the whole #moose posse for all the
1053					early ideas/feature-requests/encouragement/bug-finding.
1054
1055					=item Thanks to David "Theory" Wheeler for meta-discussions and spelling fixes.
1056
1057					=back
1058
1059					=head1 SEE ALSO
1060
1061					=over 4
1062
1063					=item L<http://www.iinteractive.com/moose>
1064
1065					This is the official web home of Moose, it contains links to our public SVN repository
1066					as well as links to a number of talks and articles on Moose and Moose related
1067					technologies.
1068
1069					=item The Moose is flying, a tutorial by Randal Schwartz
1070
1071					Part 1 - L<http://www.stonehenge.com/merlyn/LinuxMag/col94.html>
1072
1073					Part 2 - L<http://www.stonehenge.com/merlyn/LinuxMag/col95.html>
1074
1075					=item Several Moose extension modules in the C<MooseX::> namespace.
1076
1077					See L<http://search.cpan.org/search?query=MooseX::> for extensions.
1078
1079					=item Moose stats on ohloh.net - L<http://www.ohloh.net/projects/moose>
1080
1081					=back
1082
1083					=head2 Books
1084
1085					=over 4
1086
1087					=item The Art of the MetaObject Protocol
1088
1089					I mention this in the L<Class::MOP> docs too, this book was critical in
1090					the development of both modules and is highly recommended.
1091
1092					=back
1093
1094					=head2 Papers
1095
1096					=over 4
1097
1098					=item L<http://www.cs.utah.edu/plt/publications/oopsla04-gff.pdf>
1099
1100					This paper (suggested by lbr on #moose) was what lead to the implementation
1101					of the C<super>/C<override> and C<inner>/C<augment> features. If you really
1102					want to understand them, I suggest you read this.
1103
1104					=back
1105
1106					=head1 BUGS
1107
1108					All complex software has bugs lurking in it, and this module is no
1109					exception.
1110
1111					Please report any bugs to C<bug-moose@rt.cpan.org>, or through the web
1112					interface at L<http://rt.cpan.org>.
1113
1114					You can also discuss feature requests or possible bugs on the Moose mailing
1115					list (moose@perl.org) or on IRC at L<irc://irc.perl.org/#moose>.
1116
1117					=head1 FEATURE REQUESTS
1118
1119					We are very strict about what features we add to the Moose core, especially
1120					the user-visible features. Instead we have made sure that the underlying
1121					meta-system of Moose is as extensible as possible so that you can add your
1122					own features easily.
1123
1124					That said, occasionally there is a feature needed in the meta-system
1125					to support your planned extension, in which case you should either
1126					email the mailing list (moose@perl.org) or join us on IRC at
1127					L<irc://irc.perl.org/#moose> to discuss. The
1128					L<Moose::Manual::Contributing> has more detail about how and when you
1129					can contribute.
1130
1131					=head1 AUTHOR
1132
1133					Moose is an open project, there are at this point dozens of people who have
1134					contributed, and can contribute. If you have added anything to the Moose
1135					project you have a commit bit on this file and can add your name to the list.
1136
1137					=head2 CABAL
1138
1139					However there are only a few people with the rights to release a new version
1140					of Moose. The Moose Cabal are the people to go to with questions regarding
1141					the wider purview of Moose, and help out maintaining not just the code
1142					but the community as well.
1143
1144					Stevan (stevan) Little E<lt>stevan@iinteractive.comE<gt>
1145
1146					Jesse (doy) Luehrs E<lt>doy at tozt dot netE<gt>
1147
1148					Yuval (nothingmuch) Kogman
1149
1150					Shawn (sartak) Moore E<lt>sartak@bestpractical.comE<gt>
1151
1152					Hans Dieter (confound) Pearcey E<lt>hdp@pobox.comE<gt>
1153
1154					Chris (perigrin) Prather
1155
1156					Florian Ragwitz E<lt>rafl@debian.orgE<gt>
1157
1158					Dave (autarch) Rolsky E<lt>autarch@urth.orgE<gt>
1159
1160					=head2 OTHER CONTRIBUTORS
1161
1162					Aankhen
1163
1164					Adam (Alias) Kennedy
1165
1166					Anders (Debolaz) Nor Berle
1167
1168					Nathan (kolibrie) Gray
1169
1170					Christian (chansen) Hansen
1171
1172					Eric (ewilhelm) Wilhelm
1173
1174					Guillermo (groditi) Roditi
1175
1176					Jess (castaway) Robinson
1177
1178					Matt (mst) Trout
1179
1180					Robert (phaylon) Sedlacek
1181
1182					Robert (rlb3) Boone
1183
1184					Scott (konobi) McWhirter
1185
1186					Shlomi (rindolf) Fish
1187
1188					Wallace (wreis) Reis
1189
1190					Jonathan (jrockway) Rockway
1191
1192					Piotr (dexter) Roszatycki
1193
1194					Sam (mugwump) Vilain
1195
1196					Cory (gphat) Watson
1197
1198					Dylan Hardison (doc fixes)
1199
1200					... and many other #moose folks
1201
1202					=head1 COPYRIGHT AND LICENSE
1203
1204					Copyright 2006-2010 by Infinity Interactive, Inc.
1205
1206					L<http://www.iinteractive.com>
1207
1208					This library is free software; you can redistribute it and/or modify
1209					it under the same terms as Perl itself.
1210
1211					=cut
					# spent 54µs within Moose::bootstrap which was called # once (54µs+0s) by DynaLoader::bootstrap at line 223 of DynaLoader.pm sub Moose::bootstrap; # xsub