X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FMethod.pm;h=02bc341231838a19dc8cf1d964f46ab1001ed527;hb=ebce55398177423965f0582686a812fe79e20d70;hp=c4aa8527206135e91f05a5bfcb56d8472fa399e3;hpb=de19f1153a5df8765eae928ea430b7acab545554;p=gitmo%2FClass-MOP.git diff --git a/lib/Class/MOP/Method.pm b/lib/Class/MOP/Method.pm index c4aa852..02bc341 100644 --- a/lib/Class/MOP/Method.pm +++ b/lib/Class/MOP/Method.pm @@ -5,115 +5,89 @@ use strict; use warnings; use Carp 'confess'; -use Scalar::Util 'reftype', 'blessed'; -use B 'svref_2object'; +use Scalar::Util 'blessed'; -our $VERSION = '0.02'; +our $VERSION = '0.62'; +our $AUTHORITY = 'cpan:STEVAN'; -# introspection +use base 'Class::MOP::Object'; -sub meta { - require Class::MOP::Class; - Class::MOP::Class->initialize(blessed($_[0]) || $_[0]); -} +# NOTE: +# if poked in the right way, +# they should act like CODE refs. +use overload '&{}' => sub { $_[0]->body }, fallback => 1; + +our $UPGRADE_ERROR_TEXT = q{ +--------------------------------------------------------- +NOTE: this error is likely not an error, but a regression +caused by the latest upgrade to Moose/Class::MOP. Consider +upgrading any MooseX::* modules to their latest versions +before spending too much time chasing this one down. +--------------------------------------------------------- +}; # construction -sub new { - my $class = shift; - my $code = shift; - (reftype($code) && reftype($code) eq 'CODE') - || confess "You must supply a CODE reference to bless"; - bless $code => blessed($class) || $class; -} +sub wrap { + my ( $class, $code, %params ) = @_; -{ - my %MODIFIERS; - - sub wrap { - my $code = shift; - (blessed($code)) - || confess "Can only ask the package name of a blessed CODE"; - my $modifier_table = { before => [], after => [] }; - my $method = $code->new(sub { - $_->(@_) for @{$modifier_table->{before}}; - # NOTE: - # we actually need to be sure to preserve - # the calling context and call this method - # with the same context too. This just - # requires some bookkeeping code, thats all. - my @rval = $code->(@_); - $_->(@_) for @{$modifier_table->{after}}; - return wantarray ? @rval : $rval[0]; - }); - $MODIFIERS{$method} = $modifier_table; - $method; - } - - sub add_before_modifier { - my $code = shift; - my $modifier = shift; - (exists $MODIFIERS{$code}) - || confess "You must first wrap your method before adding a modifier"; - (blessed($code)) - || confess "Can only ask the package name of a blessed CODE"; - (reftype($modifier) && reftype($modifier) eq 'CODE') - || confess "You must supply a CODE reference for a modifier"; - unshift @{$MODIFIERS{$code}->{before}} => $modifier; - } - - sub add_after_modifier { - my $code = shift; - my $modifier = shift; - (exists $MODIFIERS{$code}) - || confess "You must first wrap your method before adding a modifier"; - (blessed($code)) - || confess "Can only ask the package name of a blessed CODE"; - (reftype($modifier) && reftype($modifier) eq 'CODE') - || confess "You must supply a CODE reference for a modifier"; - push @{$MODIFIERS{$code}->{after}} => $modifier; - } + ('CODE' eq ref($code)) + || confess "You must supply a CODE reference to bless, not (" . ($code || 'undef') . ")"; + + ($params{package_name} && $params{name}) + || confess "You must supply the package_name and name parameters $UPGRADE_ERROR_TEXT"; + + bless { + '&!body' => $code, + '$!package_name' => $params{package_name}, + '$!name' => $params{name}, + } => blessed($class) || $class; } +## accessors + +sub body { (shift)->{'&!body'} } + +# TODO - add associated_class + # informational -sub package_name { - my $code = shift; - (blessed($code)) - || confess "Can only ask the package name of a blessed CODE"; - svref_2object($code)->GV->STASH->NAME; +sub package_name { + my $self = shift; + $self->{'$!package_name'} ||= (Class::MOP::get_code_info($self->body))[0]; } -sub name { - my $code = shift; - (blessed($code)) - || confess "Can only ask the package name of a blessed CODE"; - svref_2object($code)->GV->NAME; +sub name { + my $self = shift; + $self->{'$!name'} ||= (Class::MOP::get_code_info($self->body))[1]; } +sub fully_qualified_name { + my $code = shift; + $code->package_name . '::' . $code->name; +} + +# NOTE: +# the Class::MOP bootstrap +# will create this for us +# - SL +# sub clone { ... } + 1; __END__ =pod -=head1 NAME +=head1 NAME 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. - -Currently this package is largely unused. Future plans are to provide -some very simple introspection methods for the methods themselves. -Suggestions for this are welcome. +The Method Protocol is very small, since methods in Perl 5 are just +subroutines within the particular package. We provide a very basic +introspection interface. =head1 METHODS @@ -123,7 +97,7 @@ Suggestions for this are welcome. =item B -This will return a B instance which is related +This will return a B instance which is related to this class. =back @@ -132,9 +106,18 @@ to this class. =over 4 -=item B +=item B -This simply blesses the C<&code> reference passed to it. +This is the basic constructor, it returns a B +instance which wraps the given C<$code> reference. You can also +set the C and C attributes using the C<%params>. +If these are not set, then thier accessors will attempt to figure +it out using the C function. + +=item B + +This will make a copy of the object, allowing you to override +any values by stuffing them in C<%params>. =back @@ -142,29 +125,36 @@ This simply blesses the C<&code> reference passed to it. =over 4 +=item B + +This returns the actual CODE reference of the particular instance. + =item B +This returns the name of the CODE reference. + =item B -=back +This returns the package name that the CODE reference is attached to. -=head1 SEE ALSO +=item B -http://dirtsimple.org/2005/01/clos-style-method-combination-for.html +This returns the fully qualified name of the CODE reference. -http://www.gigamonkeys.com/book/object-reorientation-generic-functions.html +=back -=head1 AUTHOR +=head1 AUTHORS Stevan Little Estevan@iinteractive.comE =head1 COPYRIGHT AND LICENSE -Copyright 2006 by Infinity Interactive, Inc. +Copyright 2006-2008 by Infinity Interactive, Inc. L This library is free software; you can redistribute it and/or modify -it under the same terms as Perl itself. +it under the same terms as Perl itself. + +=cut -=cut \ No newline at end of file