X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=12a90f0680b903a80794fc07efb75f8eac1b0d61;hb=6336eb18ec59cf5c9c057624c7a1d15f449b00c6;hp=a68eb777cfbe5451049da8d42b1633d12183a709;hpb=065f79e7cd03765f26c6ea276aaf9b3c5897886a;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index a68eb77..12a90f0 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,86 +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 { - my $class = shift; - - $class->meta->throw_error('Cannot call new() on an instance') if ref $class; - - my $args = $class->BUILDARGS(@_); - - my $instance = Mouse::Meta::Class->initialize($class)->new_object($args); - $instance->BUILDALL($args); - return $instance; -} - -sub BUILDARGS { - my $class = shift; - - if (scalar @_ == 1) { - (ref($_[0]) eq 'HASH') - || $class->meta->throw_error("Single parameters to new() must be a HASH ref"); - - return {%{$_[0]}}; - } - else { - return {@_}; - } -} - -sub DESTROY { - my $self = shift; - - local $?; - - my $e = do{ - local $@; - eval{ - $self->DEMOLISHALL(); - }; - $@; - }; - - no warnings 'misc'; - die $e if $e; # rethrow -} - -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 @@ -89,57 +16,52 @@ Mouse::Object - The base object for Mouse classes =head1 VERSION -This document describes Mouse version 0.40_02 +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