Checking in changes prior to tagging of version 0.40_09. Changelog diff is:

[gitmo/Mouse.git] / lib / Mouse / Object.pm

diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm
index 5b7d17e..30f1fab 100644 (file)
--- a/lib/Mouse/Object.pm
+++ b/lib/Mouse/Object.pm
@@ -1,80 +1,8 @@
-#!/usr/bin/env perl
 package Mouse::Object;
-use strict;
-use warnings;
-use MRO::Compat;
-
-use Scalar::Util qw/blessed weaken/;
-use Carp 'confess';
-
-sub new {
-    my $class = shift;
-    my %args;
-    if (scalar @_ == 1) {
-        if (defined $_[0]) {
-            (ref($_[0]) eq 'HASH')
-                || confess "Single parameters to new() must be a HASH ref";
-            %args = %{$_[0]};
-        }
-    }
-    else {
-        %args = @_;
-    }
-
-    my $instance = bless {}, $class;
-
-    for my $attribute ($class->meta->compute_all_applicable_attributes) {
-        my $from = $attribute->init_arg;
-        my $key  = $attribute->name;
-        my $default;
-
-        if (defined($from) && exists($args{$from})) {
-            $attribute->verify_type_constraint($args{$from})
-                if $attribute->has_type_constraint;
-
-            $instance->{$key} = $args{$from};
-
-            weaken($instance->{$key})
-                if ref($instance->{$key}) && $attribute->is_weak_ref;
-
-            if ($attribute->has_trigger) {
-                $attribute->trigger->($instance, $args{$from}, $attribute);
-            }
-        }
-        else {
-            if ($attribute->has_default || $attribute->has_builder) {
-                unless ($attribute->is_lazy) {
-                    my $default = $attribute->default;
-                    my $builder = $attribute->builder;
-                    my $value = $attribute->has_builder
-                              ? $instance->$builder
-                              : ref($default) eq 'CODE'
-                                  ? $default->()
-                                  : $default;
-
-                    $attribute->verify_type_constraint($value)
-                        if $attribute->has_type_constraint;
-
-                    $instance->{$key} = $value;
-
-                    weaken($instance->{$key})
-                        if ref($instance->{$key}) && $attribute->is_weak_ref;
-                }
-            }
-            else {
-                if ($attribute->is_required) {
-                    confess "Attribute (".$attribute->name.") is required";
-                }
-            }
-        }
-    }
-
-    $instance->BUILDALL(\%args);
+use Mouse::Util qw(does dump meta); # enables strict and warnings
 
-    return $instance;
-}
+sub new;
 
-sub DESTROY { shift->DEMOLISHALL }
 
 sub BUILDALL {
     my $self = shift;
@@ -82,13 +10,13 @@ sub BUILDALL {
     # short circuit
     return unless $self->can('BUILD');
 
-    no strict 'refs';
-
     for my $class (reverse $self->meta->linearized_isa) {
-        my $code = *{ $class . '::BUILD' }{CODE}
-            or next;
-        $code->($self, @_);
+        my $build = Mouse::Util::get_code_ref($class, 'BUILD')
+            || next;
+
+        $self->$build(@_);
     }
+    return;
 }
 
 sub DEMOLISHALL {
@@ -97,13 +25,18 @@ sub DEMOLISHALL {
     # short circuit
     return unless $self->can('DEMOLISH');
 
-    no strict 'refs';
+    # 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;
 
-    for my $class ($self->meta->linearized_isa) {
-        my $code = *{ $class . '::DEMOLISH' }{CODE}
-            or next;
-        $code->($self, @_);
+        $self->$demolish();
     }
+    return;
 }
 
 1;
@@ -112,33 +45,65 @@ __END__
 
 =head1 NAME
 
-Mouse::Object - we don't need to steenkin' constructor
+Mouse::Object - The base object for Mouse classes
+
+=head1 VERSION
+
+This document describes Mouse version 0.40_09
 
 =head1 METHODS
 
-=head2 new arguments -> object
+=head2 C<< new (Arguments) -> Object >>
+
+Instantiates a new C<Mouse::Object>. This is obviously intended for subclasses.
 
-Instantiates a new Mouse::Object. This is obviously intended for subclasses.
+=head2 C<< BUILDARGS (Arguments) -> HashRef >>
 
-=head2 BUILDALL \%args
+Lets you override the arguments that C<new> takes. Return a hashref of
+parameters.
 
-Calls L</BUILD> on each class in the class hierarchy. This is called at the
-end of L</new>.
+=head2 C<< BUILDALL (\%args) >>
 
-=head2 BUILD \%args
+Calls C<BUILD> on each class in the class hierarchy. This is called at the
+end of C<new>.
+
+=head2 C<< BUILD (\%args) >>
 
 You may put any business logic initialization in BUILD methods. You don't
 need to redispatch or return any specific value.
 
-=head2 DEMOLISHALL
+=head2 C<< DEMOLISHALL >>
 
-Calls L</DEMOLISH> on each class in the class hierarchy. This is called at
-L</DESTROY> time.
+Calls C<DEMOLISH> on each class in the class hierarchy. This is called at
+C<DESTROY> time.
 
-=head2 DEMOLISH
+=head2 C<< 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 >>
+
+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:
+
+    C'mon, how many times have you written the following code while debugging:
+
+     use Data::Dumper; 
+     warn Dumper $obj;
+
+    It can get seriously annoying, so why not just use this.
+
+The implementation was lifted directly from Moose::Object.
+
+=head1 SEE ALSO
+
+L<Moose::Object>
+
 =cut