X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FMethod.pm;h=ab56ffc7544b101f12765a0b82380bb76a4e656a;hb=71b98d4fae80b55fd5b03142fae05b625b03d328;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..ab56ffc 100644 --- a/lib/Class/MOP/Method.pm +++ b/lib/Class/MOP/Method.pm @@ -5,64 +5,199 @@ use strict; use warnings; use Carp 'confess'; -use Scalar::Util 'reftype'; +use Scalar::Util 'weaken'; -use Class::MOP::Class; +our $VERSION = '0.65'; +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; -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; +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 wrap { + my ( $class, @args ) = @_; + + unshift @args, 'body' if @args % 2 == 1; + + my %params = @args; + my $code = $params{body}; + + ('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"; + + my $self = (ref($class) || $class)->_new(%params); + + weaken($self->{associated_metaclass}) if $self->{associated_metaclass}; + + return $self; +} + +sub _new { + my ( $class, %params ) = @_; + + my $self = bless { + 'body' => $params{body}, + 'associated_metaclass' => $params{associated_metaclass}, + 'package_name' => $params{package_name}, + 'name' => $params{name}, + } => $class; +} + +## accessors + +sub body { (shift)->{'body'} } + +sub associated_metaclass { shift->{'associated_metaclass'} } + +sub attach_to_class { + my ( $self, $class ) = @_; + $self->{associated_metaclass} = $class; + weaken($self->{associated_metaclass}); } - + +sub detach_from_class { + my $self = shift; + delete $self->{associated_metaclass}; +} + +sub package_name { + my $self = shift; + $self->{'package_name'} ||= (Class::MOP::get_code_info($self->body))[0]; +} + +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 - =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. +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 -=over 4 +=head2 Introspection -=item B +=over 4 =item B +This will return a B instance which is related +to this class. + =back -=head1 AUTHOR +=head2 Construction + +=over 4 -Stevan Little Estevan@iinteractive.comE +=item B + +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 + +=head2 Informational + +=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 + +The metaclass of the method + +=item B + +This returns the package name that the CODE reference is attached to. + +=item B + +This returns the fully qualified name of the CODE reference. + +=back + +=head2 Metaclass + +=over 4 + +=item B + +Sets the associated metaclass + +=item B + +Disassociates the method from the metaclass + +=back + +=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