bump version to 1.15
[gitmo/Moose.git] / lib / Moose / Meta / Method / Overridden.pm
1 package Moose::Meta::Method::Overridden;
2
3 use strict;
4 use warnings;
5
6 our $VERSION   = '1.15';
7 $VERSION = eval $VERSION;
8 our $AUTHORITY = 'cpan:STEVAN';
9
10 use base 'Moose::Meta::Method';
11
12 sub 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 $super_package = $args{package} || $args{class}->name;
20
21     my $name = $args{name};
22
23     my $super = $args{class}->find_next_method_by_name($name);
24
25     (defined $super)
26         || $class->throw_error("You cannot override '$name' because it has no super method", data => $name);
27
28     my $super_body = $super->body;
29
30     my $method = $args{method};
31
32     my $body = sub {
33         local $Moose::SUPER_PACKAGE = $super_package;
34         local @Moose::SUPER_ARGS = @_;
35         local $Moose::SUPER_BODY = $super_body;
36         return $method->(@_);
37     };
38
39     # FIXME do we need this make sure this works for next::method?
40     # subname "${super_package}::${name}", $method;
41
42     # FIXME store additional attrs
43     $class->wrap(
44         $body,
45         package_name => $args{class}->name,
46         name         => $name
47     );
48 }
49
50 1;
51
52 __END__
53
54 =pod
55
56 =head1 NAME
57
58 Moose::Meta::Method::Overridden - A Moose Method metaclass for overridden methods
59
60 =head1 DESCRIPTION
61
62 This class implements method overriding logic for the L<Moose>
63 C<override> keyword.
64
65 The overriding subroutine's parent will be invoked explicitly using
66 the C<super> keyword from the parent class's method definition.
67
68 =head1 METHODS
69
70 =over 4
71
72 =item B<< Moose::Meta::Method::Overridden->new(%options) >>
73
74 This constructs a new object. It accepts the following options:
75
76 =over 8
77
78 =item * class
79
80 The metaclass object for the class in which the override is being
81 declared. This option is required.
82
83 =item * name
84
85 The name of the method which we are overriding. This method must exist
86 in one of the class's superclasses. This option is required.
87
88 =item * method
89
90 The subroutine reference which implements the overriding. This option
91 is required.
92
93 =back
94
95 =back
96
97 =head1 BUGS
98
99 See L<Moose/BUGS> for details on reporting bugs.
100
101 =head1 AUTHOR
102
103 Yuval Kogman E<lt>nothingmuch@cpan.orgE<gt>
104
105 =head1 COPYRIGHT AND LICENSE
106
107 Copyright 2006-2010 by Infinity Interactive, Inc.
108
109 L<http://www.iinteractive.com>
110
111 This library is free software; you can redistribute it and/or modify
112 it under the same terms as Perl itself.
113
114 =cut