X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FTypes%2FTypeDecorator.pm;h=4278e79d3fdd3e1e088ea17dd2d8fb559de402df;hb=b325a2174547efd3fc0806a88871fde027a35d48;hp=79c77ee12117394ab19936635877978c4c3d9fef;hpb=d8f30dd42921bb59d34e1a44559c673654cdc0d1;p=gitmo%2FMooseX-Types.git diff --git a/lib/MooseX/Types/TypeDecorator.pm b/lib/MooseX/Types/TypeDecorator.pm index 79c77ee..4278e79 100644 --- a/lib/MooseX/Types/TypeDecorator.pm +++ b/lib/MooseX/Types/TypeDecorator.pm @@ -1,32 +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::Meta::TypeConstraint::Union; +use Scalar::Util qw(blessed); use overload( + '0+' => sub { + my $self = shift @_; + my $tc = $self->{__type_constraint}; + return 0+$tc; + }, '""' => sub { - return shift->__type_constraint->name; + my $self = shift @_; + if(blessed $self) { + return $self->__type_constraint->name; + } else { + return "$self"; + } }, + bool => sub { 1 }, '|' => sub { ## 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 @tc = grep {ref $_} @_; + + 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 @@ -43,50 +68,62 @@ Old school instantiation =cut sub new { - my $class = shift @_; + my $proto = shift; + if (ref($proto)) { + return $proto->_try_delegate('new', @_); + } + my $class = $proto; if(my $arg = shift @_) { - if(ref $arg && $arg->isa('Moose::Meta::TypeConstraint')) { + if(blessed $arg && $arg->isa('Moose::Meta::TypeConstraint')) { return bless {'__type_constraint'=>$arg}, $class; - } elsif(ref $arg && $arg->isa('MooseX::Types::UndefinedType')) { + } 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(ref $arg) { - croak "Argument must be ->isa('Moose::Meta::TypeConstraint') or ->isa('MooseX::Types::UndefinedType'), not ". ref $arg; + } elsif(blessed $arg) { + __PACKAGE__->_throw_error("Argument must be ->isa('Moose::Meta::TypeConstraint') or ->isa('MooseX::Types::UndefinedType'), not ". blessed $arg); } else { - croak "Argument cannot be '$arg'"; + __PACKAGE__->_throw_error("Argument cannot be '$arg'"); } } else { - croak "This method [new] requires a single argument of 'arg'."; + __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; + 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 -handle $self->isa since AUTOLOAD can't. +handle $self->isa since AUTOLOAD can't - this tries both the type constraint, +and for a class type, the class. =cut sub isa { - my ($self, $target) = @_; - if(defined $target) { - return $self->__type_constraint->isa($target); - } else { - return; - } + my $self = shift; + return + blessed $self + ? $self->__type_constraint->isa(@_) + || $self->_try_delegate( 'isa', @_ ) + : $self->SUPER::isa(@_); } =head2 can @@ -96,12 +133,24 @@ handle $self->can since AUTOLOAD can't. =cut sub can { - my ($self, $target) = @_; - if(defined $target) { - return $self->__type_constraint->can($target); - } else { - return; - } + my $self = shift; + + return blessed $self + ? $self->_try_delegate( 'can', @_ ) + : $self->SUPER::can(@_); +} + +=head2 _throw_error + +properly delegate error messages + +=cut + +sub _throw_error { + shift; + require Moose; + unshift @_, 'Moose'; + goto &Moose::throw_error; } =head2 DESTROY @@ -116,23 +165,59 @@ sub DESTROY { =head2 AUTOLOAD -Delegate to the decorator targe +Delegate to the decorator target, unless this is a class type, in which +case it will try to delegate to the type object, then if that fails try +the class. The method 'new' is special cased to only be permitted on +the class; if there is no class, or it does not provide a new method, +an exception will be thrown. =cut sub AUTOLOAD { my ($self, @args) = @_; my ($method) = (our $AUTOLOAD =~ /([^:]+)$/); - if($self->__type_constraint->can($method)) { - return $self->__type_constraint->$method(@args); - } else { - croak "Method '$method' is not supported"; - } + + ## 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. + + $self->_try_delegate($method, @args); } -=head1 AUTHOR AND COPYRIGHT +sub _try_delegate { + my ($self, $method, @args) = @_; + my $tc = $self->__type_constraint; + my $class; + if ($tc->can('is_subtype_of')) { # Union can't + my $search_tc = $tc; + while (1) { + if ($search_tc->isa('Moose::Meta::TypeConstraint::Class')) { + $class = $search_tc->class; + last; + } + $search_tc = $search_tc->parent; + last unless $search_tc && $search_tc->is_subtype_of('Object'); + } + } + + my $inv = do { + if ($method eq 'new') { + die "new called on type decorator for non-class-type ".$tc->name + unless $class; + die "new called on class type decorator ".$tc->name."\n" + ." for class ${class}\n" + ." which does not provide a new method - did you forget to load it?" + unless $class->can('new'); + $class + } elsif ($class && !$tc->can($method)) { + $class + } else { + $tc + } + }; -John Napiorkowski (jnapiorkowski) + $inv->$method(@args); +} =head1 LICENSE