8 use Mouse::Util qw(not_supported);
13 Mouse::Exporter->setup_import_methods(
23 \&Scalar::Util::blessed,
30 my $meta = Mouse::Meta::Role->initialize(scalar caller);
34 $meta->add_before_method_modifier($_ => $code);
39 my $meta = Mouse::Meta::Role->initialize(scalar caller);
43 $meta->add_after_method_modifier($_ => $code);
48 my $meta = Mouse::Meta::Role->initialize(scalar caller);
52 $meta->add_around_method_modifier($_ => $code);
58 return if !defined $Mouse::SUPER_BODY;
59 $Mouse::SUPER_BODY->(@Mouse::SUPER_ARGS);
63 # my($name, $code) = @_;
64 Mouse::Meta::Role->initialize(scalar caller)->add_override_method_modifier(@_);
67 # We keep the same errors messages as Moose::Role emits, here.
69 Carp::croak "Roles cannot support 'inner'";
73 Carp::croak "Roles cannot support 'augment'";
77 my $meta = Mouse::Meta::Role->initialize(scalar caller);
80 $meta->add_attribute($_ => @_) for ref($name) ? @{$name} : $name;
84 Carp::croak "Roles do not support 'extends'"
88 my $meta = Mouse::Meta::Role->initialize(scalar caller);
89 Mouse::Util::apply_all_roles($meta->name, @_);
93 my $meta = Mouse::Meta::Role->initialize(scalar caller);
94 $meta->throw_error("Must specify at least one method") unless @_;
95 $meta->add_required_methods(@_);
103 my($class, %args) = @_;
105 my $for_class = $args{for_class}
106 or Carp::confess("Cannot call init_meta without specifying a for_class");
108 my $metaclass = $args{metaclass} || 'Mouse::Meta::Role';
110 my $meta = $metaclass->initialize($for_class);
112 $meta->add_method(meta => sub{
113 $metaclass->initialize(ref($_[0]) || $_[0]);
125 Mouse::Role - The Mouse Role
134 =head2 C<< meta -> Mouse::Meta::Role >>
136 Returns this role's metaclass instance.
138 =head2 C<< before (method|methods) -> CodeRef >>
140 Sets up a B<before> method modifier. See L<Moose/before> or
141 L<Class::Method::Modifiers/before>.
143 =head2 C<< after (method|methods) => CodeRef >>
145 Sets up an B<after> method modifier. See L<Moose/after> or
146 L<Class::Method::Modifiers/after>.
148 =head2 C<< around (method|methods) => CodeRef >>
150 Sets up an B<around> method modifier. See L<Moose/around> or
151 L<Class::Method::Modifiers/around>.
155 Sets up the B<super> keyword. See L<Moose/super>.
157 =head2 C<< override method => CodeRef >>
159 Sets up an B<override> method modifier. See L<Moose/Role/override>.
163 This is not supported in roles and emits an error. See L<Moose/Role>.
165 =head2 C<< augment method => CodeRef >>
167 This is not supported in roles and emits an error. See L<Moose/Role>.
169 =head2 C<< has (name|names) => parameters >>
171 Sets up an attribute (or if passed an arrayref of names, multiple attributes) to
172 this role. See L<Mouse/has>.
174 =head2 C<< confess(error) -> BOOM >>
176 L<Carp/confess> for your convenience.
178 =head2 C<< blessed(value) -> ClassName | undef >>
180 L<Scalar::Util/blessed> for your convenience.
186 Importing Mouse::Role will give you sugar.
190 Please unimport (C<< no Mouse::Role >>) so that if someone calls one of the
191 keywords (such as L</has>) it will break loudly instead breaking subtly.