X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FRole.pm;h=511a4e56cdb87617cdf9f0db6a5f03b364edf3b6;hp=7530423fa2af0a890e11fd3065fb005995c78484;hb=013ee5f0c0ce5afa1fea9d45bd14bd8f8bfd67f4;hpb=f9e68395ec48e239c2a2c77d15399aac9497b937 diff --git a/lib/Mouse/Role.pm b/lib/Mouse/Role.pm index 7530423..511a4e5 100644 --- a/lib/Mouse/Role.pm +++ b/lib/Mouse/Role.pm @@ -1,33 +1,218 @@ -#!/usr/bin/env perl package Mouse::Role; -use strict; -use warnings; +use Mouse::Exporter; # enables strict and warnings -use Sub::Exporter; +our $VERSION = '0.50'; -do { - my $CALLER; +use Carp qw(confess); +use Scalar::Util qw(blessed); - my %exports = ( - ); +use Mouse::Util qw(not_supported); +use Mouse::Meta::Role; +use Mouse (); - my $exporter = Sub::Exporter::build_exporter({ - exports => \%exports, - groups => { default => [':all'] }, - }); +Mouse::Exporter->setup_import_methods( + as_is => [qw( + extends with + has + before after around + override super + augment inner + + requires excludes + ), + \&Scalar::Util::blessed, + \&Carp::confess, + ], +); + + +sub extends { + Carp::croak "Roles do not support 'extends'"; +} - sub import { - $CALLER = caller; +sub with { + my $meta = Mouse::Meta::Role->initialize(scalar caller); + Mouse::Util::apply_all_roles($meta->name, @_); + return; +} + +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 + + if(ref $name){ # has [qw(foo bar)] => (...) + for (@{$name}){ + $meta->add_attribute($_ => @_); + } + } + else{ # has foo => (...) + $meta->add_attribute($name => @_); + } + return; +} - strict->import; - warnings->import; +sub before { + my $meta = Mouse::Meta::Role->initialize(scalar caller); + my $code = pop; + for my $name($meta->_collect_methods(@_)) { + $meta->add_before_method_modifier($name => $code); + } + return; +} - goto $exporter; +sub after { + my $meta = Mouse::Meta::Role->initialize(scalar caller); + my $code = pop; + for my $name($meta->_collect_methods(@_)) { + $meta->add_after_method_modifier($name => $code); } + return; +} - sub unimport { +sub around { + my $meta = Mouse::Meta::Role->initialize(scalar caller); + my $code = pop; + for my $name($meta->_collect_methods(@_)) { + $meta->add_around_method_modifier($name => $code); } -}; + return; +} + + +sub super { + return if !defined $Mouse::SUPER_BODY; + $Mouse::SUPER_BODY->(@Mouse::SUPER_ARGS); +} + +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. +sub inner { + Carp::croak "Roles cannot support 'inner'"; +} + +sub augment { + Carp::croak "Roles cannot support 'augment'"; +} + +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; +} + +sub init_meta{ + shift; + my %args = @_; + + my $class = $args{for_class} + or Carp::confess("Cannot call init_meta without specifying a for_class"); + + my $metaclass = $args{metaclass} || 'Mouse::Meta::Role'; + + my $meta = $metaclass->initialize($class); + + $meta->add_method(meta => sub{ + $metaclass->initialize(ref($_[0]) || $_[0]); + }); + + # make a role type for each Mouse role + Mouse::Util::TypeConstraints::role_type($class) + unless Mouse::Util::TypeConstraints::find_type_constraint($class); + + return $meta; +} 1; +__END__ + +=head1 NAME + +Mouse::Role - The Mouse Role + +=head1 VERSION + +This document describes Mouse version 0.50 + +=head1 SYNOPSIS + + package MyRole; + use Mouse::Role; + +=head1 KEYWORDS + +=head2 C<< meta -> Mouse::Meta::Role >> + +Returns this role's metaclass instance. + +=head2 C<< before (method|methods) -> CodeRef >> + +Sets up a B method modifier. See L. + +=head2 C<< after (method|methods) => CodeRef >> + +Sets up an B method modifier. See L. + +=head2 C<< around (method|methods) => CodeRef >> + +Sets up an B method modifier. See L. + +=head2 C + +Sets up the B keyword. See L. + +=head2 C<< override method => CodeRef >> + +Sets up an B method modifier. See L. + +=head2 C + +This is not supported in roles and emits an error. See L. + +=head2 C<< augment method => CodeRef >> + +This is not supported in roles and emits an error. See L. + +=head2 C<< has (name|names) => parameters >> + +Sets up an attribute (or if passed an arrayref of names, multiple attributes) to +this role. See L. + +=head2 C<< confess(error) -> BOOM >> + +L for your convenience. + +=head2 C<< blessed(value) -> ClassName | undef >> + +L for your convenience. + +=head1 MISC + +=head2 import + +Importing Mouse::Role will give you sugar. + +=head2 unimport + +Please unimport (C<< no Mouse::Role >>) so that if someone calls one of the +keywords (such as L) it will break loudly instead breaking subtly. + +=head1 SEE ALSO + +L + +=cut +