X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=5a327fe5a33368de52a0872a054abe2e94e11ffc;hp=4af0f3957d5d6f1f5342c90a21e61e831bfdd909;hb=01e830f796a9ecdec0d977f2b88110363ebf013f;hpb=f89acace2fa0fd5e6b8c4ac40ab1794f1ca62887 diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 4af0f39..5a327fe 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,133 +1,77 @@ -#!/usr/bin/env perl package Mouse::Object; -use strict; -use warnings; -use MRO::Compat; +use Mouse::Util qw(does dump meta); # enables strict and warnings -use Scalar::Util qw/blessed weaken/; -use Carp 'confess'; +sub new; +sub BUILDARGS; +sub BUILDALL; -sub new { - my $class = shift; - my %args = @_; - my $instance = bless {}, $class; +sub DESTROY; +sub DEMOLISHALL; - for my $attribute (values %{ $class->meta->get_attribute_map }) { - my $key = $attribute->init_arg; - my $default; - - if (!exists($args{$key})) { - 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 $attribute->weak_ref; - } - } - else { - if ($attribute->is_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}; +1; +__END__ - weaken($instance->{$key}) - if $attribute->weak_ref; +=head1 NAME - if ($attribute->has_trigger) { - $attribute->trigger->($instance, $args{$key}, $attribute); - } - } - } +Mouse::Object - The base object for Mouse classes - $instance->BUILDALL(\%args); +=head1 VERSION - return $instance; -} +This document describes Mouse version 0.49 -sub DESTROY { shift->DEMOLISHALL } +=head1 METHODS -sub BUILDALL { - my $self = shift; +=head2 C<< new (Arguments) -> Object >> - # short circuit - return unless $self->can('BUILD'); +Instantiates a new C. This is obviously intended for subclasses. - no strict 'refs'; +=head2 C<< BUILDARGS (Arguments) -> HashRef >> - for my $class ($self->meta->linearized_isa) { - my $code = *{ $class . '::BUILD' }{CODE} - or next; - $code->($self, @_); - } -} +Lets you override the arguments that C takes. Return a hashref of +parameters. -sub DEMOLISHALL { - my $self = shift; +=head2 C<< BUILDALL (\%args) >> - # short circuit - return unless $self->can('DEMOLISH'); +Calls C on each class in the class hierarchy. This is called at the +end of C. - no strict 'refs'; +=head2 C<< BUILD (\%args) >> - for my $class ($self->meta->linearized_isa) { - my $code = *{ $class . '::DEMOLISH' }{CODE} - or next; - $code->($self, @_); - } -} +You may put any business logic initialization in BUILD methods. You don't +need to redispatch or return any specific value. -1; +=head2 C<< DEMOLISHALL >> -__END__ +Calls C on each class in the class hierarchy. This is called at +C time. -=head1 NAME +=head2 C<< DEMOLISH >> -Mouse::Object - we don't need to steenkin' constructor +You may put any business logic deinitialization in DEMOLISH methods. You don't +need to redispatch or return any specific value. -=head1 METHODS -=head2 new arguments -> object +=head2 C<< does ($role_name) -> Bool >> -Instantiates a new Mouse::Object. This is obviously intended for subclasses. +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 BUILDALL \%args +=head2 C<< dump ($maxdepth) -> Str >> -Calls L on each class in the class hierarchy. This is called at the -end of L. +From the Moose POD: -=head2 BUILD \%args + C'mon, how many times have you written the following code while debugging: -You may put any business logic initialization in BUILD methods. You don't -need to redispatch or return any specific value. + use Data::Dumper; + warn Dumper $obj; -=head2 DEMOLISHALL + It can get seriously annoying, so why not just use this. -Calls L on each class in the class hierarchy. This is called at -L time. +The implementation was lifted directly from Moose::Object. -=head2 DEMOLISH +=head1 SEE ALSO -You may put any business logic deinitialization in DEMOLISH methods. You don't -need to redispatch or return any specific value. +L =cut