powerpack 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a28a098514fb19fbe308f8fe212c86ba7752cf25
-  data.tar.gz: 50ab2c8032e910bb0ca0f62e4303c5df92075e57
+  metadata.gz: 1c7a89e31c15ac1b39a4806f126dbafd5cfe9991
+  data.tar.gz: f779a0d32f87717f9353a0b3ccd3d48d9177c3b4
 SHA512:
-  metadata.gz: add34af61d1e814599b8d740c0a482da9805b89e022e2ace317803fc46e25829f27b15bcf3f59c715011ecd062f150fbfecc7cb8386858e318fd63e40c18ce05
-  data.tar.gz: 6c3810f948ea1546912b252067b04c11979349f224f41cb9551face339d27a84fbd68bfe2bb2fa85976546d6896606bfcd1b268b001023942216ba8180cfbe84
+  metadata.gz: 0e7a88b34938e7d2484a81c23c8e2b343c65bdfcf826a08201f9687edfb09b718e466333001ee0c45b1391845422298039c791f722ad5e23c2dd4970c781694c
+  data.tar.gz: c00496df953ae329a3a61a96df857fde953cd490a6ad0ca8057db44be8f919ef63c97640eb7f644e8ef33ff839e1fcdbaa5ecc51f1559e9239b2376f75aca275

data/README.md

@@ -22,13 +22,13 @@ Or install it yourself as:
 ## Extensions
 
 * [Array](http://rdoc.info/github/bbatsov/powerpack/Array)
-    * [#init](http://rdoc.info/github/bbatsov/powerpack/Array#init-instance_method)
+    * [#butlast](http://rdoc.info/github/bbatsov/powerpack/Array#butlast-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)
+    * [#frequencies](http://rdoc.info/github/bbatsov/powerpack/Enumerable#frequencies-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)

data/lib/powerpack/array.rb

@@ -1,2 +1,2 @@
-require_relative 'array/init'
+require_relative 'array/butlast'
 require_relative 'array/tail'

data/lib/powerpack/array/butlast.rb

@@ -0,0 +1,15 @@
+unless Array.method_defined? :butlast
+  class Array
+    # Returns a new array that has all the elements of the current but the last.
+    #
+    # @return [Array] a new array without the last element or an empty array if this
+    #   array is empty
+    #
+    # @example
+    #   [1, 2, 3].butlast #=> [1, 2]
+    #   [].butlast #=> []
+    def butlast
+      self[0...-1]
+    end
+  end
+end

data/lib/powerpack/enumerable.rb

@@ -1,7 +1,7 @@
 require_relative 'enumerable/drop_last'
 require_relative 'enumerable/drop_last_while'
+require_relative 'enumerable/frequencies'
 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

@@ -2,6 +2,7 @@ unless Enumerable.method_defined? :drop_last
   module Enumerable
     # Drops the last n elements of an enumerable.
     #
+    # @param n [Fixnum] the number of elements to drop
     # @return [Array] an array containing the remaining elements
     #
     # @example

data/lib/powerpack/enumerable/drop_last_while.rb

@@ -9,13 +9,13 @@ unless Enumerable.method_defined? :drop_last_while
     def drop_last_while
       return to_enum(:drop_last_while) unless block_given?
 
-      ary = []
+      result = []
       dropping = true
       reverse_each do |obj|
-        ary << obj unless dropping &&= yield(obj)
+        result.unshift(obj) unless dropping &&= yield(obj)
       end
 
-      ary.reverse!
+      result
     end
   end
 end

data/lib/powerpack/enumerable/frequencies.rb

@@ -0,0 +1,17 @@
+unless Enumerable.method_defined? :frequencies
+  module Enumerable
+    # Counts the number of ocurrence of items in the enumberable.
+    #
+    # @return [Hash] in the format value => count
+    #
+    # @example
+    #   [].frequencies # => {}
+    #   [1, :symbol, 'string', 3, :symbol, 1].frequencies
+    #     #=> { 1 => 2, :symbol => 2, 'string' => 1, 3 => 1 }
+    #
+    #
+    def frequencies
+      each_with_object(Hash.new(0)) { |e, a| a[e] += 1 }
+    end
+  end
+end

data/lib/powerpack/enumerable/sum.rb

@@ -1,8 +1,13 @@
 unless Enumerable.method_defined? :sum
   module Enumerable
-    # Sums up elements of an enum by invoking their + method.
+    # Sums up elements of a collection by invoking their `+` method.
     # Most useful for summing up numbers.
     #
+    # @param default [Object] an optional default return value if there are no elements.
+    #   It's nil by default.
+    # @return The sum of the elements or the default value if there are no
+    #   elements.
+    #
     # @example
     #   [1, 2, 3].sum #=> 6
     #   ["a", "b", "c"].sum #=> "abc"

data/lib/powerpack/enumerable/take_last.rb

@@ -2,6 +2,7 @@ unless Enumerable.method_defined? :take_last
   module Enumerable
     # Take the last n elements of an enumerable.
     #
+    # @param n [Fixnum] the number of elements to take
     # @return [Array] an array containing the requested elements
     #
     # @example

data/lib/powerpack/enumerable/take_last_while.rb

@@ -9,13 +9,13 @@ unless Enumerable.method_defined? :take_last_while?
     def take_last_while
       return to_enum(:take_last_while) unless block_given?
 
-      array = []
+      result = []
       reverse_each do |elem|
-        return array unless yield(elem)
-        array << elem
+        return result unless yield(elem)
+        result << elem
       end
 
-      array
+      result
     end
   end
 end

data/lib/powerpack/version.rb

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

data/spec/powerpack/array/{init_spec.rb → butlast_spec.rb}

@@ -1,11 +1,11 @@
 require 'spec_helper'
 
-describe 'Array#init' do
+describe 'Array#butlast' do
   it 'returns an array without the last element' do
-    expect([1, 2, 3].init).to eq([1, 2])
+    expect([1, 2, 3].butlast).to eq([1, 2])
   end
 
   it 'returns [] for empty lists' do
-    expect([].init).to be_empty
+    expect([].butlast).to be_empty
   end
 end

data/spec/powerpack/enumerable/frequencies_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe 'Enumerable#frequencies' do
+  context 'empty collection' do
+    it 'evaluates to an empty hash' do
+      expect([].frequencies).to eql({})
+    end
+  end
+
+  context 'populated collection' do
+    it 'counts the number of ocurrences and returns a hash in the form value => count' do
+      expect([1, 1, :symbol, 3, 1, :symbol, 'string'].frequencies).to eql(
+        1        => 3,
+        3        => 1,
+        'string' => 1,
+        :symbol  => 2
+      )
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: powerpack
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Bozhidar Batsov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-26 00:00:00.000000000 Z
+date: 2013-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -82,13 +82,13 @@ files:
 - Rakefile
 - lib/powerpack.rb
 - lib/powerpack/array.rb
-- lib/powerpack/array/init.rb
+- lib/powerpack/array/butlast.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/frequencies.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
@@ -105,12 +105,12 @@ files:
 - lib/powerpack/string/strip_margin.rb
 - lib/powerpack/version.rb
 - powerpack.gemspec
-- spec/powerpack/array/init_spec.rb
+- spec/powerpack/array/butlast_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/frequencies_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
@@ -148,12 +148,12 @@ signing_key:
 specification_version: 4
 summary: A few useful extensions to core Ruby classes.
 test_files:
-- spec/powerpack/array/init_spec.rb
+- spec/powerpack/array/butlast_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/frequencies_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

data/lib/powerpack/array/init.rb

@@ -1,15 +0,0 @@
-unless Array.method_defined? :init
-  class Array
-    # Returns a new array that has all the elements of the current but the last.
-    #
-    # @return [Array] a new array without the last element or empty array if this
-    #   array is empty
-    #
-    # @example
-    #   [1, 2, 3].init #=> [1, 2]
-    #   [].init #=> []
-    def init
-      self[0...-1]
-    end
-  end
-end

data/lib/powerpack/enumerable/sproduct.rb

@@ -1,15 +0,0 @@
-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/spec/powerpack/enumerable/sproduct_spec.rb

@@ -1,15 +0,0 @@
-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