X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=12a90f0680b903a80794fc07efb75f8eac1b0d61;hb=6336eb18ec59cf5c9c057624c7a1d15f449b00c6;hp=787cc17dd69d2f48a52c8cc8ee295ad508ab4cec;hpb=1e5823974a557bd35b4aa4a5c1d1aecf1e5483d2;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 787cc17..12a90f0 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,46 +1,13 @@ package Mouse::Object; -use Mouse::Util qw(does dump); # enables strict and warnings +use Mouse::Util qw(does dump meta); # enables strict and warnings +# all the stuff are defined in XS or PP -sub new; - - -sub BUILDALL { - my $self = shift; - - # short circuit - return unless $self->can('BUILD'); - - for my $class (reverse $self->meta->linearized_isa) { - my $build = Mouse::Util::get_code_ref($class, 'BUILD') - || next; - - $self->$build(@_); - } - return; -} - -sub DEMOLISHALL { - my $self = shift; - - # short circuit - return unless $self->can('DEMOLISH'); - - # We cannot count on being able to retrieve a previously made - # metaclass, _or_ being able to make a new one during global - # destruction. However, we should still be able to use mro at - # that time (at least tests suggest so ;) - - foreach my $class (@{ Mouse::Util::get_linear_isa(ref $self) }) { - my $demolish = Mouse::Util::get_code_ref($class, 'DEMOLISH') - || next; - - $self->$demolish(); - } - return; +sub DOES { + my($self, $class_or_role_name) = @_; + return $self->isa($class_or_role_name) || $self->does($class_or_role_name); } 1; - __END__ =head1 NAME @@ -49,57 +16,52 @@ Mouse::Object - The base object for Mouse classes =head1 VERSION -This document describes Mouse version 0.40_06 +This document describes Mouse version 0.93 =head1 METHODS -=head2 C<< new (Arguments) -> Object >> +=head2 C<< $class->new(%args | \%args) -> Object >> Instantiates a new C. This is obviously intended for subclasses. -=head2 C<< BUILDARGS (Arguments) -> HashRef >> +=head2 C<< $class->BUILDARGS(@args) -> HashRef >> -Lets you override the arguments that C takes. Return a hashref of -parameters. +Lets you override the arguments that C takes. +It must return a HashRef of parameters. -=head2 C<< BUILDALL (\%args) >> +=head2 C<< $object->BUILDALL(\%args) >> Calls C on each class in the class hierarchy. This is called at the end of C. -=head2 C<< BUILD (\%args) >> +=head2 C<< $object->BUILD(\%args) >> You may put any business logic initialization in BUILD methods. You don't need to redispatch or return any specific value. -=head2 C<< DEMOLISHALL >> +=head2 C<< $object->DEMOLISHALL >> Calls C on each class in the class hierarchy. This is called at C time. -=head2 C<< DEMOLISH >> +=head2 C<< $object->DEMOLISH >> You may put any business logic deinitialization in DEMOLISH methods. You don't need to redispatch or return any specific value. - -=head2 C<< does ($role_name) -> Bool >> +=head2 C<< $object->does($role_name) -> Bool >> This will check if the invocant's class B a given C<$role_name>. -This is similar to "isa" for object, but it checks the roles instead. - -=head2 C< Str >> - -From the Moose POD: +This is similar to C for object, but it checks the roles instead. - C'mon, how many times have you written the following code while debugging: +=head2 C<< $object->dump($maxdepth) -> Str >> - use Data::Dumper; - warn Dumper $obj; +This is a handy utility for dumping an object with Data::Dumper. +By default, the maximum depth is 3, to avoid making a mess. - It can get seriously annoying, so why not just use this. +=head2 C<< $object->meta() -> MetaClass >> -The implementation was lifted directly from Moose::Object. +This is a method which provides access to the object's metaclass. =head1 SEE ALSO