Version 0.17.
[gitmo/MooseX-AttributeHelpers.git] / lib / MooseX / AttributeHelpers / MethodProvider / Array.pm
index 2b294a7..3fead0c 100644 (file)
 package MooseX::AttributeHelpers::MethodProvider::Array;
 use Moose::Role;
 
+our $VERSION   = '0.17';
+$VERSION = eval $VERSION;
+our $AUTHORITY = 'cpan:STEVAN';
+
+with 'MooseX::AttributeHelpers::MethodProvider::List';
+
 sub push : method {
-    my ($attr) = @_;
-    if ($attr->has_container_type) {
-        my $container_type_constraint = $attr->container_type_constraint;
+    my ($attr, $reader, $writer) = @_;
+    
+    if ($attr->has_type_constraint && $attr->type_constraint->isa('Moose::Meta::TypeConstraint::Parameterized')) {
+        my $container_type_constraint = $attr->type_constraint->type_parameter;
         return sub { 
             my $instance = CORE::shift;
             $container_type_constraint->check($_) 
                 || confess "Value " . ($_||'undef') . " did not pass container type constraint"
                     foreach @_;
-            CORE::push @{$attr->get_value($instance)} => @_; 
+            CORE::push @{$reader->($instance)} => @_; 
         };                    
     }
     else {
         return sub { 
             my $instance = CORE::shift;
-            CORE::push @{$attr->get_value($instance)} => @_; 
+            CORE::push @{$reader->($instance)} => @_; 
         };
     }
 }
 
 sub pop : method {
-    my ($attr) = @_;
+    my ($attr, $reader, $writer) = @_;
     return sub { 
-        CORE::pop @{$attr->get_value($_[0])} 
+        CORE::pop @{$reader->($_[0])} 
     };
 }
 
 sub unshift : method {
-    my ($attr) = @_;
-    if ($attr->has_container_type) {
-        my $container_type_constraint = $attr->container_type_constraint;
+    my ($attr, $reader, $writer) = @_;
+    if ($attr->has_type_constraint && $attr->type_constraint->isa('Moose::Meta::TypeConstraint::Parameterized')) {
+        my $container_type_constraint = $attr->type_constraint->type_parameter;
         return sub { 
             my $instance = CORE::shift;
             $container_type_constraint->check($_) 
                 || confess "Value " . ($_||'undef') . " did not pass container type constraint"
                     foreach @_;
-            CORE::unshift @{$attr->get_value($instance)} => @_; 
+            CORE::unshift @{$reader->($instance)} => @_; 
         };                    
     }
     else {                
         return sub { 
             my $instance = CORE::shift;
-            CORE::unshift @{$attr->get_value($instance)} => @_; 
+            CORE::unshift @{$reader->($instance)} => @_; 
         };
     }
 }
 
 sub shift : method {
-    my ($attr) = @_;
+    my ($attr, $reader, $writer) = @_;
     return sub { 
-        CORE::shift @{$attr->get_value($_[0])} 
+        CORE::shift @{$reader->($_[0])} 
     };
 }
    
 sub get : method {
-    my ($attr) = @_;
+    my ($attr, $reader, $writer) = @_;
     return sub { 
-        $attr->get_value($_[0])->[$_[1]] 
+        $reader->($_[0])->[$_[1]] 
     };
 }
 
 sub set : method {
-    my ($attr) = @_;
-    if ($attr->has_container_type) {
-        my $container_type_constraint = $attr->container_type_constraint;
+    my ($attr, $reader, $writer) = @_;
+    if ($attr->has_type_constraint && $attr->type_constraint->isa('Moose::Meta::TypeConstraint::Parameterized')) {
+        my $container_type_constraint = $attr->type_constraint->type_parameter;
         return sub { 
             ($container_type_constraint->check($_[2])) 
                 || confess "Value " . ($_[2]||'undef') . " did not pass container type constraint";
-            $attr->get_value($_[0])->[$_[1]] = $_[2]
+            $reader->($_[0])->[$_[1]] = $_[2]
         };                    
     }
     else {                
         return sub { 
-            $attr->get_value($_[0])->[$_[1]] = $_[2] 
+            $reader->($_[0])->[$_[1]] = $_[2] 
         };
     }
 }
-sub count : method {
-    my ($attr) = @_;
-    return sub { 
-        scalar @{$attr->get_value($_[0])} 
-    };        
-}
 
-sub empty : method {
-    my ($attr) = @_;
+sub clear : method {
+    my ($attr, $reader, $writer) = @_;
     return sub { 
-        scalar @{$attr->get_value($_[0])} ? 1 : 0 
-    };        
+        @{$reader->($_[0])} = ()
+    };
 }
 
-sub find : method {
-    my ($attr) = @_;
+sub delete : method {
+    my ($attr, $reader, $writer) = @_;
     return sub {
-        my ($instance, $predicate) = @_;
-        foreach my $val (@{$attr->get_value($instance)}) {
-            return $val if $predicate->($val);
-        }
-        return;
-    };
+        CORE::splice @{$reader->($_[0])}, $_[1], 1;
+    }
 }
 
-sub map : method {
-    my ($attr) = @_;
-    return sub {
-        my ($instance, $f) = @_;
-        CORE::map { $f->($_) } @{$attr->get_value($instance)}
-    };
+sub insert : method {
+    my ($attr, $reader, $writer) = @_;
+    if ($attr->has_type_constraint && $attr->type_constraint->isa('Moose::Meta::TypeConstraint::Parameterized')) {
+        my $container_type_constraint = $attr->type_constraint->type_parameter;
+        return sub { 
+            ($container_type_constraint->check($_[2])) 
+                || confess "Value " . ($_[2]||'undef') . " did not pass container type constraint";
+            CORE::splice @{$reader->($_[0])}, $_[1], 0, $_[2];
+        };                    
+    }
+    else {                
+        return sub { 
+            CORE::splice @{$reader->($_[0])}, $_[1], 0, $_[2];
+        };
+    }    
 }
 
-sub grep : method {
-    my ($attr) = @_;
+sub splice : method {
+    my ($attr, $reader, $writer) = @_;
+    if ($attr->has_type_constraint && $attr->type_constraint->isa('Moose::Meta::TypeConstraint::Parameterized')) {
+        my $container_type_constraint = $attr->type_constraint->type_parameter;
+        return sub { 
+            my ( $self, $i, $j, @elems ) = @_;
+            ($container_type_constraint->check($_)) 
+                || confess "Value " . (defined($_) ? $_ : 'undef') . " did not pass container type constraint" for @elems;
+            CORE::splice @{$reader->($self)}, $i, $j, @elems;
+        };                    
+    }
+    else {                
+        return sub {
+            my ( $self, $i, $j, @elems ) = @_;
+            CORE::splice @{$reader->($self)}, $i, $j, @elems;
+        };
+    }    
+}
+
+sub sort_in_place : method {
+    my ($attr, $reader, $writer) = @_;
     return sub {
         my ($instance, $predicate) = @_;
-        CORE::grep { $predicate->($_) } @{$attr->get_value($instance)}
+
+        die "Argument must be a code reference"
+            if $predicate && ref $predicate ne 'CODE';
+
+        my @sorted;
+        if ($predicate) {
+            @sorted = CORE::sort { $predicate->($a, $b) } @{$reader->($instance)};
+        }
+        else {
+            @sorted = CORE::sort @{$reader->($instance)};
+        }
+
+        $writer->($instance, \@sorted);
     };
 }
 
@@ -129,7 +165,7 @@ __END__
 =head1 NAME
 
 MooseX::AttributeHelpers::MethodProvider::Array
-  
+
 =head1 DESCRIPTION
 
 This is a role which provides the method generators for 
@@ -145,20 +181,13 @@ L<MooseX::AttributeHelpers::Collection::Array>.
 
 =head1 PROVIDED METHODS
 
-=over 4
-
-=item B<count>
+This module also consumes the B<List> method providers, to 
+see those provied methods, refer to that documentation.
 
-=item B<empty>
-
-=item B<find>
+=over 4
 
 =item B<get>
 
-=item B<grep>
-
-=item B<map>
-
 =item B<pop>
 
 =item B<push>
@@ -169,6 +198,22 @@ L<MooseX::AttributeHelpers::Collection::Array>.
 
 =item B<unshift>
 
+=item B<clear>
+
+=item B<delete>
+
+=item B<insert>
+
+=item B<splice>
+
+=item B<sort_in_place>
+
+Sorts the array I<in place>, modifying the value of the attribute.
+
+You can provide an optional subroutine reference to sort with (as you
+can with the core C<sort> function). However, instead of using C<$a>
+and C<$b>, you will need to use C<$_[0]> and C<$_[1]> instead.
+
 =back
 
 =head1 BUGS
@@ -183,7 +228,7 @@ Stevan Little E<lt>stevan@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2007 by Infinity Interactive, Inc.
+Copyright 2007-2008 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>