X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FRole.pm;h=e60776001d9fa37410f4577b9e7e59fdbe52faa4;hb=07d18a6b15d6d937a78ecd2dd24f5375f0096766;hp=3b455dedf2e837934de9e3c1bd586ab16fe38d10;hpb=0fc8adbcddaae0c610e5c1bc1beb067a9c265f69;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Role.pm b/lib/Mouse/Role.pm index 3b455de..e607760 100644 --- a/lib/Mouse/Role.pm +++ b/lib/Mouse/Role.pm @@ -1,79 +1,146 @@ -#!/usr/bin/env perl package Mouse::Role; use strict; use warnings; +use base 'Exporter'; -use Sub::Exporter; use Carp 'confess'; -use Scalar::Util; +use Scalar::Util 'blessed'; use Mouse::Meta::Role; -do { - my $CALLER; - - my %exports = ( - meta => sub { - my $meta = Mouse::Meta::Role->initialize($CALLER); - return sub { $meta }; - }, - extends => sub { - return sub { - confess "Role does not currently support 'extends'"; - } - }, - before => sub { - return sub { } - }, - after => sub { - return sub { } - }, - around => sub { - return sub { } - }, - has => sub { - my $caller = $CALLER; - return sub { - my $name = shift; - my @opts = @_; - - $caller->meta->add_attribute($name => \@opts); - } - }, - with => sub { - return sub { } - }, - requires => sub { - return sub { } - }, - excludes => sub { - return sub { } - }, - blessed => sub { - return \&Scalar::Util::blessed; - }, - confess => sub { - return \&Carp::confess; - }, - ); - - my $exporter = Sub::Exporter::build_exporter({ - exports => \%exports, - groups => { default => [':all'] }, - }); - - sub import { - $CALLER = caller; - - strict->import; - warnings->import; - - goto $exporter; +our @EXPORT = qw(before after around has extends with requires excludes confess blessed); + +sub before { + my $meta = Mouse::Meta::Role->initialize(caller); + + my $code = pop; + for (@_) { + $meta->add_before_method_modifier($_ => $code); + } +} + +sub after { + my $meta = Mouse::Meta::Role->initialize(caller); + + my $code = pop; + for (@_) { + $meta->add_after_method_modifier($_ => $code); } +} + +sub around { + my $meta = Mouse::Meta::Role->initialize(caller); - sub unimport { + my $code = pop; + for (@_) { + $meta->add_around_method_modifier($_ => $code); } -}; +} + +sub has { + my $meta = Mouse::Meta::Role->initialize(caller); + + my $name = shift; + my %opts = @_; + + $meta->add_attribute($name => \%opts); +} + +sub extends { confess "Roles do not support 'extends'" } + +sub with { + my $meta = Mouse::Meta::Role->initialize(caller); + my $role = shift; + my $args = shift || {}; + confess "Mouse::Role only supports 'with' on individual roles at a time" if @_ || !ref $args; + + Mouse::load_class($role); + $role->meta->apply($meta, %$args); +} + +sub requires { + my $meta = Mouse::Meta::Role->initialize(caller); + Carp::croak "Must specify at least one method" unless @_; + $meta->add_required_methods(@_); +} + +sub excludes { confess "Mouse::Role does not currently support 'excludes'" } + +sub import { + strict->import; + warnings->import; + + my $caller = caller; + my $meta = Mouse::Meta::Role->initialize(caller); + + no strict 'refs'; + no warnings 'redefine'; + *{$caller.'::meta'} = sub { $meta }; + + Mouse::Role->export_to_level(1, @_); +} + +sub unimport { + my $caller = caller; + + no strict 'refs'; + for my $keyword (@EXPORT) { + delete ${ $caller . '::' }{$keyword}; + } +} 1; +__END__ + +=head1 NAME + +Mouse::Role + +=head1 KEYWORDS + +=head2 meta -> Mouse::Meta::Role + +Returns this role's metaclass instance. + +=head2 before (method|methods) => Code + +Sets up a "before" method modifier. See L or +L. + +=head2 after (method|methods) => Code + +Sets up an "after" method modifier. See L or +L. + +=head2 around (method|methods) => Code + +Sets up an "around" method modifier. See L or +L. + +=head2 has (name|names) => parameters + +Sets up an attribute (or if passed an arrayref of names, multiple attributes) to +this role. See L. + +=head2 confess error -> BOOM + +L for your convenience. + +=head2 blessed value -> ClassName | undef + +L for your convenience. + +=head1 MISC + +=head2 import + +Importing Mouse::Role will give you sugar. + +=head2 unimport + +Please unimport Mouse (C) so that if someone calls one of the +keywords (such as L) it will break loudly instead breaking subtly. + +=cut +