X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=12a90f0680b903a80794fc07efb75f8eac1b0d61;hb=6336eb18ec59cf5c9c057624c7a1d15f449b00c6;hp=2a5a63934f9880933b88ae5cff012dfb1fe1bcc3;hpb=5aa30cedaeea188c11688187a689d70f4b7698d2;p=gitmo%2FMouse.git

diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm
index 2a5a639..12a90f0 100644
--- a/lib/Mouse/Object.pm
+++ b/lib/Mouse/Object.pm
@@ -1,129 +1,71 @@
-#!/usr/bin/env perl
 package Mouse::Object;
-use strict;
-use warnings;
-use MRO::Compat;
-
-use Scalar::Util 'blessed';
-use Carp 'confess';
-
-sub new {
-    my $class = shift;
-    my %args  = @_;
-    my $instance = bless {}, $class;
-
-    for my $attribute ($class->meta->attributes) {
-        my $key = $attribute->init_arg;
-        my $default;
-
-        if (!exists($args{$key})) {
-            if (exists($attribute->{default})) {
-                unless ($attribute->{lazy}) {
-                    my $default = ref($attribute->{default}) eq 'CODE'
-                                ? $attribute->{default}->()
-                                : $attribute->{default};
-
-                    $attribute->verify_type_constraint($default)
-                        if $attribute->has_type_constraint;
-
-                    $instance->{$key} = $default;
-
-                    Scalar::Util::weaken($instance->{$key})
-                        if $attribute->{weak_ref};
-                }
-            }
-            else {
-                if ($attribute->{required}) {
-                    confess "Attribute '$attribute->{name}' is required";
-                }
-            }
-        }
-
-        if (exists($args{$key})) {
-            $attribute->verify_type_constraint($args{$key})
-                if $attribute->has_type_constraint;
-
-            $instance->{$key} = $args{$key};
-
-            Scalar::Util::weaken($instance->{$key})
-                if $attribute->{weak_ref};
-
-            if ($attribute->{trigger}) {
-                $attribute->{trigger}->($instance, $args{$key}, $attribute);
-            }
-        }
-    }
-
-    $instance->BUILDALL(\%args);
-
-    return $instance;
+use Mouse::Util qw(does dump meta); # enables strict and warnings
+# all the stuff are defined in XS or PP
+
+sub DOES {
+    my($self, $class_or_role_name) = @_;
+    return $self->isa($class_or_role_name) || $self->does($class_or_role_name);
 }
 
-sub DESTROY { shift->DEMOLISHALL }
+1;
+__END__
 
-sub BUILDALL {
-    my $self = shift;
+=head1 NAME
 
-    # short circuit
-    return unless $self->can('BUILD');
+Mouse::Object - The base object for Mouse classes
 
-    no strict 'refs';
+=head1 VERSION
 
-    for my $class ($self->meta->linearized_isa) {
-        my $code = *{ $class . '::BUILD' }{CODE}
-            or next;
-        $code->($self, @_);
-    }
-}
+This document describes Mouse version 0.93
 
-sub DEMOLISHALL {
-    my $self = shift;
+=head1 METHODS
 
-    # short circuit
-    return unless $self->can('DEMOLISH');
+=head2 C<< $class->new(%args | \%args) -> Object >>
 
-    no strict 'refs';
+Instantiates a new C<Mouse::Object>. This is obviously intended for subclasses.
 
-    for my $class ($self->meta->linearized_isa) {
-        my $code = *{ $class . '::DEMOLISH' }{CODE}
-            or next;
-        $code->($self, @_);
-    }
-}
+=head2 C<< $class->BUILDARGS(@args) -> HashRef >>
 
-1;
+Lets you override the arguments that C<new> takes.
+It must return a HashRef of parameters.
 
-__END__
+=head2 C<< $object->BUILDALL(\%args) >>
 
-=head1 NAME
+Calls C<BUILD> on each class in the class hierarchy. This is called at the
+end of C<new>.
 
-Mouse::Object - we don't need to steenkin' constructor
+=head2 C<< $object->BUILD(\%args) >>
 
-=head1 METHODS
+You may put any business logic initialization in BUILD methods. You don't
+need to redispatch or return any specific value.
 
-=head2 new arguments -> object
+=head2 C<< $object->DEMOLISHALL >>
 
-Instantiates a new Mouse::Object. This is obviously intended for subclasses.
+Calls C<DEMOLISH> on each class in the class hierarchy. This is called at
+C<DESTROY> time.
 
-=head2 BUILDALL \%args
+=head2 C<< $object->DEMOLISH >>
 
-Calls L</BUILD> on each class in the class hierarchy. This is called at the
-end of L</new>.
+You may put any business logic deinitialization in DEMOLISH methods. You don't
+need to redispatch or return any specific value.
 
-=head2 BUILD \%args
+=head2 C<< $object->does($role_name) -> Bool >>
 
-You may put any business logic initialization in BUILD methods. You don't
-need to redispatch or return any specific value.
+This will check if the invocant's class B<does> a given C<$role_name>.
+This is similar to C<isa> for object, but it checks the roles instead.
 
-=head2 DEMOLISHALL
+=head2 C<< $object->dump($maxdepth) -> Str >>
 
-Calls L</DEMOLISH> on each class in the class hierarchy. This is called at
-L</DESTROY> time.
+This is a handy utility for dumping an object with Data::Dumper.
+By default, the maximum depth is 3, to avoid making a mess.
 
-=head2 DEMOLISH
+=head2 C<< $object->meta() -> MetaClass >>
 
-You may put any business logic deinitialization in DEMOLISH methods. You don't
-need to redispatch or return any specific value.
+This is a method which provides access to the object's metaclass.
+
+=head1 SEE ALSO
+
+L<Moose::Object>
 
 =cut