X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FMeta%2FRole%2FComposite.pm;h=c7c5d451a6a6811f69d1dbf748f3b21f1086d096;hb=6fdf3dfaab2a36f6a73204759df23782f0b1940f;hp=8d4690a957660f3ff38130b806e6a90b74f6ded0;hpb=0779da922a64aa891bc2708b6fc8de4d4fdffa11;p=gitmo%2FMoose.git diff --git a/lib/Moose/Meta/Role/Composite.pm b/lib/Moose/Meta/Role/Composite.pm index 8d4690a..c7c5d45 100644 --- a/lib/Moose/Meta/Role/Composite.pm +++ b/lib/Moose/Meta/Role/Composite.pm @@ -4,26 +4,26 @@ use strict; use warnings; use metaclass; -use Carp 'confess'; use Scalar::Util 'blessed'; -our $VERSION = '0.56'; +our $VERSION = '0.88'; +$VERSION = eval $VERSION; our $AUTHORITY = 'cpan:STEVAN'; use base 'Moose::Meta::Role'; # NOTE: -# we need to override the ->name +# we need to override the ->name # method from Class::MOP::Package -# since we don't have an actual +# since we don't have an actual # package for this. # - SL __PACKAGE__->meta->add_attribute('name' => (reader => 'name')); # NOTE: -# Again, since we don't have a real -# package to store our methods in, -# we use a HASH ref instead. +# Again, since we don't have a real +# package to store our methods in, +# we use a HASH ref instead. # - SL __PACKAGE__->meta->add_attribute('methods' => ( reader => 'get_method_map', @@ -33,32 +33,43 @@ __PACKAGE__->meta->add_attribute('methods' => ( sub new { my ($class, %params) = @_; # the roles param is required ... - ($_->isa('Moose::Meta::Role')) - || confess "The list of roles must be instances of Moose::Meta::Role, not $_" - foreach @{$params{roles}}; + foreach ( @{$params{roles}} ) { + unless ( $_->isa('Moose::Meta::Role') ) { + require Moose; + Moose->throw_error("The list of roles must be instances of Moose::Meta::Role, not $_"); + } + } # and the name is created from the # roles if one has not been provided $params{name} ||= (join "|" => map { $_->name } @{$params{roles}}); $class->_new(\%params); } -# NOTE: -# we need to override this cause -# we dont have that package I was -# talking about above. -# - SL -sub alias_method { +# This is largely a cope of what's in Moose::Meta::Role (itself +# largely a copy of Class::MOP::Class). However, we can't actually +# call add_package_symbol, because there's no package to which which +# add the symbol. +sub add_method { my ($self, $method_name, $method) = @_; - (defined $method_name && $method_name) - || confess "You must define a method name"; - # make sure to bless the - # method if nessecary - $method = $self->method_metaclass->wrap( - $method, - package_name => $self->name, - name => $method_name - ) if !blessed($method); + unless ( defined $method_name && $method_name ) { + Moose->throw_error("You must define a method name"); + } + + my $body; + if (blessed($method)) { + $body = $method->body; + if ($method->package_name ne $self->name) { + $method = $method->clone( + package_name => $self->name, + name => $method_name + ) if $method->can('clone'); + } + } + else { + $body = $method; + $method = $self->wrap_method_body( body => $body, name => $method_name ); + } $self->get_method_map->{$method_name} = $method; } @@ -75,19 +86,36 @@ Moose::Meta::Role::Composite - An object to represent the set of roles =head1 DESCRIPTION +A composite is a role that consists of a set of two or more roles. + +The API of a composite role is almost identical to that of a regular +role. + +=head1 INHERITANCE + +C is a subclass of L. + =head2 METHODS =over 4 -=item B +=item B<< Moose::Meta::Role::Composite->new(%options) >> + +This returns a new composite role object. It accepts the same +options as its parent class, with a few changes: + +=over 8 -=item B +=item * roles -=item B +This option is an array reference containing a list of +L object. This is a required option. -=item B +=item * name -=item B +If a name is not given, one is generated from the roles provided. + +=back =back @@ -103,7 +131,7 @@ Stevan Little Estevan@iinteractive.comE =head1 COPYRIGHT AND LICENSE -Copyright 2006-2008 by Infinity Interactive, Inc. +Copyright 2006-2009 by Infinity Interactive, Inc. L