HashRefa looks like a typo
[gitmo/Mouse.git] / lib / Mouse / Util / TypeConstraints.pm
CommitLineData
3b46bd49 1package Mouse::Util::TypeConstraints;
d60c78b9 2use strict;
3use warnings;
9baf5d6b 4
61a02a3a 5use Carp ();
6c169c50 6use Scalar::Util qw/blessed looks_like_number openhandle/;
d60c78b9 7
8a7f2a8a 8my %SUBTYPE;
9my %COERCE;
10my %COERCE_KEYS;
4188b837 11
bc37d507 12#find_type_constraint register_type_constraint
4188b837 13sub import {
14 my $class = shift;
15 my %args = @_;
bc37d507 16 my $caller = $args{callee} || caller(0);
4188b837 17
18 no strict 'refs';
61a02a3a 19 *{"$caller\::as"} = \&_as;
20 *{"$caller\::where"} = \&_where;
21 *{"$caller\::message"} = \&_message;
22 *{"$caller\::from"} = \&_from;
23 *{"$caller\::via"} = \&_via;
0d9fea22 24 *{"$caller\::type"} = \&_type;
4188b837 25 *{"$caller\::subtype"} = \&_subtype;
26 *{"$caller\::coerce"} = \&_coerce;
ecc6e3b1 27 *{"$caller\::class_type"} = \&_class_type;
47f36c05 28 *{"$caller\::role_type"} = \&_role_type;
4188b837 29}
30
61a02a3a 31
32sub _as ($) {
33 as => $_[0]
34}
35sub _where (&) {
36 where => $_[0]
37}
38sub _message ($) {
39 message => $_[0]
40}
41
42sub _from { @_ }
43sub _via (&) {
44 $_[0]
45}
46
381f326a 47my $optimized_constraints;
48my $optimized_constraints_base;
49{
50 no warnings 'uninitialized';
8a7f2a8a 51 %SUBTYPE = (
381f326a 52 Any => sub { 1 },
53 Item => sub { 1 },
54 Bool => sub {
55 !defined($_) || $_ eq "" || "$_" eq '1' || "$_" eq '0'
56 },
57 Undef => sub { !defined($_) },
58 Defined => sub { defined($_) },
59 Value => sub { defined($_) && !ref($_) },
60 Num => sub { !ref($_) && looks_like_number($_) },
61 Int => sub { defined($_) && !ref($_) && /^-?[0-9]+$/ },
62 Str => sub { defined($_) && !ref($_) },
63 ClassName => sub { Mouse::is_class_loaded($_) },
64 Ref => sub { ref($_) },
65
66 ScalarRef => sub { ref($_) eq 'SCALAR' },
67 ArrayRef => sub { ref($_) eq 'ARRAY' },
68 HashRef => sub { ref($_) eq 'HASH' },
69 CodeRef => sub { ref($_) eq 'CODE' },
70 RegexpRef => sub { ref($_) eq 'Regexp' },
71 GlobRef => sub { ref($_) eq 'GLOB' },
72
73 FileHandle => sub {
74 ref($_) eq 'GLOB'
75 && openhandle($_)
76 or
77 blessed($_)
78 && $_->isa("IO::Handle")
79 },
80
81 Object => sub { blessed($_) && blessed($_) ne 'Regexp' },
8a7f2a8a 82 );
d3982c7e 83
8a7f2a8a 84 sub optimized_constraints { \%SUBTYPE }
85 my @SUBTYPE_KEYS = keys %SUBTYPE;
d3982c7e 86 sub list_all_builtin_type_constraints { @SUBTYPE_KEYS }
381f326a 87}
d3982c7e 88
0d9fea22 89sub _type {
90 my $pkg = caller(0);
91 my($name, %conf) = @_;
92 if (my $type = $SUBTYPE{$name}) {
93 Carp::croak "The type constraint '$name' has already been created, cannot be created again in $pkg";
94 };
95 my $stuff = $conf{where} || do { $SUBTYPE{delete $conf{as} || 'Any' } };
96 $SUBTYPE{$name} = $stuff;
97}
98
4188b837 99sub _subtype {
100 my $pkg = caller(0);
61a02a3a 101 my($name, %conf) = @_;
8a7f2a8a 102 if (my $type = $SUBTYPE{$name}) {
61a02a3a 103 Carp::croak "The type constraint '$name' has already been created, cannot be created again in $pkg";
104 };
2f665925 105 my $stuff = $conf{where} || do { $SUBTYPE{delete $conf{as} || 'Any' } };
106 my $as = $conf{as} || '';
1fbefea5 107 if ($as = $SUBTYPE{$as}) {
108 $SUBTYPE{$name} = sub { $as->($_) && $stuff->($_) };
109 } else {
110 $SUBTYPE{$name} = $stuff;
111 }
4188b837 112}
113
114sub _coerce {
61a02a3a 115 my($name, %conf) = @_;
116
117 Carp::croak "Cannot find type '$name', perhaps you forgot to load it."
b3b74cc6 118 unless $SUBTYPE{$name};
61a02a3a 119
8a7f2a8a 120 unless ($COERCE{$name}) {
121 $COERCE{$name} = {};
122 $COERCE_KEYS{$name} = [];
123 }
61a02a3a 124 while (my($type, $code) = each %conf) {
125 Carp::croak "A coercion action already exists for '$type'"
8a7f2a8a 126 if $COERCE{$name}->{$type};
61a02a3a 127
128 Carp::croak "Could not find the type constraint ($type) to coerce from"
b3b74cc6 129 unless $SUBTYPE{$type};
61a02a3a 130
8a7f2a8a 131 push @{ $COERCE_KEYS{$name} }, $type;
132 $COERCE{$name}->{$type} = $code;
61a02a3a 133 }
4188b837 134}
135
ecc6e3b1 136sub _class_type {
137 my $pkg = caller(0);
ecc6e3b1 138 my($name, $conf) = @_;
139 my $class = $conf->{class};
2f6fade8 140 Mouse::load_class($class);
61a02a3a 141 _subtype(
4a957f05 142 $name => where => sub { $_->isa($class) }
61a02a3a 143 );
ecc6e3b1 144}
145
47f36c05 146sub _role_type {
47f36c05 147 my($name, $conf) = @_;
148 my $role = $conf->{role};
61a02a3a 149 _subtype(
150 $name => where => sub {
151 return unless defined $_ && ref($_) && $_->isa('Mouse::Object');
152 $_->meta->does_role($role);
153 }
154 );
47f36c05 155}
156
4188b837 157sub typecast_constraints {
eec1bb49 158 my($class, $pkg, $type_constraint, $types, $value) = @_;
eec1bb49 159
b3b74cc6 160 local $_;
eec1bb49 161 for my $type (ref($types) eq 'ARRAY' ? @{ $types } : ( $types )) {
8a7f2a8a 162 next unless $COERCE{$type};
8a7f2a8a 163 for my $coerce_type (@{ $COERCE_KEYS{$type}}) {
b3b74cc6 164 $_ = $value;
165 next unless $SUBTYPE{$coerce_type}->();
166 $_ = $value;
167 $_ = $COERCE{$type}->{$coerce_type}->();
168 return $_ if $type_constraint->();
4188b837 169 }
170 }
4188b837 171 return $value;
172}
173
d60c78b9 1741;
175
6feb83f1 176__END__
177
178=head1 NAME
179
3b46bd49 180Mouse::Util::TypeConstraints - simple type constraints
6feb83f1 181
182=head1 METHODS
183
184=head2 optimized_constraints -> HashRef[CODE]
185
186Returns the simple type constraints that Mouse understands.
187
188=cut
189
190