package Mouse::Object;
-use Mouse::Util qw(does dump); # enables strict and warnings
-
-sub new {
- my $class = shift;
-
- $class->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 = do{
- no strict 'refs';
- no warnings 'once';
- *{ $class . '::BUILD' }{CODE};
- } or 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 = do{
- no strict 'refs';
- no warnings 'once';
- *{ $class . '::DEMOLISH'}{CODE};
- } or next;
-
- $self->$demolish();
- }
- return;
-}
-
+use Mouse::Util qw(does dump meta); # enables strict and warnings
+# all the stuff are defined in XS or PP
1;
-
__END__
=head1 NAME
=head1 VERSION
-This document describes Mouse version 0.40
+This document describes Mouse version 0.88
=head1 METHODS
-=head2 C<< new (Arguments) -> Object >>
+=head2 C<< $class->new(%args | \%args) -> Object >>
Instantiates a new C<Mouse::Object>. This is obviously intended for subclasses.
-=head2 C<< BUILDARGS (Arguments) -> HashRef >>
+=head2 C<< $class->BUILDARGS(@args) -> HashRef >>
-Lets you override the arguments that C<new> takes. Return a hashref of
-parameters.
+Lets you override the arguments that C<new> takes.
+It must return a HashRef of parameters.
-=head2 C<< BUILDALL (\%args) >>
+=head2 C<< $object->BUILDALL(\%args) >>
Calls C<BUILD> on each class in the class hierarchy. This is called at the
end of C<new>.
-=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<DEMOLISH> on each class in the class hierarchy. This is called at
C<DESTROY> 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<does> a given C<$role_name>.
-This is similar to "isa" for object, but it checks the roles instead.
-
-=head2 C<<dump ($maxdepth) -> Str >>
-
-From the Moose POD:
+This is similar to C<isa> 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
projects / gitmo/Mouse.git / blobdiff