X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=7f205482e6ae1f359dba6774312b435a023e6d78;hp=2138adf8df5119e3a71b0207eb8bcc6453ce71e4;hb=8aba926dbf11e9cf418c7c79b925d15e60e1e990;hpb=28d269491e4b8dad61231390965529c3993a2ba5 diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 2138adf..7f20548 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,81 +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 (!exists($args{$from})) { - 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"; - } - } - } - - if (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); - } - } - } - - $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; @@ -83,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 { @@ -98,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; @@ -113,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_07 =head1 METHODS -=head2 new arguments -> object +=head2 C<< new (Arguments) -> Object >> + +Instantiates a new C. 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 takes. Return a hashref of +parameters. -Calls L on each class in the class hierarchy. This is called at the -end of L. +=head2 C<< BUILDALL (\%args) >> -=head2 BUILD \%args +Calls C on each class in the class hierarchy. This is called at the +end of C. + +=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 on each class in the class hierarchy. This is called at -L time. +Calls C on each class in the class hierarchy. This is called at +C 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 a given C<$role_name>. +This is similar to "isa" for object, but it checks the roles instead. + +=head2 C< 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 + =cut