Bump version to 1.9900 for new version numbering scheme
[gitmo/Moose.git] / lib / Moose / Meta / Method / Augmented.pm
CommitLineData
3f9e4b0a 1package Moose::Meta::Method::Augmented;
2
3use strict;
4use warnings;
5
bb8ef151 6our $VERSION = '1.9900';
e606ae5f 7$VERSION = eval $VERSION;
3f9e4b0a 8our $AUTHORITY = 'cpan:STEVAN';
9
10use base 'Moose::Meta::Method';
11
3f9e4b0a 12sub new {
13 my ( $class, %args ) = @_;
14
15 # the package can be overridden by roles
16 # it is really more like body's compilation stash
17 # this is where we need to override the definition of super() so that the
18 # body of the code can call the right overridden version
19 my $name = $args{name};
20 my $meta = $args{class};
21
22 my $super = $meta->find_next_method_by_name($name);
23
24 (defined $super)
3e504337 25 || $meta->throw_error("You cannot augment '$name' because it has no super method", data => $name);
3f9e4b0a 26
27 my $_super_package = $super->package_name;
6549b0d1 28 # BUT!,... if this is an overridden method ....
74862722 29 if ($super->isa('Moose::Meta::Method::Overridden')) {
3f9e4b0a 30 # we need to be sure that we actually
31 # find the next method, which is not
32 # an 'override' method, the reason is
33 # that an 'override' method will not
34 # be the one calling inner()
35 my $real_super = $meta->_find_next_method_by_name_which_is_not_overridden($name);
36 $_super_package = $real_super->package_name;
37 }
38
39 my $super_body = $super->body;
40
41 my $method = $args{method};
42
43 my $body = sub {
44 local $Moose::INNER_ARGS{$_super_package} = [ @_ ];
45 local $Moose::INNER_BODY{$_super_package} = $method;
46 $super_body->(@_);
47 };
48
49 # FIXME store additional attrs
1b2aea39 50 $class->wrap(
51 $body,
52 package_name => $meta->name,
53 name => $name
54 );
3f9e4b0a 55}
56
571;
58
59__END__
60
61=pod
62
63=head1 NAME
64
65Moose::Meta::Method::Augmented - A Moose Method metaclass for augmented methods
66
67=head1 DESCRIPTION
68
c03bf2a6 69This class implements method augmentation logic for the L<Moose>
70C<augment> keyword.
3f9e4b0a 71
c03bf2a6 72The augmentation subroutine reference will be invoked explicitly using
73the C<inner> keyword from the parent class's method definition.
3f9e4b0a 74
c03bf2a6 75=head1 INHERITANCE
76
77C<Moose::Meta::Method::Augmented> is a subclass of L<Moose::Meta::Method>.
3f9e4b0a 78
79=head1 METHODS
80
81=over 4
82
c03bf2a6 83=item B<< Moose::Meta::Method::Augmented->new(%options) >>
84
85This constructs a new object. It accepts the following options:
86
87=over 8
88
89=item * class
90
91The metaclass object for the class in which the augmentation is being
92declared. This option is required.
93
94=item * name
95
96The name of the method which we are augmenting. This method must exist
97in one of the class's superclasses. This option is required.
98
99=item * method
100
101The subroutine reference which implements the augmentation. This
102option is required.
103
104=back
3f9e4b0a 105
106=back
107
108=head1 BUGS
109
d4048ef3 110See L<Moose/BUGS> for details on reporting bugs.
3f9e4b0a 111
112=head1 AUTHOR
113
6c36eeaa 114Yuval Kogman E<lt>nothingmuch@cpan.orgE<gt>
3f9e4b0a 115
116=head1 COPYRIGHT AND LICENSE
117
7e0492d3 118Copyright 2006-2010 by Infinity Interactive, Inc.
3f9e4b0a 119
120L<http://www.iinteractive.com>
121
122This library is free software; you can redistribute it and/or modify
123it under the same terms as Perl itself.
124
125=cut