X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=654fa50ce889ed7ef748a89529bec4e07906af73;hp=82cbec0d091ccfd870e010b68fb89dd7a01284ac;hb=e128626c409797822ffd8a4079f833eb3dc0fd37;hpb=c3398f5bd45f2851b7cd40ca9823bcf7d2378469 diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 82cbec0..654fa50 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,124 +1,77 @@ -#!/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}) { - if (ref($attribute->{default}) eq 'CODE') { - $instance->{$key} = $attribute->{default}->(); - Scalar::Util::weaken($instance->{$key}) - if $attribute->{weak_ref}; - } - else { - $instance->{$key} = $attribute->{default}; - Scalar::Util::weaken($instance->{$key}) - if $attribute->{weak_ref}; - } - } - } - else { - if ($attribute->{required}) { - confess "Attribute '$attribute->{name}' is required"; - } - } - } - - if (exists($args{$key})) { - $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; -} - -sub DESTROY { shift->DEMOLISHALL } - -sub BUILDALL { - my $self = shift; - - # short circuit - return unless $self->can('BUILD'); - - no strict 'refs'; - - for my $class ($self->meta->linearized_isa) { - my $code = *{ $class . '::BUILD' }{CODE} - or next; - $code->($self, @_); - } -} - -sub DEMOLISHALL { - my $self = shift; - - # short circuit - return unless $self->can('DEMOLISH'); - - no strict 'refs'; - - for my $class ($self->meta->linearized_isa) { - my $code = *{ $class . '::DEMOLISH' }{CODE} - or next; - $code->($self, @_); - } -} +use Mouse::Util qw(does dump meta); # enables strict and warnings -1; +sub new; +sub BUILDARGS; +sub BUILDALL; + +sub DESTROY; +sub DEMOLISHALL; +1; __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.50_01 =head1 METHODS -=head2 new arguments -> object +=head2 C<< new (Arguments) -> Object >> -Instantiates a new Mouse::Object. This is obviously intended for subclasses. +Instantiates a new C. This is obviously intended for subclasses. -=head2 BUILDALL \%args +=head2 C<< BUILDARGS (Arguments) -> HashRef >> -Calls L on each class in the class hierarchy. This is called at the -end of L. +Lets you override the arguments that C takes. Return a hashref of +parameters. -=head2 BUILD \%args +=head2 C<< BUILDALL (\%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<< 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 + =cut