powerpack 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c3390d88d1c5a0cfe6f53e3ae8ad15c4e60646d6
-  data.tar.gz: 80a7c32146541840c31b1a3eee54b1167a07795e
+  metadata.gz: a28a098514fb19fbe308f8fe212c86ba7752cf25
+  data.tar.gz: 50ab2c8032e910bb0ca0f62e4303c5df92075e57
 SHA512:
-  metadata.gz: 29545c9631dd461cf8688c963cc0aebc2f626a05f2f6bc183997a6c1d7d2fa7c8aa80b5cd795cdf64d8ded5b77f2a804927d830622667c4bbf3c0eadc6c918ea
-  data.tar.gz: 567070c2792eaa200c9844e5872a2207e6b86fd49d478c363f0d1e016defc3c6b465c9057611fcabd561c0bf587acfc8e5767c5584c0f8929c82233e871b8fd8
+  metadata.gz: add34af61d1e814599b8d740c0a482da9805b89e022e2ace317803fc46e25829f27b15bcf3f59c715011ecd062f150fbfecc7cb8386858e318fd63e40c18ce05
+  data.tar.gz: 6c3810f948ea1546912b252067b04c11979349f224f41cb9551face339d27a84fbd68bfe2bb2fa85976546d6896606bfcd1b268b001023942216ba8180cfbe84

data/README.md

@@ -24,6 +24,14 @@ Or install it yourself as:
 * [Array](http://rdoc.info/github/bbatsov/powerpack/Array)
     * [#init](http://rdoc.info/github/bbatsov/powerpack/Array#init-instance_method)
     * [#tail](http://rdoc.info/github/bbatsov/powerpack/Array#tail-instance_method)
+* [Enumerable](http://rdoc.info/github/bbatsov/powerpack/Enumerable)
+    * [#drop_last](http://rdoc.info/github/bbatsov/powerpack/Enumerable#drop_last-instance_method)
+    * [#drop_last_while](http://rdoc.info/github/bbatsov/powerpack/Enumerable#drop_last_while-instance_method)
+    * [#several?](http://rdoc.info/github/bbatsov/powerpack/Enumerable#several?-instance_method)
+    * [#sproduct](http://rdoc.info/github/bbatsov/powerpack/Enumerable#sproduct?-instance_method)
+    * [#sum](http://rdoc.info/github/bbatsov/powerpack/Enumerable#sum-instance_method)
+    * [#take_last](http://rdoc.info/github/bbatsov/powerpack/Enumerable#take_last-instance_method)
+    * [#take_last_while](http://rdoc.info/github/bbatsov/powerpack/Enumerable#take_last_while-instance_method)
 * [Hash](http://rdoc.info/github/bbatsov/powerpack/Hash)
     * [#symbolize_keys](http://rdoc.info/github/bbatsov/powerpack/Hash#symbolize_keys-instance_method)
 * [Numeric](http://rdoc.info/github/bbatsov/powerpack/Numeric)

data/lib/powerpack.rb

@@ -1,5 +1,7 @@
 require 'powerpack/version'
 
+require 'powerpack/enumerable'
+
 require 'powerpack/hash'
 
 require 'powerpack/numeric'

data/lib/powerpack/enumerable.rb

@@ -0,0 +1,7 @@
+require_relative 'enumerable/drop_last'
+require_relative 'enumerable/drop_last_while'
+require_relative 'enumerable/several'
+require_relative 'enumerable/sproduct'
+require_relative 'enumerable/sum'
+require_relative 'enumerable/take_last'
+require_relative 'enumerable/take_last_while'

data/lib/powerpack/enumerable/drop_last.rb

@@ -0,0 +1,19 @@
+unless Enumerable.method_defined? :drop_last
+  module Enumerable
+    # Drops the last n elements of an enumerable.
+    #
+    # @return [Array] an array containing the remaining elements
+    #
+    # @example
+    #   [1, 2, 3].drop_last(1) #=> [1, 2]
+    #   [].drop_last(5) #=> []
+    def drop_last(n)
+      fail ArgumentError, 'attempt to drop negative size' if n < 0
+
+      ary = to_a
+
+      return [] if n > ary.size
+      ary[0...(ary.size - n)]
+    end
+  end
+end

data/lib/powerpack/enumerable/drop_last_while.rb

@@ -0,0 +1,21 @@
+unless Enumerable.method_defined? :drop_last_while
+  module Enumerable
+    # Drops the last elements of an enumerable meeting a predicate.
+    #
+    # @return [Array] an array containing the remaining elements
+    #
+    # @example
+    #   [1, 2, 3].drop_last_while(&:odd?) #=> [1, 2]
+    def drop_last_while
+      return to_enum(:drop_last_while) unless block_given?
+
+      ary = []
+      dropping = true
+      reverse_each do |obj|
+        ary << obj unless dropping &&= yield(obj)
+      end
+
+      ary.reverse!
+    end
+  end
+end

data/lib/powerpack/enumerable/several.rb

@@ -0,0 +1,37 @@
+unless Enumerable.method_defined? :several?
+  module Enumerable
+    # Checks if two or more elements meet a certain predicate.
+    #
+    # @example
+    #   [1, 2, 3, 4].several?(&:even?) #=> true
+    #   [1, 1, 3, 3].several?(&:even?) #=> false
+    #
+    # Without a block uses the identify of the elements as default predicate.
+    # This means that nil and false elements will be ignored.
+    #
+    # @example
+    #   [1, false, nil].several? #=> false
+    #   [1, 2, 3].several? #=>true
+    def several?
+      found_count = 0
+
+      if block_given?
+        each do |*o|
+          if yield(*o)
+            found_count += 1
+            return true if found_count > 1
+          end
+        end
+      else
+        each do |o|
+          if o
+            found_count += 1
+            return true if found_count > 1
+          end
+        end
+      end
+
+      false
+    end
+  end
+end

data/lib/powerpack/enumerable/sproduct.rb

@@ -0,0 +1,15 @@
+unless Enumerable.method_defined? :sproduct
+  module Enumerable
+    # Multiplies the elements of an enum by invoking their * method.
+    # Most useful for multiplying numbers. sproduct stands for standard product,
+    # since Ruby defines Array#product as a Carthesian product.
+    #
+    # @example
+    #   [1, 2, 3, 4].sproduct #=> 6
+    #   [].sproduct #=> nil
+    #   [].sproduct(1) #=> 1
+    def sproduct(default = nil)
+      reduce(&:*) || default
+    end
+  end
+end

data/lib/powerpack/enumerable/sum.rb

@@ -0,0 +1,16 @@
+unless Enumerable.method_defined? :sum
+  module Enumerable
+    # Sums up elements of an enum by invoking their + method.
+    # Most useful for summing up numbers.
+    #
+    # @example
+    #   [1, 2, 3].sum #=> 6
+    #   ["a", "b", "c"].sum #=> "abc"
+    #   [[1], [2], [3]].sum #=> [1, 2, 3]
+    #   [].sum #=> nil
+    #   [].sum(0) #=> 0
+    def sum(default = nil)
+      reduce(&:+) || default
+    end
+  end
+end

data/lib/powerpack/enumerable/take_last.rb

@@ -0,0 +1,19 @@
+unless Enumerable.method_defined? :take_last
+  module Enumerable
+    # Take the last n elements of an enumerable.
+    #
+    # @return [Array] an array containing the requested elements
+    #
+    # @example
+    #   [1, 2, 3].take_last(2) #=> [2, 3]
+    #   [].take_last(5) #=> []
+    def take_last(n)
+      fail ArgumentError, 'attempt to take negative size' if n < 0
+
+      ary = to_a
+
+      return ary if n > ary.size
+      ary[(ary.size - n)..-1]
+    end
+  end
+end

data/lib/powerpack/enumerable/take_last_while.rb

@@ -0,0 +1,21 @@
+unless Enumerable.method_defined? :take_last_while?
+  module Enumerable
+    # Take the last n elements of an enumerable meeting a certain predicate.
+    #
+    # @return [Array] an array containing the matching elements
+    #
+    # @example
+    #   [1, 2, 3, 5].take_last_while(&:odd?) #=> [5, 3]
+    def take_last_while
+      return to_enum(:take_last_while) unless block_given?
+
+      array = []
+      reverse_each do |elem|
+        return array unless yield(elem)
+        array << elem
+      end
+
+      array
+    end
+  end
+end

data/lib/powerpack/version.rb

@@ -1,3 +1,3 @@
 module Powerpack
-  VERSION = '0.0.5'
+  VERSION = '0.0.6'
 end

data/spec/powerpack/enumerable/drop_last_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe 'Enumerable#drop_last' do
+  it 'drops the last n elements' do
+    expect([1, 2, 3, 4].drop_last(2)).to eq([1, 2])
+  end
+
+  it 'returns an empty array if you request to drop too many elems' do
+    expect((1..10).drop_last(100)).to eq([])
+  end
+
+  it 'does not accept negative argument' do
+    expect { [1, 2, 3, 4].drop_last(-1) }.to raise_error(ArgumentError)
+  end
+end

data/spec/powerpack/enumerable/drop_last_while_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe 'Enumerable#drop_last_while' do
+  it 'drops the last elements while a pred is true' do
+    expect([1, 2, 3, 4, 6].drop_last_while(&:even?)).to eq([1, 2, 3])
+  end
+end

data/spec/powerpack/enumerable/several_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe 'Enumerable#several' do
+  context 'with block' do
+    it 'returns true if more than 1 element matches the predicate' do
+      expect([1, 2, 3, 4].several?(&:even?)).to be_true
+    end
+
+    it 'returns false if just 1 element matches the predicate' do
+      expect([1, 3, 4].several?(&:even?)).to be_false
+    end
+
+    it 'returns false if no elements match the predicate' do
+      expect([1, 3, 4].several?(&:even?)).to be_false
+    end
+  end
+
+  context 'without block' do
+    it 'returns true if there are 2 or more non nil/false elements' do
+      expect([1, 2, 3, 4].several?).to be_true
+    end
+
+    it 'returns false if there are less than 2 non nil/false elements' do
+      expect([1, nil, false].several?).to be_false
+    end
+  end
+end

data/spec/powerpack/enumerable/sproduct_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe 'Enumerable#sproduct' do
+  it 'multiply the numbers of an enum' do
+    expect((1..4).sproduct).to eq(24)
+  end
+
+  it 'returns nil when invoked on an empty collection' do
+    expect([].sproduct).to be_nil
+  end
+
+  it 'returns default value when invoked on an empty collection' do
+    expect([].sproduct(0)).to be_zero
+  end
+end

data/spec/powerpack/enumerable/sum_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe 'Enumerable#sum' do
+  it 'sums up the numbers of an enum' do
+    expect((1..3).sum).to eq(6)
+  end
+
+  it 'returns nil when invoked on an empty collection' do
+    expect([].sum).to be_nil
+  end
+
+  it 'returns default value when invoked on an empty collection' do
+    expect([].sum(0)).to be_zero
+  end
+end

data/spec/powerpack/enumerable/take_last_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe 'Enumerable#take_last' do
+  it 'takes the last n elements' do
+    expect([1, 2, 3, 4].take_last(2)).to eq([3, 4])
+  end
+
+  it 'returns everything if you request to drop too many elems' do
+    expect((1..10).take_last(100)).to eq((1..10).to_a)
+  end
+
+  it 'does not accept negative argument' do
+    expect { [1, 2, 3, 4].take_last(-1) }.to raise_error(ArgumentError)
+  end
+end

data/spec/powerpack/enumerable/take_last_while_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe 'Enumerable#take_last_while' do
+  it 'takes the last elements while a pred is true' do
+    expect([1, 2, 3, 4, 6].take_last_while(&:even?)).to eq([6, 4])
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: powerpack
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Bozhidar Batsov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-24 00:00:00.000000000 Z
+date: 2013-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -84,6 +84,14 @@ files:
 - lib/powerpack/array.rb
 - lib/powerpack/array/init.rb
 - lib/powerpack/array/tail.rb
+- lib/powerpack/enumerable.rb
+- lib/powerpack/enumerable/drop_last.rb
+- lib/powerpack/enumerable/drop_last_while.rb
+- lib/powerpack/enumerable/several.rb
+- lib/powerpack/enumerable/sproduct.rb
+- lib/powerpack/enumerable/sum.rb
+- lib/powerpack/enumerable/take_last.rb
+- lib/powerpack/enumerable/take_last_while.rb
 - lib/powerpack/hash.rb
 - lib/powerpack/hash/symbolize_keys.rb
 - lib/powerpack/numeric.rb
@@ -99,6 +107,13 @@ files:
 - powerpack.gemspec
 - spec/powerpack/array/init_spec.rb
 - spec/powerpack/array/tail_spec.rb
+- spec/powerpack/enumerable/drop_last_spec.rb
+- spec/powerpack/enumerable/drop_last_while_spec.rb
+- spec/powerpack/enumerable/several_spec.rb
+- spec/powerpack/enumerable/sproduct_spec.rb
+- spec/powerpack/enumerable/sum_spec.rb
+- spec/powerpack/enumerable/take_last_spec.rb
+- spec/powerpack/enumerable/take_last_while_spec.rb
 - spec/powerpack/hash/symbolize_keys_spec.rb
 - spec/powerpack/numeric/neg_spec.rb
 - spec/powerpack/numeric/pos_spec.rb
@@ -135,6 +150,13 @@ summary: A few useful extensions to core Ruby classes.
 test_files:
 - spec/powerpack/array/init_spec.rb
 - spec/powerpack/array/tail_spec.rb
+- spec/powerpack/enumerable/drop_last_spec.rb
+- spec/powerpack/enumerable/drop_last_while_spec.rb
+- spec/powerpack/enumerable/several_spec.rb
+- spec/powerpack/enumerable/sproduct_spec.rb
+- spec/powerpack/enumerable/sum_spec.rb
+- spec/powerpack/enumerable/take_last_spec.rb
+- spec/powerpack/enumerable/take_last_while_spec.rb
 - spec/powerpack/hash/symbolize_keys_spec.rb
 - spec/powerpack/numeric/neg_spec.rb
 - spec/powerpack/numeric/pos_spec.rb