nutella 0.0.1 → 0.1

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--order random

data/README.md

@@ -13,10 +13,21 @@ Install with RubyGems:
 gem install nutella
 ```
 
+## Contributing
+
+This library is my own little collection of core extensions that I like to use,
+and I add things as they are useful to me. I cannot guarantee that you will
+find it useful as I do.
+
+That being said, I welcome any contributions. Feel free to send a pull request
+if you feel that you have a feature that is useful, and definitely let me know
+if you find any bugs.
+
 ## License
 
 ```nutella``` is released under the MIT license.
 
+```
 Copyright (C) 2012 Vinny Diehl
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
@@ -36,6 +47,7 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+```
 
 See [the official page on OSI](http://opensource.org/licenses/MIT) for more
 information.

data/lib/nutella/core_ext/enumerable.rb

@@ -9,6 +9,26 @@ module Enumerable
   end
   alias_method :excludes?, :exclude?
 
+  # Groups an array into smaller arrays of +size+ elements. Remaining elements
+  # at the end will be put into a smaller group if necessary, unless
+  # +discard_excess+ is true, in which case they will be discarded.
+  #
+  #   (1..4).group(2)       # => [[1, 2], [3, 4]]
+  #   (1..8).group(3)       # => [[1, 2, 3], [4, 5, 6], [7, 8]]
+  #   (1..8).group(3, true) # => [[1, 2, 3], [4, 5, 6]]
+  def group(size, discard_excess = false)
+    groups = each_slice(size).to_a
+    discard_excess && groups.last.size < size ? groups[0..-2] : groups
+  end
+
+  # Modifies the collection in place as described for
+  # <tt>Enumerable#group</tt>. Returns the modified collection, or nil if no
+  # modifications were made.
+  def group!(size, discard_excess = false)
+    return nil if empty?
+    self.replace group(size, discard_excess)
+  end
+
   # Returns the sum of all numeric elements in the collection
   #
   #   [1, 2, 3].sum         # => 6

data/lib/nutella/core_ext/string.rb

@@ -6,7 +6,7 @@ class String
 
   # The inverse of <tt>String#include?</tt>. Returns +true+ if the string does
   # not contain +str+.
-  def exclude? str
+  def exclude?(str)
     !include? str
   end
   alias_method :excludes?, :exclude?

data/lib/nutella/version.rb

@@ -1,3 +1,3 @@
 module Nutella
-  VERSION = "0.0.1"
+  VERSION = "0.1"
 end

data/nutella.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = %w[lib]
   gem.test_files = Dir["spec/**/*"]
   gem.files = Dir["lib/**/*"] + gem.test_files + %w[
-    LICENSE Rakefile README.md nutella.gemspec
+    .rspec LICENSE Rakefile README.md nutella.gemspec
   ]
 
   gem.required_ruby_version = ">= 1.9.2"

data/spec/nutella/core_ext/enumerable_spec.rb

@@ -18,6 +18,56 @@ describe Enumerable do
     end
   end
 
+  describe "#group" do
+    it "should group elements" do
+      [].group(2).should == []
+      [1, 2].group(2).should == [[1, 2]]
+      (1..4).group(2).should == [[1, 2], [3, 4]]
+      (1..9).group(3).should == [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
+    end
+
+    it "should put all excess into the last group" do
+      [1, 2].group(4).should == [[1, 2]]
+      (1..8).group(3).should == [[1, 2, 3], [4, 5, 6], [7, 8]]
+    end
+
+    it "should discard all excess if instructed to" do
+      (1..3).group(2, true).should == [[1, 2]]
+      (1..8).group(3, true).should == [[1, 2, 3], [4, 5, 6]]
+    end
+
+    it "should not discard anything if there is no excess" do
+      (1..4).group(2, true).should == [[1, 2], [3, 4]]
+    end
+
+    it "should not modify in place" do
+      arr = (1..10).to_a
+      arr.group 2
+      arr.should == (1..10).to_a
+    end
+  end
+
+  describe "#group!" do
+    arr = []
+
+    before { arr = (1..10).to_a }
+
+    it "should modify in place" do
+      arr.group! 2
+      arr.should == (1..10).group(2)
+    end
+
+    it "should return the modified string" do
+      return_catcher = arr.group! 2
+      return_catcher.should == arr
+    end
+
+    it "should return nil if nothing was modified" do
+      return_catcher = [].group! 2
+      return_catcher.should be_nil
+    end
+  end
+
   describe "#sum" do
     it "should return the sum of elements" do
       [].sum.should == 0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nutella
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: '0.1'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-27 00:00:00.000000000 Z
+date: 2012-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -57,6 +57,7 @@ files:
 - spec/nutella/core_ext/enumerable_spec.rb
 - spec/nutella/core_ext/string_spec.rb
 - spec/spec_helper.rb
+- .rspec
 - LICENSE
 - Rakefile
 - README.md