X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FRole.pm;h=e27f1849dafa9d5d25410ee9c73f4c4e17bde6be;hb=c7d8fe950098e91780355ed7a91f066e682eb4a3;hp=0f2ef34e81daf62c3727b3eebb96034a90b5c289;hpb=401cb5a6726b7cafba114173ac335613b8d854c7;p=gitmo%2FMoose.git diff --git a/lib/Moose/Role.pm b/lib/Moose/Role.pm index 0f2ef34..e27f184 100644 --- a/lib/Moose/Role.pm +++ b/lib/Moose/Role.pm @@ -5,12 +5,13 @@ use strict; use warnings; use Scalar::Util 'blessed'; -use Carp 'confess'; +use Carp 'confess', 'croak'; use Data::OptList; use Sub::Exporter; -our $VERSION = '0.09'; +our $VERSION = '0.55_02'; +$VERSION = eval $VERSION; our $AUTHORITY = 'cpan:STEVAN'; use Moose (); @@ -19,166 +20,130 @@ use Moose::Util (); use Moose::Meta::Role; use Moose::Util::TypeConstraints; -{ - my ( $CALLER, %METAS ); +sub extends { + croak "Roles do not currently support 'extends'"; +} + +sub with { + Moose::Util::apply_all_roles( Moose::Meta::Role->initialize(shift), @_ ); +} + +sub requires { + my $meta = Moose::Meta::Role->initialize(shift); + croak "Must specify at least one method" unless @_; + $meta->add_required_methods(@_); +} + +sub excludes { + my $meta = Moose::Meta::Role->initialize(shift); + croak "Must specify at least one role" unless @_; + $meta->add_excluded_roles(@_); +} - sub _find_meta { - my $role = $CALLER; +sub has { + my $meta = Moose::Meta::Role->initialize(shift); + my $name = shift; + croak 'Usage: has \'name\' => ( key => value, ... )' if @_ == 1; + my %options = @_; + my $attrs = ( ref($name) eq 'ARRAY' ) ? $name : [ ($name) ]; + $meta->add_attribute( $_, %options ) for @$attrs; +} - return $METAS{$role} if exists $METAS{$role}; +sub before { + my $meta = Moose::Meta::Role->initialize(shift); + my $code = pop @_; - # make a subtype for each Moose class - role_type $role unless find_type_constraint($role); + for (@_) { + croak "Moose::Role do not currently support " + . ref($_) + . " references for before method modifiers" + if ref $_; + $meta->add_before_method_modifier( $_, $code ); + } +} - my $meta; - if ($role->can('meta')) { - $meta = $role->meta(); - (blessed($meta) && $meta->isa('Moose::Meta::Role')) - || confess "You already have a &meta function, but it does not return a Moose::Meta::Role"; - } - else { - $meta = Moose::Meta::Role->initialize($role); - $meta->alias_method('meta' => sub { $meta }); - } +sub after { + my $meta = Moose::Meta::Role->initialize(shift); - return $METAS{$role} = $meta; + my $code = pop @_; + for (@_) { + croak "Moose::Role do not currently support " + . ref($_) + . " references for after method modifiers" + if ref $_; + $meta->add_after_method_modifier( $_, $code ); } +} + +sub around { + my $meta = Moose::Meta::Role->initialize(shift); + my $code = pop @_; + for (@_) { + croak "Moose::Role do not currently support " + . ref($_) + . " references for around method modifiers" + if ref $_; + $meta->add_around_method_modifier( $_, $code ); + } +} +# see Moose.pm for discussion +sub super { + return unless $Moose::SUPER_BODY; + $Moose::SUPER_BODY->(@Moose::SUPER_ARGS); +} + +sub override { + my $meta = Moose::Meta::Role->initialize(shift); + my ( $name, $code ) = @_; + $meta->add_override_method_modifier( $name, $code ); +} + +sub inner { + croak "Moose::Role cannot support 'inner'"; +} + +sub augment { + croak "Moose::Role cannot support 'augment'"; +} - my %exports = ( - extends => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::extends' => sub { - confess "Moose::Role does not currently support 'extends'" - }); - }, - with => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::with' => sub (@) { - Moose::Util::apply_all_roles($meta, @_) - }); - }, - requires => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::requires' => sub (@) { - confess "Must specify at least one method" unless @_; - $meta->add_required_methods(@_); - }); - }, - excludes => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::excludes' => sub (@) { - confess "Must specify at least one role" unless @_; - $meta->add_excluded_roles(@_); - }); - }, - has => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::has' => sub ($;%) { - my ($name, %options) = @_; - $meta->add_attribute($name, %options) - }); - }, - before => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::before' => sub (@&) { - my $code = pop @_; - do { - confess "Moose::Role do not currently support " - . ref($_) - . " references for before method modifiers" - if ref $_; - $meta->add_before_method_modifier($_, $code) - } for @_; - }); - }, - after => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::after' => sub (@&) { - my $code = pop @_; - do { - confess "Moose::Role do not currently support " - . ref($_) - . " references for after method modifiers" - if ref $_; - $meta->add_after_method_modifier($_, $code) - } for @_; - }); - }, - around => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::around' => sub (@&) { - my $code = pop @_; - do { - confess "Moose::Role do not currently support " - . ref($_) - . " references for around method modifiers" - if ref $_; - $meta->add_around_method_modifier($_, $code) - } for @_; - }); - }, - # see Moose.pm for discussion - super => sub { - return Class::MOP::subname('Moose::Role::super' => sub { - return unless $Moose::SUPER_BODY; $Moose::SUPER_BODY->(@Moose::SUPER_ARGS) - }); - }, - override => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::override' => sub ($&) { - my ($name, $code) = @_; - $meta->add_override_method_modifier($name, $code); - }); - }, - inner => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::inner' => sub { - confess "Moose::Role cannot support 'inner'"; - }); - }, - augment => sub { - my $meta = _find_meta(); - return Class::MOP::subname('Moose::Role::augment' => sub { - confess "Moose::Role cannot support 'augment'"; - }); - }, - confess => sub { - return \&Carp::confess; - }, - blessed => sub { - return \&Scalar::Util::blessed; - } - ); - - my $exporter = Sub::Exporter::build_exporter({ - exports => \%exports, - groups => { - default => [':all'] - } - }); - - sub import { - $CALLER = - ref $_[1] && defined $_[1]->{into} ? $_[1]->{into} - : ref $_[1] - && defined $_[1]->{into_level} ? caller( $_[1]->{into_level} ) - : caller(); - - # this works because both pragmas set $^H (see perldoc perlvar) - # which affects the current compilation - i.e. the file who use'd - # us - which is why we don't need to do anything special to make - # it affect that file rather than this one (which is already compiled) - - strict->import; - warnings->import; - - # we should never export to main - return if $CALLER eq 'main'; - - goto $exporter; - }; +my $exporter = Moose::Exporter->setup_import_methods( + with_caller => [ + qw( with requires excludes has before after around override make_immutable ) + ], + as_is => [ + qw( extends super inner augment ), + \&Carp::confess, + \&Scalar::Util::blessed, + ], +); + +sub init_meta { + shift; + my %args = @_; + + my $role = $args{for_class} + or confess + "Cannot call init_meta without specifying a for_class"; + + my $metaclass = $args{metaclass} || "Moose::Meta::Role"; + + # make a subtype for each Moose class + role_type $role unless find_type_constraint($role); + + # FIXME copy from Moose.pm + my $meta; + if ($role->can('meta')) { + $meta = $role->meta(); + (blessed($meta) && $meta->isa('Moose::Meta::Role')) + || confess "You already have a &meta function, but it does not return a Moose::Meta::Role"; + } + else { + $meta = $metaclass->initialize($role); + $meta->alias_method('meta' => sub { $meta }); + } + return $meta; } 1; @@ -248,6 +213,21 @@ lightly. =back +=head2 B + +Moose::Role offers a way to remove the keywords it exports, through the +C method. You simply have to say C at the bottom of +your code for this to work. + +=head2 B<< Moose::Role->init_meta(for_class => $role, metaclass => $metaclass) >> + +The C method sets up the metaclass object for the role +specified by C. It also injects a a C accessor into +the role so you can get at this object. + +The default metaclass is L. You can specify an +alternate metaclass with the C parameter. + =head1 CAVEATS Role support has only a few caveats: