visionmedia-rext 0.0.7 → 0.0.8

data/History.rdoc

@@ -1,4 +1,9 @@
 
+=== 0.0.8 / 2009-04-13
+
+* Added Array#chunk/in_groups_of
+* Added Array#pad
+
 === 0.0.7 / 2009-04-08
 
 * Added Hash#switchify

data/lib/rext/array/helpers.rb

@@ -1,4 +1,6 @@
 
+require 'enumerator'
+
 class Array
   
   ##
@@ -15,4 +17,48 @@ class Array
     self[0..position]
   end
   
+  ##
+  # Pad array with expected length +n+, and +pad_with+ an
+  # optional object or nil.
+  #
+  # === Examples
+  #
+  #   [1,2].pad(4)  # => [1,2,nil,nil]
+  #   [1,2].pad(4)  # => [1,2,'x','x']
+  #   [1,2].pad(2)  # => [1,2]
+  #
+  
+  def pad n, pad_with = nil
+    fill pad_with, length, n - length
+  end
+  
+  ##
+  # Split an array into chunks of length +n+. Optionally you
+  # may +pad_with+ an object to retain a uniform length per chunk.
+  #
+  # === Examples
+  #
+  #   [1,2,3].chunk(2)         # => [[1,2], [3, nil]]
+  #   [1,2,3].chunk(2, 'x')    # => [[1,2], [3, 'x']]
+  #   [1,2,3].chunk(2, false)  # => [[1,2], [3]]
+  #   [1,2,3].in_groups_of(2) do |chunk|
+  #     # Do something
+  #   end
+  #
+  # === See
+  #
+  # * Array#pad
+  #
+  
+  def chunk n, pad_with = nil, &block
+    chunks = []
+    each_slice n do |chunk|
+      chunk.pad n, pad_with unless pad_with == false
+      yield chunk if block
+      chunks << chunk
+    end
+    chunks
+  end
+  alias :in_groups_of :chunk
+  
 end

data/lib/rext/version.rb

@@ -1,4 +1,4 @@
 
 module Rext
-  VERSION = '0.0.7'
+  VERSION = '0.0.8'
 end

data/rext.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rext}
-  s.version = "0.0.7"
+  s.version = "0.0.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["TJ Holowaychuk"]
-  s.date = %q{2009-04-08}
+  s.date = %q{2009-04-13}
   s.description = %q{Ruby extensions}
   s.email = %q{tj@vision-media.ca}
   s.extra_rdoc_files = ["lib/rext/all.rb", "lib/rext/array/helpers.rb", "lib/rext/array.rb", "lib/rext/compat/basic_object.rb", "lib/rext/compat.rb", "lib/rext/date/helpers.rb", "lib/rext/date.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/hash/helpers.rb", "lib/rext/hash.rb", "lib/rext/integer/helpers.rb", "lib/rext/integer.rb", "lib/rext/module/helpers.rb", "lib/rext/module.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/numeric.rb", "lib/rext/object/helpers.rb", "lib/rext/object/metaclass.rb", "lib/rext/object.rb", "lib/rext/proc/helpers.rb", "lib/rext/proc.rb", "lib/rext/string/escape.rb", "lib/rext/string/helpers.rb", "lib/rext/string.rb", "lib/rext/time/helpers.rb", "lib/rext/time.rb", "lib/rext/version.rb", "lib/rext.rb", "README.rdoc", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]

data/spec/array_spec.rb

@@ -20,5 +20,41 @@ describe Array do
       end
     end
     
+    describe "#chunk" do
+      it "should split an array into several containing the length of n" do
+        (1..9).to_a.chunk(3).should == [[1,2,3], [4,5,6], [7,8,9]]
+      end
+      
+      it "should accept a block, yielding each chunk" do
+        chunks = []
+        (1..9).to_a.in_groups_of(3) do |chunk|
+          chunks << chunk
+        end
+        chunks.should == [[1,2,3], [4,5,6], [7,8,9]]
+      end
+      
+      it "should pad with nil by default" do
+        (1..5).to_a.in_groups_of(4).should == [[1,2,3,4], [5,nil,nil,nil]]
+      end
+      
+      it "should not padd when pad_with is false" do
+        (1..6).to_a.in_groups_of(4, false).should == [[1,2,3,4], [5,6]]
+      end
+    end
+    
+    describe "#pad" do
+      it "should pad with nil by default" do
+        [1,2].pad(4).should == [1, 2, nil, nil]
+      end
+      
+      it "should pad an with an object" do
+        [1,2].pad(3 ,'x').should == [1, 2, 'x']
+      end
+      
+      it "should do nothing when the array is of expected length" do
+        [1,2].pad(2).should == [1,2]
+      end
+    end
+    
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: visionmedia-rext
 version: !ruby/object:Gem::Version 
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors: 
 - TJ Holowaychuk
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-08 00:00:00 -07:00
+date: 2009-04-13 00:00:00 -07:00
 default_executable: 
 dependencies: []