2 use lib '/Users/stevan/Projects/Moose/Moose/Class-MOP/branches/Class-MOP-tranformations/lib';
9 use Scalar::Util 'blessed';
11 use Sub::Name 'subname';
15 our $VERSION = '0.06';
19 use Moose::Meta::Role;
20 use Moose::Util::TypeConstraints;
23 my ( $CALLER, %METAS );
28 return $METAS{$role} if exists $METAS{$role};
30 # make a subtype for each Moose class
33 => where { $_->does($role) }
34 => optimize_as { blessed($_[0]) && $_[0]->can('does') && $_[0]->does($role) }
35 unless find_type_constraint($role);
38 if ($role->can('meta')) {
39 $meta = $role->meta();
40 (blessed($meta) && $meta->isa('Moose::Meta::Role'))
41 || confess "You already have a &meta function, but it does not return a Moose::Meta::Role";
44 $meta = Moose::Meta::Role->initialize($role);
45 $meta->Moose::Meta::Class::add_method('meta' => sub { $meta })
48 return $METAS{$role} = $meta;
54 my $meta = _find_meta();
55 return subname 'Moose::Role::extends' => sub {
56 confess "Moose::Role does not currently support 'extends'"
60 my $meta = _find_meta();
61 return subname 'Moose::Role::with' => sub (@) {
63 confess "Must specify at least one role" unless @roles;
64 Moose::_load_all_classes(@roles);
65 ($_->can('meta') && $_->meta->isa('Moose::Meta::Role'))
66 || confess "You can only consume roles, $_ is not a Moose role"
68 if (scalar @roles == 1) {
69 $roles[0]->meta->apply($meta);
72 Moose::Meta::Role->combine(
73 map { $_->meta } @roles
79 my $meta = _find_meta();
80 return subname 'Moose::Role::requires' => sub (@) {
81 confess "Must specify at least one method" unless @_;
82 $meta->add_required_methods(@_);
86 my $meta = _find_meta();
87 return subname 'Moose::Role::excludes' => sub (@) {
88 confess "Must specify at least one role" unless @_;
89 $meta->add_excluded_roles(@_);
93 my $meta = _find_meta();
94 return subname 'Moose::Role::has' => sub ($;%) {
95 my ($name, %options) = @_;
96 $meta->add_attribute($name, %options)
100 my $meta = _find_meta();
101 return subname 'Moose::Role::before' => sub (@&) {
103 $meta->add_before_method_modifier($_, $code) for @_;
107 my $meta = _find_meta();
108 return subname 'Moose::Role::after' => sub (@&) {
110 $meta->add_after_method_modifier($_, $code) for @_;
114 my $meta = _find_meta();
115 return subname 'Moose::Role::around' => sub (@&) {
117 $meta->add_around_method_modifier($_, $code) for @_;
121 my $meta = _find_meta();
122 return subname 'Moose::Role::super' => sub {};
125 my $meta = _find_meta();
126 return subname 'Moose::Role::override' => sub ($&) {
127 my ($name, $code) = @_;
128 $meta->add_override_method_modifier($name, $code);
132 my $meta = _find_meta();
133 return subname 'Moose::Role::inner' => sub {
134 confess "Moose::Role cannot support 'inner'";
138 my $meta = _find_meta();
139 return subname 'Moose::Role::augment' => sub {
140 confess "Moose::Role cannot support 'augment'";
144 return \&Carp::confess;
147 return \&Scalar::Util::blessed;
151 my $exporter = Sub::Exporter::build_exporter({
152 exports => \%exports,
164 # we should never export to main
165 return if $CALLER eq 'main';
180 Moose::Role - The Moose Role
192 my ($self, $other) = @_;
193 !$self->equal($other);
196 # ... then in your classes
206 my ($self, $other) = @_;
207 $self->as_float == $other->as_float;
212 Role support in Moose is coming along quite well. It's best documentation
213 is still the the test suite, but it is fairly safe to assume Perl 6 style
214 behavior, and then either refer to the test suite, or ask questions on
215 #moose if something doesn't quite do what you expect. More complete
216 documentation is planned and will be included with the next official
217 (non-developer) release.
219 =head1 EXPORTED FUNCTIONS
221 Currently Moose::Role supports all of the functions that L<Moose> exports,
222 but differs slightly in how some items are handled (see L<CAVEATS> below
225 Moose::Role also offers two role specific keyword exports:
229 =item B<requires (@method_names)>
231 Roles can require that certain methods are implemented by any class which
234 =item B<excludes (@role_names)>
236 Roles can C<exclude> other roles, in effect saying "I can never be combined
237 with these C<@role_names>". This is a feature which should not be used
244 The role support now has only a few caveats. They are as follows:
250 Roles cannot use the C<extends> keyword, it will throw an exception for now.
251 The same is true of the C<augment> and C<inner> keywords (not sure those
252 really make sense for roles). All other Moose keywords will be I<deferred>
253 so that they can be applied to the consuming class.
257 Role composition does it's best to B<not> be order sensitive when it comes
258 to conflict resolution and requirements detection. However, it is order
259 sensitive when it comes to method modifiers. All before/around/after modifiers
260 are included whenever a role is composed into a class, and then are applied
261 in the order the roles are used. This too means that there is no conflict for
262 before/around/after modifiers as well.
264 In most cases, this will be a non issue, however it is something to keep in
265 mind when using method modifiers in a role. You should never assume any
270 The C<requires> keyword currently only works with actual methods. A method
271 modifier (before/around/after and override) will not count as a fufillment
272 of the requirement, and neither will an autogenerated accessor for an attribute.
274 It is likely that the attribute accessors will eventually be allowed to fufill
275 those requirements, either that or we will introduce a C<requires_attr> keyword
276 of some kind instead. This descision has not yet been finalized.
282 All complex software has bugs lurking in it, and this module is no
283 exception. If you find a bug please either email me, or add the bug
288 Stevan Little E<lt>stevan@iinteractive.comE<gt>
290 Christian Hansen E<lt>chansen@cpan.orgE<gt>
292 =head1 COPYRIGHT AND LICENSE
294 Copyright 2006 by Infinity Interactive, Inc.
296 L<http://www.iinteractive.com>
298 This library is free software; you can redistribute it and/or modify
299 it under the same terms as Perl itself.