Throw a more useful error when users try to use a parameterized type,
[gitmo/Mouse.git] / lib / Mouse / Util.pm
index 9d87d5a..33c51f1 100644 (file)
-#!/usr/bin/env perl
 package Mouse::Util;
 use strict;
 use warnings;
-use Exporter 'import';
+use base qw/Exporter/;
 use Carp;
 
 our @EXPORT_OK = qw(
-    blessed
     get_linear_isa
-    looks_like_number
-    openhandle
-    reftype
-    weaken
+    apply_all_roles
 );
 our %EXPORT_TAGS = (
     all  => \@EXPORT_OK,
 );
 
-# We only have to do this nastiness if we haven't loaded XS version of
-# Mouse.pm, so check if we're running under PurePerl or not
 BEGIN {
-    # Checking for undefinedness will ensure that our functions are
-    # properly loaded without loading Mouse, but this is kind of ugly
-    if ($Mouse::PurePerl || ! defined $Mouse::PurePerl) {
-        my %dependencies = (
-            'Scalar::Util' => {
-    #       VVVVV   CODE TAKEN FROM SCALAR::UTIL   VVVVV
-                'blessed' => do {
-                    *UNIVERSAL::a_sub_not_likely_to_be_here = sub {
-                        my $ref = ref($_[0]);
-    
-                        # deviation from Scalar::Util
-                        # XS returns undef, PP returns GLOB.
-                        # let's make that more consistent by having PP return
-                        # undef if it's a GLOB. :/
-    
-                        # \*STDOUT would be allowed as an object in PP blessed
-                        # but not XS
-                        return $ref eq 'GLOB' ? undef : $ref;
-                    };
-    
-                    sub {
-                        local($@, $SIG{__DIE__}, $SIG{__WARN__});
-                        length(ref($_[0]))
-                            ? eval { $_[0]->a_sub_not_likely_to_be_here }
-                            : undef;
-                    },
-                },
-                'looks_like_number' => sub {
-                    local $_ = shift;
-    
-                    # checks from perlfaq4
-                    return 0 if !defined($_) or ref($_);
-                    return 1 if (/^[+-]?\d+$/); # is a +/- integer
-                    return 1 if (/^([+-]?)(?=\d|\.\d)\d*(\.\d*)?([Ee]([+-]?\d+))?$/); # a C float
-                    return 1 if ($] >= 5.008 and /^(Inf(inity)?|NaN)$/i) or ($] >= 5.006001 and /^Inf$/i);
-    
-                    0;
-                },
-                'reftype' => sub {
-                    local($@, $SIG{__DIE__}, $SIG{__WARN__});
-                    my $r = shift;
-                    my $t;
-    
-                    length($t = ref($r)) or return undef;
-    
-                    # This eval will fail if the reference is not blessed
-                    eval { $r->a_sub_not_likely_to_be_here; 1 }
-                    ? do {
-                        $t = eval {
-                            # we have a GLOB or an IO. Stringify a GLOB gives it's name
-                            my $q = *$r;
-                            $q =~ /^\*/ ? "GLOB" : "IO";
-                        }
-                        or do {
-                            # OK, if we don't have a GLOB what parts of
-                            # a glob will it populate.
-                            # NOTE: A glob always has a SCALAR
-                            local *glob = $r;
-                            defined *glob{ARRAY} && "ARRAY"
-                                or defined *glob{HASH} && "HASH"
-                                or defined *glob{CODE} && "CODE"
-                                or length(ref(${$r})) ? "REF" : "SCALAR";
-                        }
-                    }
-                    : $t
-                },
-                'openhandle' => sub {
-                    my $fh = shift;
-                    my $rt = reftype($fh) || '';
-    
-                    return defined(fileno($fh)) ? $fh : undef
-                        if $rt eq 'IO';
-    
-                    if (reftype(\$fh) eq 'GLOB') { # handle  openhandle(*DATA)
-                        $fh = \(my $tmp=$fh);
-                    }
-                    elsif ($rt ne 'GLOB') {
-                        return undef;
-                    }
-    
-                    (tied(*$fh) or defined(fileno($fh)))
-                        ? $fh : undef;
-                },
-                weaken => {
-                    loaded => \&Scalar::Util::weaken,
-                    not_loaded => sub { die "Scalar::Util required for weak reference support" },
-                },
-    #       ^^^^^   CODE TAKEN FROM SCALAR::UTIL   ^^^^^
-            },
-            'MRO::Compat' => {
-    #       VVVVV   CODE TAKEN FROM MRO::COMPAT   VVVVV
-                'get_linear_isa' => {
-                    loaded     => \&mro::get_linear_isa,
-                    not_loaded => do {
-                        # this recurses so it isn't pretty
-                        my $code;
-                        $code = sub {
-                            no strict 'refs';
-    
-                            my $classname = shift;
-    
-                            my @lin = ($classname);
-                            my %stored;
-                            foreach my $parent (@{"$classname\::ISA"}) {
-                                my $plin = $code->($parent);
-                                foreach (@$plin) {
-                                    next if exists $stored{$_};
-                                    push(@lin, $_);
-                                    $stored{$_} = 1;
-                                }
-                            }
-                            return \@lin;
-                        }
-                    },
-                },
-    #       ^^^^^   CODE TAKEN FROM MRO::COMPAT   ^^^^^
-            },
-        );
-    
-        my %loaded;
-        for my $module_name (keys %dependencies) {
-            my $loaded = do {
-                local $SIG{__DIE__} = 'DEFAULT';
-                eval "require $module_name; 1";
-            };
-    
-            $loaded{$module_name} = $loaded;
-    
-            for my $method_name (keys %{ $dependencies{ $module_name } }) {
-                my $producer = $dependencies{$module_name}{$method_name};
-                my $implementation;
-    
-                if (ref($producer) eq 'HASH') {
-                    $implementation = $loaded
-                                    ? $producer->{loaded}
-                                    : $producer->{not_loaded};
-                }
-                else {
-                    $implementation = $loaded
-                                    ? $module_name->can($method_name)
-                                    : $producer;
-                }
-    
-                no strict 'refs';
-                *{ __PACKAGE__ . '::' . $method_name } = $implementation;
-            }
-        }
+    my $impl;
+    if ($] >= 5.009_005) {
+        require mro;
+        $impl = \&mro::get_linear_isa;
     } else {
-        # If we're running under XS, we can provide
-        #   blessed
-        #   looks_like_number
-        #   reftype
-        #   weaken
-        # other functions need to be loaded from our respective sources
-
-        if (defined &Scalar::Util::openhandle || eval { require Scalar::Util; 1 }) {
-            *openhandle = \&Scalar::Util::openhandle;
-        } else {
-            # XXX - room for improvement
-            *openhandle = sub {
-                my $fh = shift;
-                my $rt = reftype($fh) || '';
-
-                return defined(fileno($fh)) ? $fh : undef
-                    if $rt eq 'IO';
-
-                if (reftype(\$fh) eq 'GLOB') { # handle  openhandle(*DATA)
-                    $fh = \(my $tmp=$fh);
-                }
-                elsif ($rt ne 'GLOB') {
-                    return undef;
-                }
-
-                (tied(*$fh) or defined(fileno($fh)))
-                    ? $fh : undef;
-            };
-        }
-
-        if (defined &mro::get_linear_isa || eval { require MRO::Compat; 1; }) {
-            *get_linear_isa = \&mro::get_linear_isa;
+        my $loaded = do {
+            local $SIG{__DIE__} = 'DEFAULT';
+            eval "require MRO::Compat; 1";
+        };
+        if ($loaded) {
+            $impl = \&mro::get_linear_isa;
         } else {
-            # this recurses so it isn't pretty
-            my $code;
-            *get_linear_isa = $code = sub {
+#       VVVVV   CODE TAKEN FROM MRO::COMPAT   VVVVV
+            my $code; # this recurses so it isn't pretty
+            $code = sub {
                 no strict 'refs';
 
                 my $classname = shift;
@@ -220,17 +44,48 @@ BEGIN {
                 }
                 return \@lin;
             };
+#       ^^^^^   CODE TAKEN FROM MRO::COMPAT   ^^^^^
+            $impl = $code;
         }
     }
+
+    no strict 'refs';
+    *{ __PACKAGE__ . '::get_linear_isa'} = $impl;
 }
 
 sub apply_all_roles {
     my $meta = Mouse::Meta::Class->initialize(shift);
-    my $role  = shift;
-    confess "Mouse::Util only supports 'apply_all_roles' on individual roles at a time" if @_;
 
-    Mouse::load_class($role);
-    $role->meta->apply($meta);
+    my @roles;
+
+    # Basis of Data::OptList
+    my $max = scalar(@_);
+    for (my $i = 0; $i < $max ; $i++) {
+        if ($i + 1 < $max && ref($_[$i + 1])) {
+            push @roles, [ $_[$i++] => $_[$i] ];
+        } else {
+            push @roles, [ $_[$i] => {} ];
+        }
+    }
+
+    foreach my $role_spec (@roles) {
+        Mouse::load_class( $role_spec->[0] );
+    }
+
+    ( $_->[0]->can('meta') && $_->[0]->meta->isa('Mouse::Meta::Role') )
+        || croak("You can only consume roles, "
+        . $_->[0]
+        . " is not a Moose role")
+        foreach @roles;
+
+    if ( scalar @roles == 1 ) {
+        my ( $role, $params ) = @{ $roles[0] };
+        $role->meta->apply( $meta, ( defined $params ? %$params : () ) );
+    }
+    else {
+        Mouse::Meta::Role->combine_apply($meta, @roles);
+    }
+
 }
 
 1;
@@ -247,26 +102,5 @@ Mouse::Util - features, with or without their dependencies
 
 =head3 get_linear_isa
 
-=head2 L<Scalar::Util>
-
-=head3 blessed
-
-=head3 looks_like_number
-
-=head3 reftype
-
-=head3 openhandle
-
-=head3 weaken
-
-C<weaken> I<must> be implemented in XS. If the user tries to use C<weaken>
-without L<Scalar::Util>, an error is thrown.
-
-=head2 Test::Exception
-
-=head3 throws_ok
-
-=head3 lives_ok
-
 =cut