X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FMeta%2FTypeConstraint.pm;h=4dc4650d735cec279aa3101bda52bda40e813661;hp=c3c831ad24b6375ea1332ef8a937f416715d5315;hb=HEAD;hpb=17ae5974bc8594c7d3deb46eb7db0b383fb80a95 diff --git a/lib/Mouse/Meta/TypeConstraint.pm b/lib/Mouse/Meta/TypeConstraint.pm index c3c831a..4dc4650 100644 --- a/lib/Mouse/Meta/TypeConstraint.pm +++ b/lib/Mouse/Meta/TypeConstraint.pm @@ -1,59 +1,88 @@ package Mouse::Meta::TypeConstraint; use Mouse::Util qw(:meta); # enables strict and warnings -use overload - 'bool' => sub (){ 1 }, # always true - '""' => sub { $_[0]->name }, # stringify to tc name - '|' => sub { # or-combination - require Mouse::Util::TypeConstraints; - return Mouse::Util::TypeConstraints::find_or_parse_type_constraint( - "$_[0] | $_[1]", - ); - }, - - fallback => 1; - sub new { - my($class, %args) = @_; + my $class = shift; + my %args = @_ == 1 ? %{$_[0]} : @_; $args{name} = '__ANON__' if !defined $args{name}; - my $check = delete $args{optimized}; + my $type_parameter; + if(defined $args{parent}) { # subtyping + %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}; # don't inherit it + delete $args{hand_optimized_type_constraint}; # don't inherit it + + $type_parameter = $args{type_parameter}; + if(defined(my $parent_tp = $args{parent}{type_parameter})) { + if($parent_tp != $type_parameter) { + $type_parameter->is_a_type_of($parent_tp) + or $class->throw_error( + "$type_parameter is not a subtype of $parent_tp", + ); + } + else { + $type_parameter = undef; + } + } + } + + my $check; - if($check){ + if($check = delete $args{optimized}) { # likely to be builtins $args{hand_optimized_type_constraint} = $check; $args{compiled_type_constraint} = $check; } - - $check = $args{constraint}; + elsif(defined $type_parameter) { # parameterizing + my $generator = $args{constraint_generator} + || $class->throw_error( + "The $args{name} constraint cannot be used," + . " because $type_parameter doesn't subtype" + . " from a parameterizable type"); + + my $parameterized_check = $generator->($type_parameter); + if(defined(my $my_check = $args{constraint})) { + $check = sub { + return $parameterized_check->($_) && $my_check->($_); + }; + } + else { + $check = $parameterized_check; + } + $args{constraint} = $check; + } + else { # common cases + $check = $args{constraint}; + } if(defined($check) && ref($check) ne 'CODE'){ - $class->throw_error("Constraint for $args{name} is not a CODE reference"); + $class->throw_error( + "Constraint for $args{name} is not a CODE reference"); } 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($args{type_constraints}) { # union types + foreach my $type(@{$self->{type_constraints}}){ + if($type->has_coercion){ + # set undef for has_coercion() + $self->{_compiled_type_coercion} = undef; + last; + } + } + } - $self->_compile_union_type_coercion() if $self->{type_constraints}; return $self; } -sub create_child_type{ +sub create_child_type { my $self = shift; - 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; @@ -72,11 +101,16 @@ sub _compiled_type_coercion; sub compile_type_constraint; -sub _add_type_coercions{ +sub _add_type_coercions { # ($self, @pairs) my $self = shift; - my $coercions = ($self->{coercion_map} ||= []); - my %has = map{ $_->[0] => undef } @{$coercions}; + if(exists $self->{type_constraints}){ # union type + $self->throw_error( + "Cannot add additional type coercions to Union types '$self'"); + } + + my $coercion_map = ($self->{coercion_map} ||= []); + my %has = map{ $_->[0]->name => undef } @{$coercion_map}; for(my $i = 0; $i < @_; $i++){ my $from = $_[ $i]; @@ -87,72 +121,69 @@ sub _add_type_coercions{ } my $type = Mouse::Util::TypeConstraints::find_or_parse_type_constraint($from) - or $self->throw_error("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 ]; + push @{$coercion_map}, [ $type => $action ]; } - # compile - if(exists $self->{type_constraints}){ # union type - $self->throw_error("Cannot add additional type coercions to Union types"); - } - else{ - $self->_compile_type_coercion(); - } + $self->{_compiled_type_coercion} = undef; return; } -sub _compile_type_coercion { +sub _compiled_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; -} + my $coercion = $self->{_compiled_type_coercion}; + return $coercion if defined $coercion; -sub _compile_union_type_coercion { - my($self) = @_; - - my @coercions; - foreach my $type(@{$self->{type_constraints}}){ - if($type->has_coercion){ - push @coercions, $type; + if(!$self->{type_constraints}) { + my @coercions; + foreach my $pair(@{$self->{coercion_map}}) { + push @coercions, + [ $pair->[0]->_compiled_type_constraint, $pair->[1] ]; } + + $coercion = sub { + my($thing) = @_; + foreach my $pair (@coercions) { + #my ($constraint, $converter) = @$pair; + if ($pair->[0]->($thing)) { + local $_ = $thing; + return $pair->[1]->($thing); + } + } + return $thing; + }; } - if(@coercions){ - $self->{_compiled_type_coercion} = sub { - my($thing) = @_; - foreach my $type(@coercions){ - my $value = $type->coerce($thing); - return $value if $self->check($value); + else { # for union type + my @coercions; + foreach my $type(@{$self->{type_constraints}}){ + if($type->has_coercion){ + push @coercions, $type; } - return $thing; - }; + } + if(@coercions){ + $coercion = sub { + my($thing) = @_; + foreach my $type(@coercions){ + my $value = $type->coerce($thing); + return $value if $self->check($value); + } + return $thing; + }; + } } - return; + + return( $self->{_compiled_type_coercion} = $coercion ); } sub coerce { my $self = shift; - - my $coercion = $self->_compiled_type_coercion; - if(!$coercion){ - $self->throw_error("Cannot coerce without a type coercion"); - } - return $_[0] if $self->check(@_); + my $coercion = $self->_compiled_type_coercion + or $self->throw_error("Cannot coerce without a type coercion"); return $coercion->(@_); } @@ -163,12 +194,17 @@ sub get_message { return $msg->($value); } else { - $value = ( defined $value ? overload::StrVal($value) : 'undef' ); + if(not defined $value) { + $value = 'undef'; + } + elsif( ref($value) && defined(&overload::StrVal) ) { + $value = overload::StrVal($value); + } return "Validation failed for '$self' with value $value"; } } -sub is_a_type_of{ +sub is_a_type_of { my($self, $other) = @_; # ->is_a_type_of('__ANON__') is always false @@ -179,20 +215,20 @@ sub is_a_type_of{ 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{ +sub parameterize { my($self, $param, $name) = @_; if(!ref $param){ @@ -201,15 +237,10 @@ sub parameterize{ } $name ||= sprintf '%s[%s]', $self->name, $param->name; - - my $generator = $self->{constraint_generator} - || $self->throw_error("The $name constraint cannot be used, because $param doesn't subtype from a parameterizable type"); - return Mouse::Meta::TypeConstraint->new( name => $name, parent => $self, type_parameter => $param, - constraint => $generator->($param), # must be 'constraint', not 'optimized' ); } @@ -222,9 +253,18 @@ sub assert_valid { return 1; } -sub throw_error { - require Mouse::Meta::Module; - goto &Mouse::Meta::Module::throw_error; +# overloading stuff + +sub _as_string { $_[0]->name } # overload "" +sub _identity; # overload 0+ + +sub _unite { # overload infix:<|> + my($lhs, $rhs) = @_; + require Mouse::Util::TypeConstraints; + return Mouse::Util::TypeConstraints::_find_or_create_union_type( + $lhs, + Mouse::Util::TypeConstraints::find_or_create_isa_type_constraint($rhs), + ); } 1; @@ -236,25 +276,42 @@ Mouse::Meta::TypeConstraint - The Mouse Type Constraint metaclass =head1 VERSION -This document describes Mouse version 0.60 +This document describes Mouse version 0.95 =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 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_type_of($name or $object) >> + +=item C<< $constraint->coerce($value) >> + +=item C<< $constraint->check($value) >> + +=item C<< $constraint->assert_valid($value) >> -=item B +=item C<< $constraint->get_message($value) >> -=item B +=item C<< $constraint->create_child_type(%options) >> =back