7 use Scalar::Util 'blessed';
9 use Mouse::Util qw(load_class not_supported);
24 our %is_removable = map{ $_ => undef } @EXPORT;
25 delete $is_removable{confess};
26 delete $is_removable{blessed};
29 my $meta = Mouse::Meta::Role->initialize(scalar caller);
33 $meta->add_before_method_modifier($_ => $code);
38 my $meta = Mouse::Meta::Role->initialize(scalar caller);
42 $meta->add_after_method_modifier($_ => $code);
47 my $meta = Mouse::Meta::Role->initialize(scalar caller);
51 $meta->add_around_method_modifier($_ => $code);
57 return unless $Mouse::SUPER_BODY;
58 $Mouse::SUPER_BODY->(@Mouse::SUPER_ARGS);
62 my $classname = caller;
63 my $meta = Mouse::Meta::Role->initialize($classname);
67 my $fullname = "${classname}::${name}";
70 && $meta->throw_error("Cannot add an override of method '$fullname' "
71 . "because there is a local version of '$fullname'");
73 $meta->add_override_method_modifier($name => sub {
74 local $Mouse::SUPER_PACKAGE = shift;
75 local $Mouse::SUPER_BODY = shift;
76 local @Mouse::SUPER_ARGS = @_;
82 # We keep the same errors messages as Moose::Role emits, here.
84 Carp::croak "Roles cannot support 'inner'";
88 Carp::croak "Roles cannot support 'augment'";
92 my $meta = Mouse::Meta::Role->initialize(scalar caller);
95 $meta->add_attribute($_ => @_) for ref($name) ? @{$name} : $name;
99 Carp::croak "Roles do not support 'extends'"
103 my $meta = Mouse::Meta::Role->initialize(scalar caller);
104 Mouse::Util::apply_all_roles($meta->name, @_);
108 my $meta = Mouse::Meta::Role->initialize(scalar caller);
109 $meta->throw_error("Must specify at least one method") unless @_;
110 $meta->add_required_methods(@_);
125 # we should never export to main
126 if ($caller eq 'main') {
127 warn qq{$class does not export its sugar to the 'main' package.\n};
131 Mouse::Meta::Role->initialize($caller)->add_method(meta => sub {
132 return Mouse::Meta::Role->initialize(ref($_[0]) || $_[0]);
135 Mouse::Role->export_to_level(1, @_);
146 for my $keyword (@EXPORT) {
148 if(exists $is_removable{$keyword}
149 && ($code = $caller->can($keyword))
150 && (Mouse::Util::get_code_info($code))[0] eq __PACKAGE__){
152 delete $stash->{$keyword};
164 Mouse::Role - The Mouse Role
173 =head2 C<< meta -> Mouse::Meta::Role >>
175 Returns this role's metaclass instance.
177 =head2 C<< before (method|methods) -> CodeRef >>
179 Sets up a B<before> method modifier. See L<Moose/before> or
180 L<Class::Method::Modifiers/before>.
182 =head2 C<< after (method|methods) => CodeRef >>
184 Sets up an B<after> method modifier. See L<Moose/after> or
185 L<Class::Method::Modifiers/after>.
187 =head2 C<< around (method|methods) => CodeRef >>
189 Sets up an B<around> method modifier. See L<Moose/around> or
190 L<Class::Method::Modifiers/around>.
194 Sets up the B<super> keyword. See L<Moose/super>.
196 =head2 C<< override method => CodeRef >>
198 Sets up an B<override> method modifier. See L<Moose/Role/override>.
202 This is not supported in roles and emits an error. See L<Moose/Role>.
204 =head2 C<< augment method => CodeRef >>
206 This is not supported in roles and emits an error. See L<Moose/Role>.
208 =head2 C<< has (name|names) => parameters >>
210 Sets up an attribute (or if passed an arrayref of names, multiple attributes) to
211 this role. See L<Mouse/has>.
213 =head2 C<< confess(error) -> BOOM >>
215 L<Carp/confess> for your convenience.
217 =head2 C<< blessed(value) -> ClassName | undef >>
219 L<Scalar::Util/blessed> for your convenience.
225 Importing Mouse::Role will give you sugar.
229 Please unimport (C<< no Mouse::Role >>) so that if someone calls one of the
230 keywords (such as L</has>) it will break loudly instead breaking subtly.