X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FUtil.pm;h=7b18a3f01dff55ee400be1515a17f0b33477be0d;hb=9df136d0ec3963a967e8ac7fdfacffa3e0d50cd9;hp=ef9646db7133da8046447ed0390768673911b881;hpb=1631b53f3cecc6033043b6e4bf858113e0054b7a;p=gitmo%2FMoose.git

diff --git a/lib/Moose/Util.pm b/lib/Moose/Util.pm
index ef9646d..7b18a3f 100644
--- a/lib/Moose/Util.pm
+++ b/lib/Moose/Util.pm
@@ -1,37 +1,99 @@
 package Moose::Util;
 
-use Exporter qw/import/;
-use Scalar::Util qw/blessed/;
-
 use strict;
 use warnings;
 
-our $VERSION = '0.01';
+use Sub::Exporter;
+use Scalar::Util 'blessed';
+use Carp         'confess';
+use Class::MOP   ();
+
+our $VERSION   = '0.02';
+our $AUTHORITY = 'cpan:STEVAN';
+
+my @exports = qw[
+    find_meta 
+    does_role
+    search_class_by_role   
+    apply_all_roles
+];
+
+Sub::Exporter::setup_exporter({
+    exports => \@exports,
+    groups  => { all => \@exports }
+});
 
-our $AUTHORITY = 'cpan:BERLE';
+## some utils for the utils ...
 
-our @EXPORT_OK = qw/can_role search_class_by_role/;
+sub find_meta { 
+    return unless $_[0];
+    return Class::MOP::get_metaclass_by_name(blessed($_[0]) || $_[0]);
+}
+
+## the functions ...
 
-sub can_role {
-  my ($class,$does) = @_;
+sub does_role {
+    my ($class_or_obj, $role) = @_;
 
-  return ((!ref $class && eval { $class->isa ('UNIVERSAL') }) || Scalar::Util::blessed ($class))
-    && $class->can ('does')
-    && $class->does ($does);
+    my $meta = find_meta($class_or_obj);
+    
+    return unless defined $meta;
+
+    return 1 if $meta->does_role($role);
+    return;
 }
 
 sub search_class_by_role {
-    my ($obj, $role_name) = @_;
+    my ($class_or_obj, $role_name) = @_;
+    
+    my $meta = find_meta($class_or_obj);
+
+    return unless defined $meta;
 
-    for my $class ($obj->meta->class_precedence_list) {
-        for my $role (@{ $class->meta->roles || [] }) {
+    foreach my $class ($meta->class_precedence_list) {
+        
+        my $_meta = find_meta($class);        
+
+        next unless defined $_meta;
+
+        foreach my $role (@{ $_meta->roles || [] }) {
             return $class if $role->name eq $role_name;
         }
     }
 
-    return undef;
+    return;
 }
 
+sub apply_all_roles {
+    my $applicant = shift;
+    
+    confess "Must specify at least one role to apply to $applicant" unless @_;
+    
+    my $roles = Data::OptList::mkopt([ @_ ]);
+    
+    #use Data::Dumper;
+    #warn Dumper $roles;
+    
+    my $meta = (blessed $applicant ? $applicant : find_meta($applicant));
+    
+    Class::MOP::load_class($_->[0]) for @$roles;
+    
+    ($_->[0]->can('meta') && $_->[0]->meta->isa('Moose::Meta::Role'))
+        || confess "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 {
+        Moose::Meta::Role->combine(
+            @$roles
+        )->apply($meta);
+    }    
+}
+
+
 1;
 
 __END__
@@ -40,34 +102,66 @@ __END__
 
 =head1 NAME
 
-Moose::Util - Moose utilities
+Moose::Util - Utilities for working with Moose classes
 
 =head1 SYNOPSIS
 
-  use Moose::Util qw/can_role search_class_by_role/;
+  use Moose::Util qw/find_meta does_role search_class_by_role/;
+
+  my $meta = find_meta($object) || die "No metaclass found";
 
-  if (can_role ($object,'rolename')) {
-    print "The object can do rolename!\n";
+  if (does_role($object, $role)) {
+    print "The object can do $role!\n";
   }
 
   my $class = search_class_by_role($object, 'FooRole');
   print "Nearest class with 'FooRole' is $class\n";
 
-=head1 FUNCTIONS
+=head1 DESCRIPTION
+
+This is a set of utility functions to help working with Moose classes. This 
+is an experimental module, and it's not 100% clear what purpose it will serve. 
+That said, ideas, suggestions and contributions to this collection are most 
+welcome. See the L<TODO> section below for a list of ideas for possible 
+functions to write.
+
+=head1 EXPORTED FUNCTIONS
 
 =over 4
 
-=item can_role
+=item B<find_meta ($class_or_obj)>
+
+This will attempt to locate a metaclass for the given C<$class_or_obj>
+and return it.
+
+=item B<does_role ($class_or_obj, $role_name)>
 
-  can_role ($object,$rolename);
+Returns true if C<$class_or_obj> can do the role C<$role_name>.
 
-Returns true if $object can do the role $rolename.
+=item B<search_class_by_role ($class_or_obj, $role_name)>
 
-=item search_class_by_role
+Returns first class in precedence list that consumed C<$role_name>.
 
-  my $class = search_class_by_role($object, $rolename);
+=item B<apply_all_roles ($applicant, @roles)>
 
-Returns first class in precedence list that consumed C<$rolename>.
+Given an C<$applicant> (which can somehow be turned into either a 
+metaclass or a metarole) and a list of C<@roles> this will do the 
+right thing to apply the C<@roles> to the C<$applicant>. This is 
+actually used internally by both L<Moose> and L<Moose::Role>, and the
+C<@roles> will be pre-processed through L<Data::OptList::mkopt>
+to allow for the additional arguments to be passed. 
+
+=back
+
+=head1 TODO
+
+Here is a list of possible functions to write
+
+=over 4
+
+=item discovering original method from modified method
+
+=item search for origin class of a method or attribute
 
 =back
 
@@ -81,9 +175,15 @@ to cpan-RT.
 
 Anders Nor Berle E<lt>debolaz@gmail.comE<gt>
 
+B<with contributions from:>
+
+Robert (phaylon) Sedlacek
+
+Stevan Little
+
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2007 by Infinity Interactive, Inc.
+Copyright 2007-2008 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>