package Mouse::Util::TypeConstraints;
use strict;
use warnings;
+use base 'Exporter';
use Carp ();
use Scalar::Util qw/blessed looks_like_number openhandle/;
+our @EXPORT = qw(
+ as where message from via type subtype coerce class_type role_type enum
+);
+
my %TYPE;
+my %TYPE_SOURCE;
my %COERCE;
my %COERCE_KEYS;
-#find_type_constraint register_type_constraint
-sub import {
- my $class = shift;
- my %args = @_;
- my $caller = $args{callee} || caller(0);
-
- no strict 'refs';
- *{"$caller\::as"} = \&_as;
- *{"$caller\::where"} = \&_where;
- *{"$caller\::message"} = \&_message;
- *{"$caller\::from"} = \&_from;
- *{"$caller\::via"} = \&_via;
- *{"$caller\::type"} = \&_type;
- *{"$caller\::subtype"} = \&_subtype;
- *{"$caller\::coerce"} = \&_coerce;
- *{"$caller\::class_type"} = \&_class_type;
- *{"$caller\::role_type"} = \&_role_type;
-}
-
-
-sub _as ($) {
+sub as ($) {
as => $_[0]
}
-sub _where (&) {
+sub where (&) {
where => $_[0]
}
-sub _message ($) {
+sub message (&) {
message => $_[0]
}
-sub _from { @_ }
-sub _via (&) {
+sub from { @_ }
+sub via (&) {
$_[0]
}
-my $optimized_constraints;
-my $optimized_constraints_base;
-{
+BEGIN {
no warnings 'uninitialized';
%TYPE = (
Any => sub { 1 },
Item => sub { 1 },
Bool => sub {
- !defined($_) || $_ eq "" || "$_" eq '1' || "$_" eq '0'
+ !defined($_[0]) || $_[0] eq "" || "$_[0]" eq '1' || "$_[0]" eq '0'
},
- Undef => sub { !defined($_) },
- Defined => sub { defined($_) },
- Value => sub { defined($_) && !ref($_) },
- Num => sub { !ref($_) && looks_like_number($_) },
- Int => sub { defined($_) && !ref($_) && /^-?[0-9]+$/ },
- Str => sub { defined($_) && !ref($_) },
- ClassName => sub { Mouse::is_class_loaded($_) },
- Ref => sub { ref($_) },
-
- ScalarRef => sub { ref($_) eq 'SCALAR' },
- ArrayRef => sub { ref($_) eq 'ARRAY' },
- HashRef => sub { ref($_) eq 'HASH' },
- CodeRef => sub { ref($_) eq 'CODE' },
- RegexpRef => sub { ref($_) eq 'Regexp' },
- GlobRef => sub { ref($_) eq 'GLOB' },
+ Undef => sub { !defined($_[0]) },
+ Defined => sub { defined($_[0]) },
+ Value => sub { defined($_[0]) && !ref($_[0]) },
+ Num => sub { !ref($_[0]) && looks_like_number($_[0]) },
+ Int => sub { defined($_[0]) && !ref($_[0]) && $_[0] =~ /^-?[0-9]+$/ },
+ Str => sub { defined($_[0]) && !ref($_[0]) },
+ ClassName => sub { Mouse::is_class_loaded($_[0]) },
+ Ref => sub { ref($_[0]) },
+
+ ScalarRef => sub { ref($_[0]) eq 'SCALAR' },
+ ArrayRef => sub { ref($_[0]) eq 'ARRAY' },
+ HashRef => sub { ref($_[0]) eq 'HASH' },
+ CodeRef => sub { ref($_[0]) eq 'CODE' },
+ RegexpRef => sub { ref($_[0]) eq 'Regexp' },
+ GlobRef => sub { ref($_[0]) eq 'GLOB' },
FileHandle => sub {
- ref($_) eq 'GLOB'
- && openhandle($_)
+ ref($_[0]) eq 'GLOB' && openhandle($_[0])
or
- blessed($_)
- && $_->isa("IO::Handle")
- },
+ blessed($_[0]) && $_[0]->isa("IO::Handle")
+ },
- Object => sub { blessed($_) && blessed($_) ne 'Regexp' },
+ Object => sub { blessed($_[0]) && blessed($_[0]) ne 'Regexp' },
);
+ foreach my $code (values %TYPE) {
+ bless $code, 'Mouse::Meta::TypeConstraint';
+ }
sub optimized_constraints { \%TYPE }
my @TYPE_KEYS = keys %TYPE;
sub list_all_builtin_type_constraints { @TYPE_KEYS }
+
+ @TYPE_SOURCE{@TYPE_KEYS} = (__PACKAGE__) x @TYPE_KEYS;
}
-sub _type {
+sub type {
my $pkg = caller(0);
my($name, %conf) = @_;
- if (my $type = $TYPE{$name}) {
- Carp::croak "The type constraint '$name' has already been created, cannot be created again in $pkg";
+ if ($TYPE{$name} && $TYPE_SOURCE{$name} ne $pkg) {
+ Carp::croak "The type constraint '$name' has already been created in $TYPE_SOURCE{$name} and cannot be created again in $pkg";
+ };
+ my $constraint = $conf{where} || do {
+ my $as = delete $conf{as} || 'Any';
+ if (! exists $TYPE{$as}) {
+ $TYPE{$as} = _build_type_constraint($as);
+ }
+ $TYPE{$as};
};
- my $stuff = $conf{where} || do { $TYPE{delete $conf{as} || 'Any' } };
- $TYPE{$name} = $stuff;
+
+ $TYPE_SOURCE{$name} = $pkg;
+ $TYPE{$name} = sub { local $_ = $_[0]; $constraint->($_[0]) };
}
-sub _subtype {
+sub subtype {
my $pkg = caller(0);
my($name, %conf) = @_;
- if (my $type = $TYPE{$name}) {
- Carp::croak "The type constraint '$name' has already been created, cannot be created again in $pkg";
+ if ($TYPE{$name} && $TYPE_SOURCE{$name} ne $pkg) {
+ Carp::croak "The type constraint '$name' has already been created in $TYPE_SOURCE{$name} and cannot be created again in $pkg";
};
- my $stuff = $conf{where} || do { $TYPE{delete $conf{as} || 'Any' } };
- my $as = $conf{as} || '';
- if ($as = $TYPE{$as}) {
- $TYPE{$name} = sub { $as->($_) && $stuff->($_) };
- } else {
- $TYPE{$name} = $stuff;
- }
+ my $constraint = $conf{where};
+ my $as_constraint = find_or_create_isa_type_constraint($conf{as} || 'Any');
+
+ $TYPE_SOURCE{$name} = $pkg;
+ $TYPE{$name} = $constraint ?
+ sub {
+ local $_ = $_[0];
+ $as_constraint->($_[0]) && $constraint->($_[0])
+ } :
+ sub {
+ local $_ = $_[0];
+ $as_constraint->($_[0]);
+ }
+ ;
+
+ return $name;
}
-sub _coerce {
+sub coerce {
my($name, %conf) = @_;
Carp::croak "Cannot find type '$name', perhaps you forgot to load it."
Carp::croak "A coercion action already exists for '$type'"
if $COERCE{$name}->{$type};
- Carp::croak "Could not find the type constraint ($type) to coerce from"
- unless $TYPE{$type};
+ if (! $TYPE{$type}) {
+ # looks parameterized
+ if ($type =~ /^[^\[]+\[.+\]$/) {
+ _build_type_constraint($type);
+ } else {
+ Carp::croak "Could not find the type constraint ($type) to coerce from"
+ }
+ }
push @{ $COERCE_KEYS{$name} }, $type;
$COERCE{$name}->{$type} = $code;
}
}
-sub _class_type {
- my $pkg = caller(0);
+sub class_type {
my($name, $conf) = @_;
- my $class = $conf->{class};
- Mouse::load_class($class);
- _subtype(
- $name => where => sub { $_->isa($class) }
- );
+ if ($conf && $conf->{class}) {
+ # No, you're using this wrong
+ warn "class_type() should be class_type(ClassName). Perhaps you're looking for subtype $name => as '$conf->{class}'?";
+ subtype($name, as => $conf->{class});
+ } else {
+ subtype(
+ $name => where => sub { $_->isa($name) }
+ );
+ }
}
-sub _role_type {
+sub role_type {
my($name, $conf) = @_;
my $role = $conf->{role};
- _subtype(
+ subtype(
$name => where => sub {
return unless defined $_ && ref($_) && $_->isa('Mouse::Object');
$_->meta->does_role($role);
next unless $COERCE{$type};
for my $coerce_type (@{ $COERCE_KEYS{$type}}) {
$_ = $value;
- next unless $TYPE{$coerce_type}->();
+ next unless $TYPE{$coerce_type}->($value);
$_ = $value;
- $_ = $COERCE{$type}->{$coerce_type}->();
- return $_ if $type_constraint->();
+ $_ = $COERCE{$type}->{$coerce_type}->($value);
+ return $_ if $type_constraint->($_);
}
}
return $value;
}
+my $serial_enum = 0;
+sub enum {
+ # enum ['small', 'medium', 'large']
+ if (ref($_[0]) eq 'ARRAY') {
+ my @elements = @{ shift @_ };
+
+ my $name = 'Mouse::Util::TypeConstaints::Enum::Serial::'
+ . ++$serial_enum;
+ enum($name, @elements);
+ return $name;
+ }
+
+ # enum size => 'small', 'medium', 'large'
+ my $name = shift;
+ my %is_valid = map { $_ => 1 } @_;
+
+ subtype(
+ $name => where => sub { $is_valid{$_} }
+ );
+}
+
+sub _build_type_constraint {
+
+ my $spec = shift;
+ my $code;
+ if ($spec =~ /^([^\[]+)\[(.+)\]$/) {
+ # parameterized
+ my $constraint = $1;
+ my $param = $2;
+ my $parent;
+ if ($constraint eq 'Maybe') {
+ $parent = _build_type_constraint('Undef');
+ } else {
+ $parent = _build_type_constraint($constraint);
+ }
+ my $child = _build_type_constraint($param);
+ if ($constraint eq 'ArrayRef') {
+ my $code_str =
+ "#line " . __LINE__ . ' "' . __FILE__ . "\"\n" .
+ "sub {\n" .
+ " if (\$parent->(\$_[0])) {\n" .
+ " foreach my \$e (\@{\$_[0]}) {\n" .
+ " return () unless \$child->(\$e);\n" .
+ " }\n" .
+ " return 1;\n" .
+ " }\n" .
+ " return ();\n" .
+ "};\n"
+ ;
+ $code = eval $code_str or Carp::confess("Failed to generate inline type constraint: $@");
+ } elsif ($constraint eq 'HashRef') {
+ my $code_str =
+ "#line " . __LINE__ . ' "' . __FILE__ . "\"\n" .
+ "sub {\n" .
+ " if (\$parent->(\$_[0])) {\n" .
+ " foreach my \$e (values \%{\$_[0]}) {\n" .
+ " return () unless \$child->(\$e);\n" .
+ " }\n" .
+ " return 1;\n" .
+ " }\n" .
+ " return ();\n" .
+ "};\n"
+ ;
+ $code = eval $code_str or Carp::confess($@);
+ } elsif ($constraint eq 'Maybe') {
+ my $code_str =
+ "#line " . __LINE__ . ' "' . __FILE__ . "\"\n" .
+ "sub {\n" .
+ " return \$child->(\$_[0]) || \$parent->(\$_[0]);\n" .
+ "};\n"
+ ;
+ $code = eval $code_str or Carp::confess($@);
+ } else {
+ Carp::confess("Support for parameterized types other than ArrayRef or HashRef is not implemented yet");
+ }
+ $TYPE{$spec} = $code;
+ } else {
+ $code = $TYPE{ $spec };
+ if (! $code) {
+ my $code_str =
+ "#line " . __LINE__ . ' "' . __FILE__ . "\"\n" .
+ "sub {\n" .
+ " Scalar::Util::blessed(\$_[0]) && \$_[0]->isa('$spec');\n" .
+ "}"
+ ;
+ $code = eval $code_str or Carp::confess($@);
+ $TYPE{$spec} = bless $code, 'Mouse::Meta::TypeConstraint';
+ }
+ }
+ return bless $code, 'Mouse::Meta::TypeConstraint';
+}
+
+sub find_type_constraint {
+ my $type_constraint = shift;
+ return $TYPE{$type_constraint};
+}
+
+sub find_or_create_isa_type_constraint {
+ my $type_constraint = shift;
+
+ my $code;
+
+ $type_constraint =~ s/\s+//g;
+ my @type_constraints = split /\|/, $type_constraint;
+ if (@type_constraints == 1) {
+ $code = $TYPE{$type_constraints[0]} ||
+ _build_type_constraint($type_constraints[0]);
+ } else {
+ my @code_list = map {
+ $TYPE{$_} || _build_type_constraint($_)
+ } @type_constraints;
+ $code = bless sub {
+ my $i = 0;
+ for my $code (@code_list) {
+ return 1 if $code->($_[0]);
+ }
+ return 0;
+ }, 'Mouse::Meta::TypeConstraint';
+ }
+ return $code;
+}
+
+package # Hide from pause
+ Mouse::Meta::TypeConstraint;
+
+sub check {
+ $_[0]->($_[1])
+}
+
+
1;
__END__
Returns the simple type constraints that Mouse understands.
+=head1 FUNCTIONS
+
+=over 4
+
+=item B<subtype 'Name' => as 'Parent' => where { } ...>
+
+=item B<subtype as 'Parent' => where { } ...>
+
+=item B<class_type ($class, ?$options)>
+
+=item B<role_type ($role, ?$options)>
+
+=item B<enum (\@values)>
+
+=back
+
=cut
projects / gitmo/Mouse.git / blobdiff