X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FTypes%2FTypeDecorator.pm;h=4c2bc8eb1a2d02a03d8efe5e93e0f9ff93c9b926;hb=ef8b7b7a254653b0e77d19b19d7bd870700cf4b2;hp=f39bd551466c07a13242138d841862993e0d1829;hpb=bb5b7b28b3e2fa8a6120e445ff58a0e377cf0806;p=gitmo%2FMooseX-Types.git diff --git a/lib/MooseX/Types/TypeDecorator.pm b/lib/MooseX/Types/TypeDecorator.pm index f39bd55..4c2bc8e 100644 --- a/lib/MooseX/Types/TypeDecorator.pm +++ b/lib/MooseX/Types/TypeDecorator.pm @@ -1,27 +1,57 @@ package MooseX::Types::TypeDecorator; +#ABSTRACT: Wraps Moose::Meta::TypeConstraint objects with added features + use strict; use warnings; use Carp::Clan qw( ^MooseX::Types ); -use Moose::Util::TypeConstraints; +use Moose::Util::TypeConstraints (); use Moose::Meta::TypeConstraint::Union; +use Scalar::Util qw(blessed); use overload( + '0+' => sub { + my $self = shift @_; + my $tc = $self->{__type_constraint}; + return 0+$tc; + }, '""' => sub { - shift->type_constraint->name; + my $self = shift @_; + if(blessed $self) { + return $self->__type_constraint->name; + } else { + return "$self"; + } }, + bool => sub { 1 }, '|' => sub { - my @tc = grep {ref $_} @_; + + ## It's kind of ugly that we need to know about Union Types, but this + ## is needed for syntax compatibility. Maybe someday we'll all just do + ## Or[Str,Str,Int] + + my @args = @_[0,1]; ## arg 3 is special, see the overload docs. + my @tc = grep {blessed $_} map { + blessed $_ ? $_ : + Moose::Util::TypeConstraints::find_or_parse_type_constraint($_) + || __PACKAGE__->_throw_error( "$_ is not a type constraint") + } @args; + + ( scalar @tc == scalar @args) + || __PACKAGE__->_throw_error( + "one of your type constraints is bad. Passed: ". join(', ', @args) ." Got: ". join(', ', @tc)); + + ( scalar @tc >= 2 ) + || __PACKAGE__->_throw_error("You must pass in at least 2 type names to make a union"); + my $union = Moose::Meta::TypeConstraint::Union->new(type_constraints=>\@tc); return Moose::Util::TypeConstraints::register_type_constraint($union); }, + fallback => 1, + ); -=head1 NAME - -MooseX::Types::TypeDecorator - More flexible access to a Type Constraint - =head1 DESCRIPTION This is a decorator object that contains an underlying type constraint. We use @@ -38,31 +68,42 @@ Old school instantiation =cut sub new { - my ($class, %args) = @_; - if( - $args{type_constraint} && ref($args{type_constraint}) && - ($args{type_constraint}->isa('Moose::Meta::TypeConstraint') || - $args{type_constraint}->isa('MooseX::Types::UndefinedType')) - ) { - return bless \%args, $class; + my $class = shift @_; + if(my $arg = shift @_) { + if(blessed $arg && $arg->isa('Moose::Meta::TypeConstraint')) { + return bless {'__type_constraint'=>$arg}, $class; + } elsif( + blessed $arg && + $arg->isa('MooseX::Types::UndefinedType') + ) { + ## stub in case we'll need to handle these types differently + return bless {'__type_constraint'=>$arg}, $class; + } elsif(blessed $arg) { + __PACKAGE__->_throw_error("Argument must be ->isa('Moose::Meta::TypeConstraint') or ->isa('MooseX::Types::UndefinedType'), not ". blessed $arg); + } else { + __PACKAGE__->_throw_error("Argument cannot be '$arg'"); + } } else { - croak "The argument 'type_constraint' is not valid."; + __PACKAGE__->_throw_error("This method [new] requires a single argument."); } - } -=head type_constraint ($type_constraint) +=head2 __type_constraint ($type_constraint) Set/Get the type_constraint. =cut -sub type_constraint { - my $self = shift @_; - if(defined(my $tc = shift @_)) { - $self->{type_constraint} = $tc; +sub __type_constraint { + my $self = shift @_; + if(blessed $self) { + if(defined(my $tc = shift @_)) { + $self->{__type_constraint} = $tc; + } + return $self->{__type_constraint}; + } else { + __PACKAGE__->_throw_error('cannot call __type_constraint as a class method'); } - return $self->{type_constraint}; } =head2 isa @@ -72,15 +113,19 @@ handle $self->isa since AUTOLOAD can't. =cut sub isa { - my ($self, $target) = @_; + my ($self, $target) = @_; if(defined $target) { - my $isa = $self->type_constraint->isa($target); - return $isa; + if(blessed $self) { + return $self->__type_constraint->isa($target); + } else { + return; + } } else { return; } } + =head2 can handle $self->can since AUTOLOAD can't. @@ -90,13 +135,42 @@ handle $self->can since AUTOLOAD can't. sub can { my ($self, $target) = @_; if(defined $target) { - my $can = $self->type_constraint->can($target); - return $can; + if(blessed $self) { + return $self->__type_constraint->can($target); + } else { + return; + } } else { return; } } +=head2 meta + +have meta examine the underlying type constraints + +=cut + +sub meta { + my $self = shift @_; + if(blessed $self) { + return $self->__type_constraint->meta; + } +} + +=head2 _throw_error + +properly delegate error messages + +=cut + +sub _throw_error { + shift; + require Moose; + unshift @_, 'Moose'; + goto &Moose::throw_error; +} + =head2 DESTROY We might need it later @@ -114,14 +188,24 @@ Delegate to the decorator targe =cut sub AUTOLOAD { + + my ($self, @args) = @_; my ($method) = (our $AUTOLOAD =~ /([^:]+)$/); - return shift->type_constraint->$method(@_); + + ## We delegate with this method in an attempt to support a value of + ## __type_constraint which is also AUTOLOADing, in particular the class + ## MooseX::Types::UndefinedType which AUTOLOADs during autovivication. + + my $return; + eval { + $return = $self->__type_constraint->$method(@args); + }; if($@) { + __PACKAGE__->_throw_error($@); + } else { + return $return; + } } -=head1 AUTHOR AND COPYRIGHT - -John Napiorkowski (jnapiorkowski) - =head1 LICENSE This program is free software; you can redistribute it and/or modify