package Mouse::Meta::TypeConstraint;
use Mouse::Util qw(:meta); # enables strict and warnings
-
-use overload
- '""' => sub { shift->{name} }, # stringify to tc name
- fallback => 1;
-
-use Carp qw(confess);
-use Scalar::Util qw(blessed reftype);
-
-my $null_check = sub { 1 };
+use Scalar::Util ();
sub new {
- my($class, %args) = @_;
+ my $class = shift;
+ my %args = @_ == 1 ? %{$_[0]} : @_;
$args{name} = '__ANON__' if !defined $args{name};
- my $check = delete $args{optimized};
-
- if($args{_compiled_type_constraint}){
- Carp::cluck("'_compiled_type_constraint' has been deprecated, use 'optimized' instead")
- if _MOUSE_VERBOSE;
-
- $check = $args{_compiled_type_constraint};
+ if($args{parent}) {
+ %args = (%{$args{parent}}, %args);
+ # a child type must not inherit 'compiled_type_constraint'
+ # and 'hand_optimized_type_constraint' from the parent
+ delete $args{compiled_type_constraint};
+ delete $args{hand_optimized_type_constraint};
}
- if($check){
+ my $check;
+
+ if($check = delete $args{optimized}) {
$args{hand_optimized_type_constraint} = $check;
$args{compiled_type_constraint} = $check;
}
-
- $check = $args{constraint};
-
- if(blessed($check)){
- Carp::cluck("Constraint for $args{name} must be a CODE reference");
- $check = $check->{compiled_type_constraint};
+ elsif(my $param = $args{type_parameter}) {
+ my $generator = $args{constraint_generator}
+ || $class->throw_error("The $args{name} constraint cannot be used,"
+ . " because $param doesn't subtype from a parameterizable type");
+ # it must be 'constraint'
+ $check = $args{constraint} = $generator->($param);
+ }
+ else {
+ $check = $args{constraint};
}
if(defined($check) && ref($check) ne 'CODE'){
- confess("Constraint for $args{name} is not a CODE reference");
+ $class->throw_error(
+ "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};
+ $self->compile_type_constraint()
+ if !$args{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;
- };
- }
+ if($args{type_constraints}) {
+ $self->_compile_union_type_coercion();
}
-
return $self;
}
-sub create_child_type{
+sub create_child_type {
my $self = shift;
- # 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,
- );
+ return ref($self)->new(@_, parent => $self);
}
-sub name { $_[0]->{name} }
-sub parent { $_[0]->{parent} }
-sub message { $_[0]->{message} }
+sub name;
+sub parent;
+sub message;
+sub has_coercion;
-sub _compiled_type_constraint{ $_[0]->{compiled_type_constraint} }
+sub check;
-sub has_coercion{ exists $_[0]->{_compiled_type_coercion} }
+sub type_parameter;
+sub __is_parameterized;
-sub compile_type_constraint{
- my($self) = @_;
+sub _compiled_type_constraint;
+sub _compiled_type_coercion;
- # add parents first
- my @checks;
- for(my $parent = $self->parent; defined $parent; $parent = $parent->parent){
- if($parent->{hand_optimized_type_constraint}){
- unshift @checks, $parent->{hand_optimized_type_constraint};
- last; # a hand optimized constraint must include all the parents
- }
- elsif($parent->{constraint}){
- unshift @checks, $parent->{constraint};
- }
- }
-
- # then add child
- if($self->{constraint}){
- push @checks, $self->{constraint};
- }
-
- if($self->{type_constraints}){ # Union
- my @types = map{ $_->_compiled_type_constraint } @{ $self->{type_constraints} };
- push @checks, sub{
- foreach my $c(@types){
- return 1 if $c->($_[0]);
- }
- return 0;
- };
- }
+sub compile_type_constraint;
- if(@checks == 0){
- $self->{compiled_type_constraint} = $null_check;
- }
- elsif(@checks == 1){
- my $c = $checks[0];
- $self->{compiled_type_constraint} = sub{
- my(@args) = @_;
- local $_ = $args[0];
- return $c->(@args);
- };
- }
- else{
- $self->{compiled_type_constraint} = sub{
- my(@args) = @_;
- local $_ = $args[0];
- foreach my $c(@checks){
- return undef if !$c->(@args);
- }
- return 1;
- };
- }
- return;
-}
-sub _add_type_coercions{
+sub _add_type_coercions { # ($self, @pairs)
my $self = shift;
- my $coercions = ($self->{_coercion_map} ||= []);
+ my $coercions = ($self->{coercion_map} ||= []);
my %has = map{ $_->[0] => undef } @{$coercions};
for(my $i = 0; $i < @_; $i++){
my $action = $_[++$i];
if(exists $has{$from}){
- confess("A coercion action already exists for '$from'");
+ $self->throw_error("A coercion action already exists for '$from'");
}
my $type = Mouse::Util::TypeConstraints::find_or_parse_type_constraint($from)
- or confess("Could not find the type constraint ($from) to coerce from");
+ or $self->throw_error(
+ "Could not find the type constraint ($from) to coerce from");
push @{$coercions}, [ $type => $action ];
}
# compile
if(exists $self->{type_constraints}){ # union type
- confess("Cannot add additional type coercions to Union types");
+ $self->throw_error(
+ "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
- };
+ $self->_compile_type_coercion();
}
return;
}
-sub check {
- my $self = shift;
- return $self->_compiled_type_constraint->(@_);
+sub _compile_type_coercion {
+ my($self) = @_;
+
+ my @coercions = @{$self->{coercion_map}};
+
+ $self->{_compiled_type_coercion} = sub {
+ my($thing) = @_;
+ foreach my $pair (@coercions) {
+ #my ($constraint, $converter) = @$pair;
+ if ($pair->[0]->check($thing)) {
+ local $_ = $thing;
+ return $pair->[1]->($thing);
+ }
+ }
+ return $thing;
+ };
+ return;
+}
+
+sub _compile_union_type_coercion {
+ my($self) = @_;
+
+ 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;
}
sub coerce {
my $self = shift;
- if(!$self->{_compiled_type_coercion}){
- confess("Cannot coerce without a type coercion ($self)");
+
+ my $coercion = $self->_compiled_type_coercion;
+ if(!$coercion){
+ $self->throw_error("Cannot coerce without a type coercion");
}
- return $_[0] if $self->_compiled_type_constraint->(@_);
+ return $_[0] if $self->check(@_);
- return $self->{_compiled_type_coercion}->(@_);
+ return $coercion->(@_);
}
sub get_message {
return $msg->($value);
}
else {
- $value = ( defined $value ? overload::StrVal($value) : 'undef' );
- return "Validation failed for '$self' failed with value $value";
+ if(not defined $value) {
+ $value = 'undef';
+ }
+ elsif( ref($value) && defined(&overload::StrVal) ) {
+ $value = overload::StrVal($value);
+ }
+ return "Validation failed for '$self' with value $value";
}
}
my($self, $other) = @_;
# ->is_a_type_of('__ANON__') is always false
- return 0 if !blessed($other) && $other eq '__ANON__';
+ 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}}){
+ foreach my $type(@{$self->{type_constraints}}) {
return 1 if $type->name eq $other_name;
}
}
- for(my $parent = $self->parent; defined $parent; $parent = $parent->parent){
- return 1 if $parent->name eq $other_name;
+ for(my $p = $self->parent; defined $p; $p = $p->parent) {
+ return 1 if $p->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;
+ return Mouse::Meta::TypeConstraint->new(
+ name => $name,
+ parent => $self,
+ type_parameter => $param,
+ );
+}
+
+sub assert_valid {
+ my ($self, $value) = @_;
+
+ if(!$self->check($value)){
+ $self->throw_error($self->get_message($value));
+ }
+ return 1;
+}
+
+sub _as_string { $_[0]->name } # overload ""
+sub _identity { Scalar::Util::refaddr($_[0]) } # overload 0+
+
+sub _unite { # overload infix:<|>
+ my($lhs, $rhs) = @_;
+ require Mouse::Util::TypeConstraints;
+ return Mouse::Util::TypeConstraints::find_or_parse_type_constraint(
+ " $lhs | $rhs",
+ );
+}
1;
__END__
=head1 VERSION
-This document describes Mouse version 0.40
+This document describes Mouse version 0.71
=head1 DESCRIPTION
-For the most part, the only time you will ever encounter an
-instance of this class is if you are doing some serious deep
-introspection. This API should not be considered final, but
-it is B<highly unlikely> that this will matter to a regular
-Mouse user.
-
-Don't use this.
+This class represents a type constraint, including built-in
+type constraints, union type constraints, parameterizable/
+parameterized type constraints, as well as custom type
+constraints
=head1 METHODS
-=over 4
+=over
+
+=item C<< Mouse::Meta::TypeConstraint->new(%options) >>
+
+=item C<< $constraint->name >>
+
+=item C<< $constraint->parent >>
+
+=item C<< $constraint->constraint >>
+
+=item C<< $constraint->has_coercion >>
+
+=item C<< $constraint->message >>
+
+=item C<< $constraint->is_a_subtype_of($name or $object) >>
+
+=item C<< $constraint->coerce($value) >>
+
+=item C<< $constraint->check($value) >>
+
+=item C<< $constraint->assert_valid($value) >>
-=item B<new>
+=item C<< $constraint->get_message($value) >>
-=item B<name>
+=item C<< $constraint->create_child_type(%options) >>
=back