-#!/usr/bin/env perl
package Mouse::Role;
use strict;
use warnings;
use base 'Exporter';
-use Carp 'confess';
-use Mouse::Util 'blessed';
+use Carp 'confess', 'croak';
+use Scalar::Util 'blessed';
use Mouse::Meta::Role;
+use Mouse::Util;
-our @EXPORT = qw(before after around has extends with requires excludes confess blessed);
+our @EXPORT = qw(before after around super override inner augment has extends with requires excludes confess blessed);
+our %is_removable = map{ $_ => undef } @EXPORT;
+delete $is_removable{confess};
+delete $is_removable{blessed};
sub before {
- my $meta = Mouse::Meta::Role->initialize(caller);
+ my $meta = Mouse::Meta::Role->initialize(scalar caller);
my $code = pop;
for (@_) {
}
sub after {
- my $meta = Mouse::Meta::Role->initialize(caller);
+ my $meta = Mouse::Meta::Role->initialize(scalar caller);
my $code = pop;
for (@_) {
}
sub around {
- my $meta = Mouse::Meta::Role->initialize(caller);
+ my $meta = Mouse::Meta::Role->initialize(scalar caller);
my $code = pop;
for (@_) {
}
}
+
+sub super {
+ return unless $Mouse::SUPER_BODY;
+ $Mouse::SUPER_BODY->(@Mouse::SUPER_ARGS);
+}
+
+sub override {
+ my $classname = caller;
+ my $meta = Mouse::Meta::Role->initialize($classname);
+
+ my $name = shift;
+ my $code = shift;
+ my $fullname = "${classname}::${name}";
+
+ defined &$fullname
+ && confess "Cannot add an override of method '$fullname' " .
+ "because there is a local version of '$fullname'";
+
+ $meta->add_override_method_modifier($name => sub {
+ local $Mouse::SUPER_PACKAGE = shift;
+ local $Mouse::SUPER_BODY = shift;
+ local @Mouse::SUPER_ARGS = @_;
+
+ $code->(@_);
+ });
+}
+
+# We keep the same errors messages as Moose::Role emits, here.
+sub inner {
+ croak "Moose::Role cannot support 'inner'";
+}
+
+sub augment {
+ croak "Moose::Role cannot support 'augment'";
+}
+
sub has {
- my $meta = Mouse::Meta::Role->initialize(caller);
+ my $meta = Mouse::Meta::Role->initialize(scalar caller);
my $name = shift;
my %opts = @_;
$meta->add_attribute($name => \%opts);
}
-sub extends { confess "Roles do not support 'extends'" }
+sub extends { confess "Roles do not currently support 'extends'" }
-sub with { confess "Mouse::Role does not currently support 'with'" }
+sub with {
+ my $meta = Mouse::Meta::Role->initialize(scalar 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);
+ my $meta = Mouse::Meta::Role->initialize(scalar 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 {
+ my $class = shift;
+
strict->import;
warnings->import;
my $caller = caller;
- my $meta = Mouse::Meta::Role->initialize(caller);
- no strict 'refs';
- no warnings 'redefine';
- *{$caller.'::meta'} = sub { $meta };
+ # we should never export to main
+ if ($caller eq 'main') {
+ warn qq{$class does not export its sugar to the 'main' package.\n};
+ return;
+ }
+
+ Mouse::Meta::Role->initialize($caller)->add_method(meta => sub {
+ return Mouse::Meta::Role->initialize(ref($_[0]) || $_[0]);
+ });
Mouse::Role->export_to_level(1, @_);
}
sub unimport {
my $caller = caller;
- no strict 'refs';
+ my $stash = do{
+ no strict 'refs';
+ \%{$caller . '::'}
+ };
+
for my $keyword (@EXPORT) {
- delete ${ $caller . '::' }{$keyword};
+ my $code;
+ if(exists $is_removable{$keyword}
+ && ($code = $caller->can($keyword))
+ && (Mouse::Util::get_code_info($code))[0] eq __PACKAGE__){
+
+ delete $stash->{$keyword};
+ }
}
+ return;
}
1;
=head1 NAME
-Mouse::Role
+Mouse::Role - define a role in Mouse
=head1 KEYWORDS
Sets up an "around" method modifier. See L<Moose/around> or
L<Class::Method::Modifiers/around>.
+=over 4
+
+=item B<super>
+
+Sets up the "super" keyword. See L<Moose/super>.
+
+=item B<override ($name, &sub)>
+
+Sets up an "override" method modifier. See L<Moose/Role/override>.
+
+=item B<inner>
+
+This is not supported and emits an error. See L<Moose/Role>.
+
+=item B<augment ($name, &sub)>
+
+This is not supported and emits an error. See L<Moose/Role>.
+
+=back
+
=head2 has (name|names) => parameters
Sets up an attribute (or if passed an arrayref of names, multiple attributes) to