package Mouse::Meta::TypeConstraint;
-use strict;
-use warnings;
+use Mouse::Util qw(:meta); # enables strict and warnings
-use overload '""' => sub { shift->{name} }, # stringify to tc name
- fallback => 1;
+use overload
+ 'bool' => sub { 1 }, # always true
-use Carp ();
+ '""' => sub { $_[0]->name }, # stringify to tc name
-use Mouse::Util qw(:meta);
+ '|' => sub { # or-combination
+ require Mouse::Util::TypeConstraints;
+ return Mouse::Util::TypeConstraints::find_or_parse_type_constraint(
+ "$_[0] | $_[1]",
+ );
+ },
+
+ fallback => 1;
+
+use Carp ();
sub new {
- my $class = shift;
- my %args = @_;
- my $name = $args{name} || '__ANON__';
+ my($class, %args) = @_;
+
+ $args{name} = '__ANON__' if !defined $args{name};
+
+ my $check = delete $args{optimized};
- my $check = $args{_compiled_type_constraint} or Carp::croak("missing _compiled_type_constraint");
- if (ref $check eq 'Mouse::Meta::TypeConstraint') {
- $check = $check->{_compiled_type_constraint};
+ if($args{_compiled_type_constraint}){
+ Carp::cluck("'_compiled_type_constraint' has been deprecated, use 'optimized' instead")
+ if Mouse::Util::_MOUSE_VERBOSE;
+
+ $check = $args{_compiled_type_constraint};
}
- bless +{
- name => $name,
- _compiled_type_constraint => $check,
- message => $args{message}
- }, $class;
-}
+ if($check){
+ $args{hand_optimized_type_constraint} = $check;
+ $args{compiled_type_constraint} = $check;
+ }
-sub name { shift->{name} }
+ $check = $args{constraint};
-sub check {
+ if(defined($check) && ref($check) ne 'CODE'){
+ Carp::confess("Constraint for $args{name} is not a CODE reference");
+ }
+
+ $args{package_defined_in} ||= caller;
+
+ my $self = bless \%args, $class;
+ $self->compile_type_constraint() if !$self->{hand_optimized_type_constraint};
+
+ if($self->{type_constraints}){ # Union
+ my @coercions;
+ foreach my $type(@{$self->{type_constraints}}){
+ if($type->has_coercion){
+ push @coercions, $type;
+ }
+ }
+ if(@coercions){
+ $self->{_compiled_type_coercion} = sub {
+ my($thing) = @_;
+ foreach my $type(@coercions){
+ my $value = $type->coerce($thing);
+ return $value if $self->check($value);
+ }
+ return $thing;
+ };
+ }
+ }
+
+ return $self;
+}
+
+sub create_child_type{
my $self = shift;
- $self->{_compiled_type_constraint}->(@_);
+ # XXX: FIXME
+ return ref($self)->new(
+ # a child inherits its parent's attributes
+ %{$self},
+
+ # but does not inherit 'compiled_type_constraint' and 'hand_optimized_type_constraint'
+ compiled_type_constraint => undef,
+ hand_optimized_type_constraint => undef,
+
+ # and is given child-specific args, of course.
+ @_,
+
+ # and its parent
+ parent => $self,
+ );
}
-sub validate {
- my ($self, $value) = @_;
- if ($self->{_compiled_type_constraint}->($value)) {
- return undef;
+sub _add_type_coercions{
+ my $self = shift;
+
+ my $coercions = ($self->{_coercion_map} ||= []);
+ my %has = map{ $_->[0] => undef } @{$coercions};
+
+ for(my $i = 0; $i < @_; $i++){
+ my $from = $_[ $i];
+ my $action = $_[++$i];
+
+ if(exists $has{$from}){
+ Carp::confess("A coercion action already exists for '$from'");
+ }
+
+ my $type = Mouse::Util::TypeConstraints::find_or_parse_type_constraint($from)
+ or Carp::confess("Could not find the type constraint ($from) to coerce from");
+
+ push @{$coercions}, [ $type => $action ];
}
- else {
- $self->get_message($value);
+
+ # compile
+ if(exists $self->{type_constraints}){ # union type
+ Carp::confess("Cannot add additional type coercions to Union types");
}
+ else{
+ $self->{_compiled_type_coercion} = sub {
+ my($thing) = @_;\r
+ foreach my $pair (@{$coercions}) {\r
+ #my ($constraint, $converter) = @$pair;\r
+ if ($pair->[0]->check($thing)) {\r
+ local $_ = $thing;
+ return $pair->[1]->($thing);
+ }\r
+ }\r
+ return $thing;\r
+ };
+ }
+ return;
}
-sub assert_valid {
- my ($self, $value) = @_;
-
- my $error = $self->validate($value);
- return 1 if ! defined $error;
-
- Carp::confess($error);
+sub check {
+ my $self = shift;
+ return $self->_compiled_type_constraint->(@_);
}
+sub coerce {
+ my $self = shift;
-sub message {
- return $_[0]->{message};
+ return $_[0] if $self->_compiled_type_constraint->(@_);
+
+ my $coercion = $self->_compiled_type_coercion;
+ return $coercion ? $coercion->(@_) : $_[0];
}
sub get_message {
}
else {
$value = ( defined $value ? overload::StrVal($value) : 'undef' );
- return
- "Validation failed for '"
- . $self->name
- . "' failed with value $value";
+ return "Validation failed for '$self' failed with value $value";
}
}
sub is_a_type_of{
- my($self, $tc_name) = @_;
+ my($self, $other) = @_;
+
+ # ->is_a_type_of('__ANON__') is always false
+ return 0 if !ref($other) && $other eq '__ANON__';
+
+ (my $other_name = $other) =~ s/\s+//g;
+
+ return 1 if $self->name eq $other_name;
+
+ if(exists $self->{type_constraints}){ # union
+ foreach my $type(@{$self->{type_constraints}}){
+ return 1 if $type->name eq $other_name;
+ }
+ }
- return $self->name eq $tc_name
- || $self->name =~ /\A $tc_name \[/xms; # "ArrayRef" =~ "ArrayRef[Foo]"
+ for(my $parent = $self->parent; defined $parent; $parent = $parent->parent){
+ return 1 if $parent->name eq $other_name;
+ }
+
+ return 0;
+}
+
+# See also Moose::Meta::TypeConstraint::Parameterizable
+sub parameterize{
+ my($self, $param, $name) = @_;
+
+ if(!ref $param){
+ require Mouse::Util::TypeConstraints;
+ $param = Mouse::Util::TypeConstraints::find_or_create_isa_type_constraint($param);
+ }
+
+ $name ||= sprintf '%s[%s]', $self->name, $param->name;
+
+ my $generator = $self->{constraint_generator}
+ || Carp::confess("The $name constraint cannot be used, because $param doesn't subtype from a parameterizable type");
+
+ return Mouse::Meta::TypeConstraint->new(
+ name => $name,
+ parent => $self,
+ parameter => $param,
+ constraint => $generator->($param), # must be 'constraint', not 'optimized'
+
+ type => 'Parameterized',
+ );
}
1;
Mouse::Meta::TypeConstraint - The Mouse Type Constraint metaclass
+=head1 VERSION
+
+This document describes Mouse version 0.40_07
+
=head1 DESCRIPTION
For the most part, the only time you will ever encounter an