package Mouse::Util::TypeConstraints;
-use Mouse::Util qw(does_role not_supported); # enables strict and warnings
-
-use Carp ();
-use Scalar::Util ();
+use Mouse::Util; # enables strict and warnings
use Mouse::Meta::TypeConstraint;
use Mouse::Exporter;
+use Carp ();
+use Scalar::Util ();
+
Mouse::Exporter->setup_import_methods(
as_is => [qw(
as where message optimize_as
RoleName => 'ClassName', \&RoleName,
);
-
while (my ($name, $parent, $code) = splice @builtins, 0, 3) {
$TYPE{$name} = Mouse::Meta::TypeConstraint->new(
name => $name,
);
}
-# make it parametarizable
-
+# parametarizable types
$TYPE{Maybe} {constraint_generator} = \&_parameterize_Maybe_for;
$TYPE{ArrayRef}{constraint_generator} = \&_parameterize_ArrayRef_for;
$TYPE{HashRef} {constraint_generator} = \&_parameterize_HashRef_for;
# sugars
-
sub as ($) { (as => $_[0]) } ## no critic
sub where (&) { (where => $_[0]) } ## no critic
sub message (&) { (message => $_[0]) } ## no critic
undef @builtins; # free the allocated memory
@builtins = keys %TYPE; # reuse it
sub list_all_builtin_type_constraints { @builtins }
-
sub list_all_type_constraints { keys %TYPE }
-sub _create_type{
- my $mode = shift;
-
+sub _define_type {
+ my $is_subtype = shift;
my $name;
my %args;
- if(@_ == 1 && ref $_[0]){ # @_ : { name => $name, where => ... }
+ if(@_ == 1 && ref $_[0] ){ # @_ : { name => $name, where => ... }
%args = %{$_[0]};
}
- elsif(@_ == 2 && ref $_[1]){ # @_ : $name => { where => ... }
+ elsif(@_ == 2 && ref $_[1]) { # @_ : $name => { where => ... }
$name = $_[0];
%args = %{$_[1]};
}
- elsif(@_ % 2){ # @_ : $name => ( where => ... )
+ elsif(@_ % 2) { # @_ : $name => ( where => ... )
($name, %args) = @_;
}
- else{ # @_ : (name => $name, where => ...)
+ else{ # @_ : (name => $name, where => ...)
%args = @_;
}
}
$args{name} = $name;
- my $parent;
- if($mode eq 'subtype'){
- $parent = delete $args{as};
- if(!$parent){
- $parent = delete $args{name};
- $name = undef;
- }
+
+ my $parent = delete $args{as};
+ if($is_subtype && !$parent){
+ $parent = delete $args{name};
+ $name = undef;
+ }
+
+ if(defined $parent) {
+ $args{parent} = find_or_create_isa_type_constraint($parent);
}
if(defined $name){
}
}
- if($TYPE{$name}){
+ if(defined $TYPE{$name}){
my $that = $TYPE{$name}->{package_defined_in} || __PACKAGE__;
if($this ne $that) {
my $note = '';
}
}
}
- else{
- $args{name} = '__ANON__';
- }
$args{constraint} = delete $args{where} if exists $args{where};
$args{optimized} = delete $args{optimized_as} if exists $args{optimized_as};
- my $constraint;
- if($mode eq 'subtype'){
- $constraint = find_or_create_isa_type_constraint($parent)->create_child_type(%args);
- }
- else{
- $constraint = Mouse::Meta::TypeConstraint->new(%args);
- }
+ my $constraint = Mouse::Meta::TypeConstraint->new(%args);
if(defined $name){
return $TYPE{$name} = $constraint;
}
sub type {
- return _create_type('type', @_);
+ return _define_type 0, @_;
}
sub subtype {
- return _create_type('subtype', @_);
+ return _define_type 1, @_;
}
-sub coerce {
+sub coerce { # coerce $type, from $from, via { ... }, ...
my $type_name = shift;
-
my $type = find_type_constraint($type_name)
- or Carp::croak("Cannot find type '$type_name', perhaps you forgot to load it.");
+ or Carp::croak("Cannot find type '$type_name', perhaps you forgot to load it");
$type->_add_type_coercions(@_);
return;
my $class = $options->{class} || $name;
# ClassType
- return _create_type 'subtype', $name => (
+ return subtype $name => (
as => 'Object',
optimized_as => Mouse::Util::generate_isa_predicate_for($class),
+ class => $class,
);
}
my $role = $options->{role} || $name;
# RoleType
- return _create_type 'subtype', $name => (
+ return subtype $name => (
as => 'Object',
- optimized_as => sub { Scalar::Util::blessed($_[0]) && does_role($_[0], $role) },
+ optimized_as => sub {
+ return Scalar::Util::blessed($_[0])
+ && Mouse::Util::does_role($_[0], $role);
+ },
+ role => $role,
);
}
sub duck_type {
my($name, @methods);
- if(!(@_ == 1 && ref($_[0]) eq 'ARRAY')){
+ if(ref($_[0]) ne 'ARRAY'){
$name = shift;
}
@methods = (@_ == 1 && ref($_[0]) eq 'ARRAY') ? @{$_[0]} : @_;
# DuckType
- return _create_type 'subtype', $name => (
+ return _define_type 1, $name => (
as => 'Object',
optimized_as => Mouse::Util::generate_can_predicate_for(\@methods),
+ message => sub {
+ my($object) = @_;
+ my @missing = grep { !$object->can($_) } @methods;
+ return ref($object)
+ . ' is missing methods '
+ . Mouse::Util::quoted_english_list(@missing);
+ },
+ methods => \@methods,
);
}
$name = shift;
}
- %valid = map{ $_ => undef } (@_ == 1 && ref($_[0]) eq 'ARRAY' ? @{$_[0]} : @_);
+ %valid = map{ $_ => undef }
+ (@_ == 1 && ref($_[0]) eq 'ARRAY' ? @{$_[0]} : @_);
# EnumType
- return _create_type 'subtype', $name => (
+ return _define_type 1, $name => (
as => 'Str',
- optimized_as => sub{ defined($_[0]) && !ref($_[0]) && exists $valid{$_[0]} },
+ optimized_as => sub{
+ return defined($_[0]) && !ref($_[0]) && exists $valid{$_[0]};
+ },
);
}
}
sub _find_or_create_union_type{
- return if grep{ not defined } @_;
- my @types = sort map{ $_->{type_constraints} ? @{$_->{type_constraints}} : $_ } @_;
+ return if grep{ not defined } @_; # all things must be defined
+ my @types = sort
+ map{ $_->{type_constraints} ? @{$_->{type_constraints}} : $_ } @_;
my $name = join '|', @types;
sub find_type_constraint {
my($spec) = @_;
- return $spec if Mouse::Util::is_a_type_constraint($spec);
- return undef if !defined $spec;
+ return $spec if Mouse::Util::is_a_type_constraint($spec) or not defined $spec;
$spec =~ s/\s+//g;
return $TYPE{$spec};
my($constraint) = @_;
Carp::croak("No type supplied / type is not a valid type constraint")
unless Mouse::Util::is_a_type_constraint($constraint);
- my $name = $constraint->name;
- Carp::croak("can't register an unnamed type constraint")
- unless defined $name;
- return $TYPE{$name} = $constraint;
+ return $TYPE{$constraint->name} = $constraint;
}
sub find_or_parse_type_constraint {
my($spec) = @_;
- return $spec if Mouse::Util::is_a_type_constraint($spec);
- return undef if !defined $spec;
+ return $spec if Mouse::Util::is_a_type_constraint($spec) or not defined $spec;
- $spec =~ s/\s+//g;
- return $TYPE{$spec} || do{
- my $context = {
- spec => $spec,
- orig => $spec,
- };
- my $type = _parse_type($context);
+ $spec =~ tr/ \t\r\n//d;
- if($context->{spec}){
- Carp::croak("Syntax error: extra elements '$context->{spec}' in '$context->{orig}'");
- }
- $type;
- };
+ my $tc = $TYPE{$spec};
+ if(defined $tc) {
+ return $tc;
+ }
+
+ my %context = (
+ spec => $spec,
+ orig => $spec,
+ );
+ $tc = _parse_type(\%context);
+
+ if($context{spec}){
+ Carp::croak("Syntax error: extra elements '$context{spec}' in '$context{orig}'");
+ }
+
+ return $TYPE{$spec} = $tc;
}
sub find_or_create_does_type_constraint{
# XXX: Moose does not register a new role_type, but Mouse does.
- return find_or_parse_type_constraint(@_) || role_type(@_);
+ my $tc = find_or_parse_type_constraint(@_);
+ return defined($tc) ? $tc : role_type(@_);
}
sub find_or_create_isa_type_constraint {
# XXX: Moose does not register a new class_type, but Mouse does.
- return find_or_parse_type_constraint(@_) || class_type(@_);
+ my $tc = find_or_parse_type_constraint(@_);
+ return defined($tc) ? $tc : class_type(@_);
}
1;
=head1 VERSION
-This document describes Mouse version 0.68
+This document describes Mouse version 0.88
=head2 SYNOPSIS