package Mouse::Role;
-use Mouse::Util qw(not_supported); # enables strict and warnings
+use Mouse::Exporter; # enables strict and warnings
-use Carp qw(confess);
+our $VERSION = '0.84';
+
+use Carp qw(confess);
use Scalar::Util qw(blessed);
use Mouse ();
-use Mouse::Exporter;
Mouse::Exporter->setup_import_methods(
as_is => [qw(
],
);
-# XXX: for backward compatibility
-our @EXPORT = qw(
- extends with
- has
- before after around
- override super
- augment inner
- requires excludes
+sub extends {
+ Carp::croak "Roles do not support 'extends'";
+}
- blessed confess
-);
+sub with {
+ Mouse::Util::apply_all_roles(scalar(caller), @_);
+ return;
+}
-sub before {
+sub has {
my $meta = Mouse::Meta::Role->initialize(scalar caller);
+ my $name = shift;
+
+ $meta->throw_error(q{Usage: has 'name' => ( key => value, ... )})
+ if @_ % 2; # odd number of arguments
+ for my $n(ref($name) ? @{$name} : $name){
+ $meta->add_attribute($n => @_);
+ }
+ return;
+}
+
+sub before {
+ my $meta = Mouse::Meta::Role->initialize(scalar caller);
my $code = pop;
- for (@_) {
- $meta->add_before_method_modifier($_ => $code);
+ for my $name($meta->_collect_methods(@_)) {
+ $meta->add_before_method_modifier($name => $code);
}
+ return;
}
sub after {
my $meta = Mouse::Meta::Role->initialize(scalar caller);
-
my $code = pop;
- for (@_) {
- $meta->add_after_method_modifier($_ => $code);
+ for my $name($meta->_collect_methods(@_)) {
+ $meta->add_after_method_modifier($name => $code);
}
+ return;
}
sub around {
my $meta = Mouse::Meta::Role->initialize(scalar caller);
-
my $code = pop;
- for (@_) {
- $meta->add_around_method_modifier($_ => $code);
+ for my $name($meta->_collect_methods(@_)) {
+ $meta->add_around_method_modifier($name => $code);
}
+ return;
}
sub override {
# my($name, $code) = @_;
Mouse::Meta::Role->initialize(scalar caller)->add_override_method_modifier(@_);
+ return;
}
# We keep the same errors messages as Moose::Role emits, here.
Carp::croak "Roles cannot support 'augment'";
}
-sub has {
- my $meta = Mouse::Meta::Role->initialize(scalar caller);
- my $name = shift;
-
- $meta->add_attribute($_ => @_) for ref($name) ? @{$name} : $name;
-}
-
-sub extends {
- Carp::croak "Roles do not support 'extends'"
-}
-
-sub with {
- my $meta = Mouse::Meta::Role->initialize(scalar caller);
- Mouse::Util::apply_all_roles($meta->name, @_);
-}
-
sub requires {
my $meta = Mouse::Meta::Role->initialize(scalar caller);
$meta->throw_error("Must specify at least one method") unless @_;
$meta->add_required_methods(@_);
+ return;
}
sub excludes {
- not_supported;
+ Mouse::Util::not_supported();
}
sub init_meta{
=head1 VERSION
-This document describes Mouse version 0.37_06
+This document describes Mouse version 0.84
=head1 SYNOPSIS
- package MyRole;
- use Mouse::Role;
+ package Comparable;
+ use Mouse::Role; # the package is now a Mouse role
+
+ # Declare methods that are required by this role
+ requires qw(compare);
+
+ # Define methods this role provides
+ sub equals {
+ my($self, $other) = @_;
+ return $self->compare($other) == 0;
+ }
+
+ # and later
+ package MyObject;
+ use Mouse;
+ with qw(Comparable); # Now MyObject can equals()
+
+ sub compare {
+ # ...
+ }
+
+ my $foo = MyObject->new();
+ my $bar = MyObject->new();
+ $obj->equals($bar); # yes, it is comparable
=head1 KEYWORDS
Returns this role's metaclass instance.
-=head2 C<< before (method|methods) -> CodeRef >>
+=head2 C<< before (method|methods|regexp) -> CodeRef >>
-Sets up a B<before> method modifier. See L<Moose/before> or
-L<Class::Method::Modifiers/before>.
+Sets up a B<before> method modifier. See L<Moose/before>.
-=head2 C<< after (method|methods) => CodeRef >>
+=head2 C<< after (method|methods|regexp) => CodeRef >>
-Sets up an B<after> method modifier. See L<Moose/after> or
-L<Class::Method::Modifiers/after>.
+Sets up an B<after> method modifier. See L<Moose/after>.
-=head2 C<< around (method|methods) => CodeRef >>
+=head2 C<< around (method|methods|regexp) => CodeRef >>
-Sets up an B<around> method modifier. See L<Moose/around> or
-L<Class::Method::Modifiers/around>.
+Sets up an B<around> method modifier. See L<Moose/around>.
=head2 C<super>