2 package Moose::AttributeHelpers::Trait::Base;
4 use Moose::Util::TypeConstraints;
7 $VERSION = eval $VERSION;
8 our $AUTHORITY = 'cpan:STEVAN';
10 requires 'helper_type';
12 # these next two are the possible methods
13 # you can use in the 'handles' map.
15 # provide a Class or Role which we can
16 # collect the method providers from
18 # requires_attr 'method_provider'
20 # or you can provide a HASH ref of anon subs
21 # yourself. This will also collect and store
22 # the methods from a method_provider as well
23 has 'method_constructors' => (
29 return +{} unless $self->has_method_provider;
30 # or grab them from the role/class
31 my $method_provider = $self->method_provider->meta;
34 $_ => $method_provider->get_method($_)
35 } $method_provider->get_method_list
40 # extend the parents stuff to make sure
41 # certain bits are now required ...
42 has '+default' => (required => 1);
43 has '+type_constraint' => (required => 1);
45 ## Methods called prior to instantiation
47 sub process_options_for_handles {
48 my ($self, $options) = @_;
50 if (my $type = $self->helper_type) {
51 (exists $options->{isa})
52 || confess "You must define a type with the $type metaclass";
54 my $isa = $options->{isa};
56 unless (blessed($isa) && $isa->isa('Moose::Meta::TypeConstraint')) {
57 $isa = Moose::Util::TypeConstraints::find_or_create_type_constraint($isa);
60 ($isa->is_a_type_of($type))
61 || confess "The type constraint for a $type ($options->{isa}) must be a subtype of $type";
65 before '_process_options' => sub {
66 my ($self, $name, $options) = @_;
67 $self->process_options_for_handles($options, $name);
70 around '_canonicalize_handles' => sub {
73 my $handles = $self->handles;
74 return unless $handles;
75 unless ('HASH' eq ref $handles) {
77 "The 'handles' option must be a HASH reference, not $handles"
81 my $to = $handles->{$_};
82 $to = [ $to ] unless ref $to;
87 ## methods called after instantiation
89 before 'install_accessors' => sub { (shift)->check_handles_values };
91 sub check_handles_values {
94 my $method_constructors = $self->method_constructors;
96 my %handles = $self->_canonicalize_handles;
98 for my $original_method (values %handles) {
99 my $name = $original_method->[0];
100 (exists $method_constructors->{$name})
101 || confess "$name is an unsupported method type";
106 around '_make_delegation_method' => sub {
108 my ($self, $handle_name, $method_to_call) = @_;
110 my ($name, $curried_args) = @$method_to_call;
112 $curried_args ||= [];
114 my $method_constructors = $self->method_constructors;
116 my $code = $method_constructors->{$name}->(
118 $self->get_read_method_ref,
119 $self->get_write_method_ref,
126 my $instance = shift;
127 return $code->($instance, @$curried_args, @_);
133 no Moose::Util::TypeConstraints;
141 Moose::AttributeHelpers::Trait::Base - base role for helpers
145 =head2 check_handles_values
147 Confirms that handles has all valid possibilities in it.
149 =head2 process_options_for_handles
151 Ensures that the type constraint (C<isa>) matches the helper type.
155 All complex software has bugs lurking in it, and this module is no
156 exception. If you find a bug please either email me, or add the bug
167 =head1 COPYRIGHT AND LICENSE
169 Copyright 2007-2009 by Infinity Interactive, Inc.
171 L<http://www.iinteractive.com>
173 This library is free software; you can redistribute it and/or modify
174 it under the same terms as Perl itself.