2 use Mouse::Util qw(does dump); # enables strict and warnings
7 $class->throw_error('Cannot call new() on an instance') if ref $class;
9 my $args = $class->BUILDARGS(@_);
11 my $instance = Mouse::Meta::Class->initialize($class)->new_object($args);
12 $instance->BUILDALL($args);
20 (ref($_[0]) eq 'HASH')
21 || $class->meta->throw_error("Single parameters to new() must be a HASH ref");
40 return unless $self->can('BUILD');
42 for my $class (reverse $self->meta->linearized_isa) {
43 my $build = do{ no strict 'refs'; *{ $class . '::BUILD' }{CODE} }
55 return unless $self->can('DEMOLISH');
57 # We cannot count on being able to retrieve a previously made
58 # metaclass, _or_ being able to make a new one during global
59 # destruction. However, we should still be able to use mro at
60 # that time (at least tests suggest so ;)
62 foreach my $class (@{ Mouse::Util::get_linear_isa(ref $self) }) {
63 my $demolish = do{ no strict 'refs'; *{ $class . '::DEMOLISH'}{CODE} }
77 Mouse::Object - The base object for Mouse classes
81 =head2 C<< new (Arguments) -> Object >>
83 Instantiates a new C<Mouse::Object>. This is obviously intended for subclasses.
85 =head2 C<< BUILDARGS (Arguments) -> HashRef >>
87 Lets you override the arguments that C<new> takes. Return a hashref of
90 =head2 C<< BUILDALL (\%args) >>
92 Calls C<BUILD> on each class in the class hierarchy. This is called at the
95 =head2 C<< BUILD (\%args) >>
97 You may put any business logic initialization in BUILD methods. You don't
98 need to redispatch or return any specific value.
100 =head2 C<< DEMOLISHALL >>
102 Calls C<DEMOLISH> on each class in the class hierarchy. This is called at
105 =head2 C<< DEMOLISH >>
107 You may put any business logic deinitialization in DEMOLISH methods. You don't
108 need to redispatch or return any specific value.
111 =head2 C<< does ($role_name) -> Bool >>
113 This will check if the invocant's class B<does> a given C<$role_name>.
114 This is similar to "isa" for object, but it checks the roles instead.
116 =head2 C<<dump ($maxdepth) -> Str >>
120 C'mon, how many times have you written the following code while debugging:
125 It can get seriously annoying, so why not just use this.
127 The implementation was lifted directly from Moose::Object.