lib/Moose/Meta/TypeConstraint/Role.pm

   1 package Moose::Meta::TypeConstraint::Role;
   2
   3 use strict;
   4 use warnings;
   5 use metaclass;
   6
   7 use Scalar::Util 'blessed';
   8 use Moose::Util::TypeConstraints ();
   9
  10 our $VERSION   = '0.61';
  11 $VERSION = eval $VERSION;
  12 our $AUTHORITY = 'cpan:STEVAN';
  13
  14 use base 'Moose::Meta::TypeConstraint';
  15
  16 __PACKAGE__->meta->add_attribute('role' => (
  17     reader => 'role',
  18 ));
  19
  20 sub new {
  21     my ( $class, %args ) = @_;
  22
  23     $args{parent} = Moose::Util::TypeConstraints::find_type_constraint('Role');
  24     my $self      = $class->_new(\%args);
  25
  26     $self->_create_hand_optimized_type_constraint;
  27     $self->compile_type_constraint();
  28
  29     return $self;
  30 }
  31
  32 sub _create_hand_optimized_type_constraint {
  33     my $self = shift;
  34     my $role = $self->role;
  35     $self->hand_optimized_type_constraint(
  36         sub { Moose::Util::does_role($_[0], $role) }
  37     );
  38 }
  39
  40 sub parents {
  41     my $self = shift;
  42     return (
  43         $self->parent,
  44         map {
  45             # FIXME find_type_constraint might find a TC named after the role but that isn't really it
  46             # I did this anyway since it's a convention that preceded TypeConstraint::Role, and it should DWIM
  47             # if anybody thinks this problematic please discuss on IRC.
  48             # a possible fix is to add by attr indexing to the type registry to find types of a certain property
  49             # regardless of their name
  50             Moose::Util::TypeConstraints::find_type_constraint($_)
  51                 ||
  52             __PACKAGE__->new( role => $_, name => "__ANON__" )
  53         } @{ $self->role->meta->get_roles },
  54     );
  55 }
  56
  57 sub equals {
  58     my ( $self, $type_or_name ) = @_;
  59
  60     my $other = Moose::Util::TypeConstraints::find_type_constraint($type_or_name);
  61
  62     return unless defined $other;
  63     return unless $other->isa(__PACKAGE__);
  64
  65     return $self->role eq $other->role;
  66 }
  67
  68 sub is_a_type_of {
  69     my ($self, $type_or_name) = @_;
  70
  71     my $type = Moose::Util::TypeConstraints::find_type_constraint($type_or_name);
  72
  73     ($self->equals($type) || $self->is_subtype_of($type_or_name));
  74 }
  75
  76 sub is_subtype_of {
  77     my ($self, $type_or_name_or_role ) = @_;
  78
  79     if ( not ref $type_or_name_or_role ) {
  80         # it might be a role
  81         return 1 if $self->role->meta->does_role( $type_or_name_or_role );
  82     }
  83
  84     my $type = Moose::Util::TypeConstraints::find_type_constraint($type_or_name_or_role);
  85
  86     return unless defined $type;
  87
  88     if ( $type->isa(__PACKAGE__) ) {
  89         # if $type_or_name_or_role isn't a role, it might be the TC name of another ::Role type
  90         # or it could also just be a type object in this branch
  91         return $self->role->meta->does_role( $type->role );
  92     } else {
  93         # the only other thing we are a subtype of is Object
  94         $self->SUPER::is_subtype_of($type);
  95     }
  96 }
  97
  98 sub create_child_type {
  99     my ($self, @args) = @_;
 100     return Moose::Meta::TypeConstraint->new(@args, parent => $self);
 101 }
 102
 103 1;
 104
 105 __END__
 106
 107 =pod
 108
 109 =head1 NAME
 110
 111 Moose::Meta::TypeConstraint::Role - Role/TypeConstraint parallel hierarchy
 112
 113 =head1 METHODS
 114
 115 =over 4
 116
 117 =item B<new>
 118
 119 =item B<role>
 120
 121 =item B<hand_optimized_type_constraint>
 122
 123 =item B<has_hand_optimized_type_constraint>
 124
 125 =item B<equals>
 126
 127 =item B<is_a_type_of>
 128
 129 =item B<is_subtype_of>
 130
 131 =item B<create_child_type>
 132
 133 =item B<parents>
 134
 135 Return all the parent types, corresponding to the parent classes.
 136
 137 =item B<meta>
 138
 139 =back
 140
 141 =head1 BUGS
 142
 143 All complex software has bugs lurking in it, and this module is no
 144 exception. If you find a bug please either email me, or add the bug
 145 to cpan-RT.
 146
 147 =head1 AUTHOR
 148
 149 Yuval Kogman E<lt>nothingmuch@cpan.orgE<gt>
 150
 151 =head1 COPYRIGHT AND LICENSE
 152
 153 Copyright 2006-2008 by Infinity Interactive, Inc.
 154
 155 L<http://www.iinteractive.com>
 156
 157 This library is free software; you can redistribute it and/or modify
 158 it under the same terms as Perl itself.
 159
 160 =cut