lib/MooseX/AttributeHelpers/Base.pm

   1
   2 package MooseX::AttributeHelpers::Base;
   3 use Moose;
   4 use Moose::Util::TypeConstraints;
   5
   6 our $VERSION   = '0.01';
   7 our $AUTHORITY = 'cpan:STEVAN';
   8
   9 extends 'Moose::Meta::Attribute';
  10
  11 has 'method_constructors' => (
  12     is      => 'ro',
  13     isa     => 'HashRef',
  14     default => sub { {} }
  15 );
  16
  17 has 'provides' => (
  18     is       => 'ro',
  19     isa      => 'HashRef',
  20     required => 1,
  21 );
  22
  23 # extend the parents stuff to make sure
  24 # certain bits are now required ...
  25 has '+$!default'       => (required => 1);
  26 has '+type_constraint' => (required => 1);
  27
  28 ## Methods called prior to instantiation
  29
  30 sub helper_type { () }
  31
  32 sub process_options_for_provides {
  33     my ($self, $options) = @_;
  34
  35     if (my $type = $self->helper_type) {
  36         (exists $options->{isa})
  37             || confess "You must define a type with the $type metaclass";
  38
  39         my $isa = $options->{isa};
  40
  41         unless (blessed($isa) && $isa->isa('Moose::Meta::TypeConstraint')) {
  42             $isa = find_type_constraint($isa);
  43         }
  44
  45         ($isa->is_a_type_of($type))
  46             || confess "The type constraint for a $type ($options->{isa}) must be a subtype of $type";
  47     }
  48 }
  49
  50 before '_process_options' => sub {
  51     my ($self, $name, $options) = @_;
  52     if (exists $options->{provides}) {
  53         $self->process_options_for_provides($options);
  54     }
  55 };
  56
  57 ## methods called after instantiation
  58
  59 # this confirms that provides has
  60 # all valid possibilities in it
  61 sub check_provides_values {
  62     my $self = shift;
  63     my $method_constructors = $self->method_constructors;
  64     foreach my $key (keys %{$self->provides}) {
  65         (exists $method_constructors->{$key})
  66             || confess "$key is an unsupported method type";
  67     }
  68 }
  69
  70 after 'install_accessors' => sub {
  71     my $attr  = shift;
  72     my $class = $attr->associated_class;
  73
  74     # before we install them, lets
  75     # make sure they are valid
  76     $attr->check_provides_values;
  77
  78     my $method_constructors = $attr->method_constructors;
  79
  80     foreach my $key (keys %{$attr->provides}) {
  81         $class->add_method(
  82             $attr->provides->{$key},
  83             $method_constructors->{$key}->($attr)
  84         );
  85     }
  86 };
  87
  88 no Moose;
  89 no Moose::Util::TypeConstraints;
  90
  91 1;
  92
  93 __END__
  94
  95 =pod
  96
  97 =head1 NAME
  98
  99 MooseX::AttributeHelpers::Base
 100
 101 =head1 SYNOPSIS
 102
 103 =head1 DESCRIPTION
 104
 105 =head1 METHODS
 106
 107 =head1 BUGS
 108
 109 All complex software has bugs lurking in it, and this module is no
 110 exception. If you find a bug please either email me, or add the bug
 111 to cpan-RT.
 112
 113 =head1 AUTHOR
 114
 115 Stevan Little E<lt>stevan@iinteractive.comE<gt>
 116
 117 =head1 COPYRIGHT AND LICENSE
 118
 119 Copyright 2007 by Infinity Interactive, Inc.
 120
 121 L<http://www.iinteractive.com>
 122
 123 This library is free software; you can redistribute it and/or modify
 124 it under the same terms as Perl itself.
 125
 126 =cut