X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=f546d7555f94574389a4541b04eaa0696800568b;hb=d468e99669162209fc407bc22706a91b8675dbbc;hp=fcfaf6b094d4e6fcdc75968bae432bff1a9bb7d3;hpb=fc1d8369f17d2d6a06ecdcb13199e1d4ecb2e53f;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index fcfaf6b..f546d75 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,159 +1,71 @@ -#!/usr/bin/env perl package Mouse::Object; -use strict; -use warnings; - -use Mouse::Util qw/weaken/; -use Carp 'confess'; - -sub new { - my $class = shift; - - my $args = $class->BUILDARGS(@_); - - my $instance = bless {}, $class; - - for my $attribute ($class->meta->compute_all_applicable_attributes) { - my $from = $attribute->init_arg; - my $key = $attribute->name; - - if (defined($from) && exists($args->{$from})) { - $args->{$from} = $attribute->coerce_constraint($args->{$from}) - if $attribute->should_coerce; - $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; - - $value = $attribute->coerce_constraint($value) - if $attribute->should_coerce; - $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); - - return $instance; -} +use Mouse::Util qw(does dump meta); # enables strict and warnings +# all the stuff are defined in XS or PP -sub BUILDARGS { - my $class = shift; - - if (scalar @_ == 1) { - if (defined $_[0]) { - (ref($_[0]) eq 'HASH') - || confess "Single parameters to new() must be a HASH ref"; - return {%{$_[0]}}; - } else { - return {}; - } - } - else { - return {@_}; - } +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 } - -sub BUILDALL { - my $self = shift; +1; +__END__ - # short circuit - return unless $self->can('BUILD'); +=head1 NAME - for my $class (reverse $self->meta->linearized_isa) { - no strict 'refs'; - no warnings 'once'; - my $code = *{ $class . '::BUILD' }{CODE} - or next; - $code->($self, @_); - } -} +Mouse::Object - The base object for Mouse classes -sub DEMOLISHALL { - my $self = shift; +=head1 VERSION - # short circuit - return unless $self->can('DEMOLISH'); +This document describes Mouse version 0.92 - no strict 'refs'; +=head1 METHODS - for my $class ($self->meta->linearized_isa) { - my $code = *{ $class . '::DEMOLISH' }{CODE} - or next; - $code->($self, @_); - } -} +=head2 C<< $class->new(%args | \%args) -> Object >> -1; +Instantiates a new C. This is obviously intended for subclasses. -__END__ +=head2 C<< $class->BUILDARGS(@args) -> HashRef >> -=head1 NAME +Lets you override the arguments that C takes. +It must return a HashRef of parameters. -Mouse::Object - we don't need to steenkin' constructor +=head2 C<< $object->BUILDALL(\%args) >> -=head1 METHODS +Calls C on each class in the class hierarchy. This is called at the +end of C. -=head2 new arguments -> object +=head2 C<< $object->BUILD(\%args) >> -Instantiates a new Mouse::Object. This is obviously intended for subclasses. +You may put any business logic initialization in BUILD methods. You don't +need to redispatch or return any specific value. -=head2 BUILDALL \%args +=head2 C<< $object->DEMOLISHALL >> -Calls L on each class in the class hierarchy. This is called at the -end of L. +Calls C on each class in the class hierarchy. This is called at +C time. -=head2 BUILD \%args +=head2 C<< $object->DEMOLISH >> -You may put any business logic initialization in BUILD methods. You don't +You may put any business logic deinitialization in DEMOLISH methods. You don't need to redispatch or return any specific value. -=head2 BUILDARGS +=head2 C<< $object->does($role_name) -> Bool >> -Lets you override the arguments that C takes. Return a hashref of -parameters. +This will check if the invocant's class B a given C<$role_name>. +This is similar to C for object, but it checks the roles instead. -=head2 DEMOLISHALL +=head2 C<< $object->dump($maxdepth) -> Str >> -Calls L on each class in the class hierarchy. This is called at -L 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 =cut