1 package Mouse::Meta::Role;
2 use Mouse::Util qw(:meta); # enables strict and warnings
4 use Mouse::Meta::Module;
5 our @ISA = qw(Mouse::Meta::Module);
15 $args{attributes} = {};
16 $args{required_methods} = [];
19 my $self = bless \%args, ref($class) || $class;
20 if($class ne __PACKAGE__){
21 $self->meta->_initialize_object($self, \%args);
28 return $self->create(undef, @_);
35 sub calculate_all_roles {
38 return grep { !$seen{ $_->name }++ }
39 ($self, map { $_->calculate_all_roles } @{ $self->get_roles });
42 sub get_required_method_list{
43 return @{ $_[0]->{required_methods} };
46 sub add_required_methods {
47 my($self, @methods) = @_;
48 my %required = map{ $_ => 1 } @{$self->{required_methods}};
49 push @{$self->{required_methods}}, grep{ !$required{$_}++ && !$self->has_method($_) } @methods;
54 my($self, $name) = @_;
55 return scalar( grep{ $_ eq $name } @{ $self->{required_methods} } ) != 0;
62 $self->{attributes}->{$name} = (@_ == 1) ? $_[0] : { @_ };
70 require 'Mouse/Meta/Role/Application.pm';
71 return Mouse::Meta::Role::Application->new(@_)->apply($self, $consumer);
75 my($self, @role_specs) = @_;
77 require 'Mouse/Meta/Role/Composite.pm';
78 my $composite = Mouse::Meta::Role::Composite->create_anon_role();
80 foreach my $role_spec (@role_specs) {
81 my($role, $args) = @{$role_spec};
82 $role->apply($composite, %{$args});
87 sub add_before_method_modifier;
88 sub add_around_method_modifier;
89 sub add_after_method_modifier;
91 sub get_before_method_modifiers;
92 sub get_around_method_modifiers;
93 sub get_after_method_modifiers;
95 sub add_override_method_modifier{
96 my($self, $method_name, $method) = @_;
98 if($self->has_method($method_name)){
99 # This error happens in the override keyword or during role composition,
100 # so I added a message, "A local method of ...", only for compatibility (gfx)
101 $self->throw_error("Cannot add an override of method '$method_name' "
102 . "because there is a local version of '$method_name'"
103 . "(A local method of the same name as been found)");
106 $self->{override_method_modifiers}->{$method_name} = $method;
109 sub get_override_method_modifier {
110 my ($self, $method_name) = @_;
111 return $self->{override_method_modifiers}->{$method_name};
115 my ($self, $role_name) = @_;
118 || $self->throw_error("You must supply a role name to look for");
120 $role_name = $role_name->name if ref $role_name;
122 # if we are it,.. then return true
123 return 1 if $role_name eq $self->name;
124 # otherwise.. check our children
125 for my $role (@{ $self->get_roles }) {
126 return 1 if $role->does_role($role_name);
136 Mouse::Meta::Role - The Mouse Role metaclass
140 This document describes Mouse version 0.70
144 This class is a meta object protocol for Mouse roles,
145 which is a subset of Moose::Meta:::Role.