add with qw( Role1 Role2 ) support
[gitmo/Mouse.git] / lib / Mouse / Util.pm
index 0c95684..330c63e 100644 (file)
 package Mouse::Util;
 use strict;
 use warnings;
-use base 'Exporter';
+use base qw/Exporter/;
 use Carp;
 
+our @EXPORT_OK = qw(
+    blessed
+    get_linear_isa
+    looks_like_number
+    openhandle
+    reftype
+    weaken
+);
+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 {
-    our %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 {
+    # 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__});
-                    length(ref($_[0]))
-                        ? eval { $_[0]->a_sub_not_likely_to_be_here }
-                        : undef;
+                    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
                 },
-            },
-            '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";
+                '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);
                     }
-                    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";
+                    elsif ($rt ne 'GLOB') {
+                        return undef;
                     }
-                }
-                : $t
+    
+                    (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   ^^^^^
             },
-            'openhandle' => sub {
+        );
+    
+        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;
+            }
+        }
+    } 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) {
+            *openhandle = \&Scalar::Util::openhandle;
+        } else {
+            # XXX - room for improvement
+            *openhandle = sub {
                 my $fh = shift;
                 my $rt = reftype($fh) || '';
 
@@ -86,150 +195,66 @@ BEGIN {
 
                 (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   ^^^^^
-        },
-#       VVVVV   CODE TAKEN FROM TEST::EXCEPTION   VVVVV
-        'Test::Exception' => do {
-
-            my $Tester;
-
-            my $is_exception = sub {
-                my $exception = shift;
-                return ref $exception || $exception ne '';
             };
+        }
 
-            my $exception_as_string = sub {
-                my ( $prefix, $exception ) = @_;
-                return "$prefix normal exit" unless $is_exception->( $exception );
-                my $class = ref $exception;
-                $exception = "$class ($exception)"
-                        if $class && "$exception" !~ m/^\Q$class/;
-                chomp $exception;
-                return "$prefix $exception";
-            };
-            my $try_as_caller = sub {
-                my $coderef = shift;
-                eval { $coderef->() };
-                $@;
+        if (defined &mro::get_linear_isa || eval { require MRO::Compat; 1; }) {
+            *get_linear_isa = \&mro::get_linear_isa;
+        } else {
+            # this recurses so it isn't pretty
+            my $code;
+            *get_linear_isa = $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;
             };
-
-            {
-                'throws_ok' => sub (&$;$) {
-                    my ( $coderef, $expecting, $description ) = @_;
-                    Carp::croak "throws_ok: must pass exception class/object or regex"
-                        unless defined $expecting;
-                    $description = $exception_as_string->( "threw", $expecting )
-                        unless defined $description;
-                    my $exception = $try_as_caller->($coderef);
-
-                    $Tester ||= Test::Builder->new;
-
-                    my $regex = $Tester->maybe_regex( $expecting );
-                    my $ok = $regex
-                        ? ( $exception =~ m/$regex/ )
-                        : eval {
-                            $exception->isa( ref $expecting ? ref $expecting : $expecting )
-                        };
-                    $Tester->ok( $ok, $description );
-                    unless ( $ok ) {
-                        $Tester->diag( $exception_as_string->( "expecting:", $expecting ) );
-                        $Tester->diag( $exception_as_string->( "found:", $exception ) );
-                    };
-                    $@ = $exception;
-                    return $ok;
-                },
-                'lives_ok' => sub (&;$) {
-                    my ( $coderef, $description ) = @_;
-                    my $exception = $try_as_caller->( $coderef );
-
-                    $Tester ||= Test::Builder->new;
-
-                    my $ok = $Tester->ok( ! $is_exception->( $exception ), $description );
-                    $Tester->diag( $exception_as_string->( "died:", $exception ) ) unless $ok;
-                    $@ = $exception;
-                    return $ok;
-                },
-            },
-        },
-    );
-
-    our %loaded;
-
-    our @EXPORT_OK = map { keys %$_ } values %dependencies;
-    our %EXPORT_TAGS = (
-        all  => \@EXPORT_OK,
-        test => [qw/throws_ok lives_ok/],
-    );
-
-    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;
         }
     }
 }
 
 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;
+    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;