X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FMethod.pm;h=06123a61549ad21fcf4119e4841610c3bf83141e;hb=6d2118a4bab44f7bfbd3b6c4534c77ed3a4b9f02;hp=874159a4a0197064ff7c3f3df28b189af55559ff;hpb=2eb717d56ee2a062202c58c415f4e56bcb90b40a;p=gitmo%2FClass-MOP.git diff --git a/lib/Class/MOP/Method.pm b/lib/Class/MOP/Method.pm index 874159a..06123a6 100644 --- a/lib/Class/MOP/Method.pm +++ b/lib/Class/MOP/Method.pm @@ -5,24 +5,207 @@ use strict; use warnings; use Carp 'confess'; -use Scalar::Util 'reftype'; +use Scalar::Util 'reftype', 'blessed'; +use B 'svref_2object'; -use Class::MOP::Class; +our $VERSION = '0.04'; +our $AUTHORITY = 'cpan:STEVAN'; -our $VERSION = '0.01'; +use base 'Class::MOP::Object'; -sub meta { Class::MOP::Class->initialize($_[0]) } +# NOTE: +# if poked in the right way, +# they should act like CODE refs. +use overload '&{}' => sub { $_[0]->{body} }, fallback => 1; + +# introspection + +sub meta { + require Class::MOP::Class; + Class::MOP::Class->initialize(blessed($_[0]) || $_[0]); +} + +# construction sub wrap { my $class = shift; my $code = shift; - - (reftype($code) && reftype($code) eq 'CODE') - || confess "You must supply a CODE reference to wrap"; - - bless $code => $class; + ('CODE' eq (reftype($code) || '')) + || confess "You must supply a CODE reference to bless, not (" . ($code || 'undef') . ")"; + bless { + body => $code + } => blessed($class) || $class; +} + +## accessors + +sub body { (shift)->{body} } + +# TODO - add associated_class + +# informational + +# NOTE: +# this may not be the same name +# as the class you got it from +# This gets the package stash name +# associated with the actual CODE-ref +sub package_name { + my $code = (shift)->{body}; + svref_2object($code)->GV->STASH->NAME; } - + +# NOTE: +# this may not be the same name +# as the method name it is stored +# with. This gets the name associated +# with the actual CODE-ref +sub name { + my $code = (shift)->{body}; + svref_2object($code)->GV->NAME; +} + +sub fully_qualified_name { + my $code = shift; + $code->package_name . '::' . $code->name; +} + +package Class::MOP::Method::Wrapped; + +use strict; +use warnings; + +use Carp 'confess'; +use Scalar::Util 'reftype', 'blessed'; +use Sub::Name 'subname'; + +our $VERSION = '0.02'; +our $AUTHORITY = 'cpan:STEVAN'; + +use base 'Class::MOP::Method'; + +# NOTE: +# this ugly beast is the result of trying +# to micro optimize this as much as possible +# while not completely loosing maintainability. +# At this point it's "fast enough", after all +# you can't get something for nothing :) +my $_build_wrapped_method = sub { + my $modifier_table = shift; + my ($before, $after, $around) = ( + $modifier_table->{before}, + $modifier_table->{after}, + $modifier_table->{around}, + ); + if (@$before && @$after) { + $modifier_table->{cache} = sub { + $_->(@_) for @{$before}; + my @rval; + ((defined wantarray) ? + ((wantarray) ? + (@rval = $around->{cache}->(@_)) + : + ($rval[0] = $around->{cache}->(@_))) + : + $around->{cache}->(@_)); + $_->(@_) for @{$after}; + return unless defined wantarray; + return wantarray ? @rval : $rval[0]; + } + } + elsif (@$before && !@$after) { + $modifier_table->{cache} = sub { + $_->(@_) for @{$before}; + return $around->{cache}->(@_); + } + } + elsif (@$after && !@$before) { + $modifier_table->{cache} = sub { + my @rval; + ((defined wantarray) ? + ((wantarray) ? + (@rval = $around->{cache}->(@_)) + : + ($rval[0] = $around->{cache}->(@_))) + : + $around->{cache}->(@_)); + $_->(@_) for @{$after}; + return unless defined wantarray; + return wantarray ? @rval : $rval[0]; + } + } + else { + $modifier_table->{cache} = $around->{cache}; + } +}; + +sub wrap { + my $class = shift; + my $code = shift; + (blessed($code) && $code->isa('Class::MOP::Method')) + || confess "Can only wrap blessed CODE"; + my $modifier_table = { + cache => undef, + orig => $code, + before => [], + after => [], + around => { + cache => $code->body, + methods => [], + }, + }; + $_build_wrapped_method->($modifier_table); + my $method = $class->SUPER::wrap(sub { $modifier_table->{cache}->(@_) }); + $method->{modifier_table} = $modifier_table; + $method; +} + +sub get_original_method { + my $code = shift; + $code->{modifier_table}->{orig}; +} + +sub add_before_modifier { + my $code = shift; + my $modifier = shift; + unshift @{$code->{modifier_table}->{before}} => $modifier; + $_build_wrapped_method->($code->{modifier_table}); +} + +sub add_after_modifier { + my $code = shift; + my $modifier = shift; + push @{$code->{modifier_table}->{after}} => $modifier; + $_build_wrapped_method->($code->{modifier_table}); +} + +{ + # NOTE: + # this is another possible canidate for + # optimization as well. There is an overhead + # associated with the currying that, if + # eliminated might make around modifiers + # more manageable. + my $compile_around_method = sub {{ + my $f1 = pop; + return $f1 unless @_; + my $f2 = pop; + push @_, sub { $f2->( $f1, @_ ) }; + redo; + }}; + + sub add_around_modifier { + my $code = shift; + my $modifier = shift; + unshift @{$code->{modifier_table}->{around}->{methods}} => $modifier; + $code->{modifier_table}->{around}->{cache} = $compile_around_method->( + @{$code->{modifier_table}->{around}->{methods}}, + $code->{modifier_table}->{orig}->body + ); + $_build_wrapped_method->($code->{modifier_table}); + } +} + 1; __END__ @@ -35,26 +218,81 @@ Class::MOP::Method - Method Meta Object =head1 SYNOPSIS + # ... more to come later maybe + =head1 DESCRIPTION The Method Protocol is very small, since methods in Perl 5 are just -subroutines within the particular package. Basically all we do is to -bless the subroutine and provide some very simple introspection -methods for it. +subroutines within the particular package. We provide a very basic +introspection interface. + +This also contains the Class::MOP::Method::Wrapped subclass, which +provides the features for before, after and around method modifiers. =head1 METHODS +=head2 Introspection + +=over 4 + +=item B + +This will return a B instance which is related +to this class. + +=back + +=head2 Construction + =over 4 =item B -=item B +=back + +=head2 Informational + +=over 4 + +=item B + +=item B + +=item B + +=item B =back -=head1 AUTHOR +=head1 Class::MOP::Method::Wrapped METHODS -Stevan Little Estevan@iinteractive.comE +=head2 Construction + +=over 4 + +=item B + +=item B + +=back + +=head2 Modifiers + +=over 4 + +=item B + +=item B + +=item B + +=back + +=head1 AUTHORS + +Stevan Little Estevan@iinteractive.comE + +Yuval Kogman Enothingmuch@woobling.comE =head1 COPYRIGHT AND LICENSE @@ -65,4 +303,5 @@ L This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. -=cut \ No newline at end of file +=cut +