powerpack 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1c7a89e31c15ac1b39a4806f126dbafd5cfe9991
-  data.tar.gz: f779a0d32f87717f9353a0b3ccd3d48d9177c3b4
+  metadata.gz: 369199242dfe319d0e8afa477689f8d97cb0e647
+  data.tar.gz: 42c792d527998796fdce340364c9664e2b666a54
 SHA512:
-  metadata.gz: 0e7a88b34938e7d2484a81c23c8e2b343c65bdfcf826a08201f9687edfb09b718e466333001ee0c45b1391845422298039c791f722ad5e23c2dd4970c781694c
-  data.tar.gz: c00496df953ae329a3a61a96df857fde953cd490a6ad0ca8057db44be8f919ef63c97640eb7f644e8ef33ff839e1fcdbaa5ecc51f1559e9239b2376f75aca275
+  metadata.gz: 31cc13c64e5aec8afb3e2095d64c6047f484ec2390355c35fb36394c5f6818a61872cb582eba2d208485647a6e7e2137c7e2ea429cb0df953574f5ac14e728b3
+  data.tar.gz: 35eb68213ac9c8354566772c5b75c6bdde2be58155b455cd00209703473065f7f1a71e0a809b031cfe39e45e4df52405181d9cb878cc8af86719fc1a546a0fd3

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## master (unreleased)
+
+## 0.0.8 (13/09/2013)
+
+### New features
+
+* Added `Enumerable#exactly?`
+* Added `Enumerable#average`
+* Added `Numeric#hundred`
+* Added `Numeric#thousand`
+* Added `Numeric#million`
+* Added `Numeric#billion`
+* Added `Numeric#trillion`
+* Added `Numeric#quadrillion`
+
+### Changes
+
+* Renamed `Array#tail` to `Array#butfirst`
+* `Enumerable#take_last_while` returns the result in the same order as `Enumerable#take_last`

data/README.md

@@ -3,7 +3,7 @@
 
 # Powerpack
 
-Powerpack offers some useful extensions to the standard Ruby classes (kind of like `ActiveSupport`, but less ambitious).
+Powerpack offers some useful extensions to the standard Ruby classes (kind of like `ActiveSupport`, but less ambitious and more modular).
 
 ## Installation
 
@@ -22,11 +22,13 @@ Or install it yourself as:
 ## Extensions
 
 * [Array](http://rdoc.info/github/bbatsov/powerpack/Array)
+    * [#butfirst](http://rdoc.info/github/bbatsov/powerpack/Array#butfirst-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)
+    * [#average](http://rdoc.info/github/bbatsov/powerpack/Enumerable#average-instance_method)
     * [#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)
+    * [#exactly?](http://rdoc.info/github/bbatsov/powerpack/Enumerable#exactly?-instance_method)
     * [#frequencies](http://rdoc.info/github/bbatsov/powerpack/Enumerable#frequencies-instance_method)
     * [#several?](http://rdoc.info/github/bbatsov/powerpack/Enumerable#several?-instance_method)
     * [#sum](http://rdoc.info/github/bbatsov/powerpack/Enumerable#sum-instance_method)
@@ -37,6 +39,12 @@ Or install it yourself as:
 * [Numeric](http://rdoc.info/github/bbatsov/powerpack/Numeric)
     * [#pos?](http://rdoc.info/github/bbatsov/powerpack/Numeric#pos?-instance_method)
     * [#neg?](http://rdoc.info/github/bbatsov/powerpack/Numeric#neg?-instance_method)
+    * [#hundred](http://rdoc.info/github/bbatsov/powerpack/Numeric#hundred-instance_method)
+    * [#thousand](http://rdoc.info/github/bbatsov/powerpack/Numeric#thousand-instance_method)
+    * [#million](http://rdoc.info/github/bbatsov/powerpack/Numeric#million-instance_method)
+    * [#billion](http://rdoc.info/github/bbatsov/powerpack/Numeric#billion-instance_method)
+    * [#trillion](http://rdoc.info/github/bbatsov/powerpack/Numeric#trillion-instance_method)
+    * [#quadrillion](http://rdoc.info/github/bbatsov/powerpack/Numeric#quadrillion-instance_method)
 * [String](http://rdoc.info/github/bbatsov/powerpack/String)
     * [#blank?](http://rdoc.info/github/bbatsov/powerpack/String#blank?-instance_method)
     * [#format](http://rdoc.info/github/bbatsov/powerpack/String#format-instance_method)
@@ -70,6 +78,10 @@ To load only a specific extension like `String#format` do:
 require 'powerpack/string/format'
 ```
 
+## Changelog
+
+Powerpack's changelog is available [here](CHANGELOG.md).
+
 ## Contributing
 
 1. Fork it

data/lib/powerpack/array.rb

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

data/lib/powerpack/array/{tail.rb → butfirst.rb}

@@ -1,4 +1,4 @@
-unless Array.method_defined? :tail
+unless Array.method_defined? :butfirst
   class Array
     # Returns a new array rejecting the current one's first element.
     #
@@ -6,9 +6,9 @@ unless Array.method_defined? :tail
     #   array is empty
     #
     # @example
-    #   [1, 2, 3].tail #=> [2, 3]
-    #   [].tail #=> nil
-    def tail
+    #   [1, 2, 3].butfirst #=> [2, 3]
+    #   [].butfirst #=> nil
+    def butfirst
       self[1..-1]
     end
   end

data/lib/powerpack/enumerable.rb

@@ -1,5 +1,7 @@
+require_relative 'enumerable/average'
 require_relative 'enumerable/drop_last'
 require_relative 'enumerable/drop_last_while'
+require_relative 'enumerable/exactly'
 require_relative 'enumerable/frequencies'
 require_relative 'enumerable/several'
 require_relative 'enumerable/sum'

data/lib/powerpack/enumerable/average.rb

@@ -0,0 +1,20 @@
+unless Enumerable.method_defined? :average
+  module Enumerable
+    # Calculates the average of a numeric collection.
+    #
+    # @param default [Object] an optional default return value if there are no elements.
+    #   It's nil by default.
+    # @return The average of the elements or the default value if there are no
+    #   elements.
+    #
+    # @example
+    #   [1, 2, 3].average #=> 2
+    #   [1, 2, 3, 4].average #=> 2.5
+    #   [].average #=> nil
+    #   [].average(0) #=> 0
+    def average(default = nil)
+      coll_size = to_a.size
+      coll_size > 0 ? reduce(&:+) / coll_size.to_f : default
+    end
+  end
+end

data/lib/powerpack/enumerable/exactly.rb

@@ -0,0 +1,41 @@
+unless Enumerable.method_defined? :exactly?
+  module Enumerable
+    # Checks if exactly n elements meet a certain predicate.
+    #
+    # @param n [Fixnum] the number of matches required
+    # @return [Boolean] true if we get exactly n matches, false otherwise
+    #
+    # @example
+    #   [1, 2, 3, 4].exactly?(1) { |n| n > 3 } #=> true
+    #   [1, 2, 3, 4].exactly?(2, &:even?) #=> true
+    #   [1, 1, 3, 3].exactly?(2, &: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].exactly?(3) #=> false
+    #   [1, false, nil].exactly?(1) #=> true
+    #   [false, nil].exactly?(0) #=> true
+    #   [1, 2, 3].exactly?(3) #=>true
+    def exactly?(n)
+      found_count = 0
+
+      if block_given?
+        each do |*o|
+          if yield(*o)
+            found_count += 1
+          end
+        end
+      else
+        each do |o|
+          if o
+            found_count += 1
+          end
+        end
+      end
+
+      n == found_count
+    end
+  end
+end

data/lib/powerpack/enumerable/take_last_while.rb

@@ -5,16 +5,12 @@ unless Enumerable.method_defined? :take_last_while?
     # @return [Array] an array containing the matching elements
     #
     # @example
-    #   [1, 2, 3, 5].take_last_while(&:odd?) #=> [5, 3]
+    #   [1, 2, 3, 5].take_last_while(&:odd?) #=> [3, 5]
     def take_last_while
       return to_enum(:take_last_while) unless block_given?
 
       result = []
-      reverse_each do |elem|
-        return result unless yield(elem)
-        result << elem
-      end
-
+      reverse_each { |elem| yield(elem) ? result.unshift(elem) : break  }
       result
     end
   end

data/lib/powerpack/hash/symbolize_keys.rb

@@ -2,10 +2,11 @@ unless Hash.method_defined? :symbolize_keys
   class Hash
     # Converts the keys of the hash to symbols.
     #
-    # @return [Hash] a copy of the original hash with its keys converted to symbols
+    # @return [Hash] a copy of the original hash with its keys converted to symbols. Leave nonconvertible keys untouched when symbolizing keys.
     #
     # @example
     #   { 'one' => 1, 'two' => 2 }.symbolize_keys #=> { :one => 1, :two => 2 }
+    #   { 1 => "a" }.symbolize_keys #=> { 1 => "a" }
     def symbolize_keys
       Hash[map { |(k, v)| [(k.to_sym rescue k), v] }]
     end

data/lib/powerpack/numeric.rb

@@ -1,2 +1,3 @@
 require_relative 'numeric/neg'
 require_relative 'numeric/pos'
+require_relative 'numeric/scale'

data/lib/powerpack/numeric/scale.rb

@@ -0,0 +1,44 @@
+class Numeric
+  HUNDRED     = 10 ** 2
+  THOUSAND    = 10 ** 3
+  MILLION     = 10 ** 6
+  BILLION     = 10 ** 9
+  TRILLION    = 10 ** 12
+  QUADRILLION = 10 ** 15
+
+  unless Numeric.method_defined? :hundred
+    def hundred
+      self * HUNDRED
+    end
+  end
+
+  unless Numeric.method_defined? :thousand
+    def thousand
+      self * THOUSAND
+    end
+  end
+
+  unless Numeric.method_defined? :million
+    def million
+      self * MILLION
+    end
+  end
+
+  unless Numeric.method_defined? :billion
+    def billion
+      self * BILLION
+    end
+  end
+
+  unless Numeric.method_defined? :trillion
+    def trillion
+      self * TRILLION
+    end
+  end
+
+  unless Numeric.method_defined? :quadrillion
+    def quadrillion
+      self * QUADRILLION
+    end
+  end
+end

data/lib/powerpack/version.rb

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

data/spec/powerpack/array/{tail_spec.rb → butfirst_spec.rb}

@@ -1,11 +1,11 @@
 require 'spec_helper'
 
-describe 'Array#tail' do
+describe 'Array#butfirst' do
   it 'returns an array without the first element' do
-    expect([1, 2, 3].tail).to eq([2, 3])
+    expect([1, 2, 3].butfirst).to eq([2, 3])
   end
 
   it 'returns nil for empty lists' do
-    expect([].tail).to be_nil
+    expect([].butfirst).to be_nil
   end
 end

data/spec/powerpack/enumerable/average_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe 'Enumerable#average' do
+  it 'calculates the average of an enum' do
+    expect((1..3).average).to eq(2)
+  end
+
+  it 'calculates the average of an array' do
+    expect([1, 2, 3, 4].average).to eq(2.5)
+  end
+
+  it 'returns nil when invoked on an empty collection' do
+    expect([].average).to be_nil
+  end
+
+  it 'returns default value when invoked on an empty collection' do
+    expect([].average(0)).to be_zero
+  end
+end

data/spec/powerpack/enumerable/exactly_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe 'Enumerable#exactly' do
+  context 'with block' do
+    it 'returns true for exact number of matches' do
+      expect([1, 2, 3, 4].exactly?(2, &:even?)).to be_true
+    end
+
+    it 'returns false for less matches' do
+      expect([1, 3, 4].exactly?(2, &:even?)).to be_false
+    end
+
+    it 'returns false for more matches' do
+      expect([1, 3, 4, 6, 8].exactly?(2, &:even?)).to be_false
+    end
+  end
+
+  context 'without block' do
+    it 'returns true for exact number of non nil/false elements in absence of nil/false elements' do
+      expect([1, 2, 3, 4].exactly?(4)).to be_true
+    end
+
+    it 'returns true for exact number of non nil/false elements in presence of nil/false elements' do
+      expect([1, 2, nil, false].exactly?(2)).to be_true
+    end
+
+    it 'returns true for exact number of nil/false elements' do
+      expect([nil, false].exactly?(0)).to be_true
+    end
+
+    it 'returns false if there are less non nil/false elements in absence of nil/false elements' do
+      expect([1, 2, 3].exactly?(4)).to be_false
+    end
+
+    it 'returns false if there are less non nil/false elements in presence of nil/false elements' do
+      expect([1, nil, false].exactly?(4)).to be_false
+    end
+  end
+end

data/spec/powerpack/enumerable/take_last_while_spec.rb

@@ -2,6 +2,6 @@ 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])
+    expect([1, 2, 3, 4, 6].take_last_while(&:even?)).to eq([4, 6])
   end
 end

data/spec/powerpack/numeric/scale_spec.rb

@@ -0,0 +1,139 @@
+require 'spec_helper'
+
+describe 'Numeric#hundred' do
+  it 'returns positive integer for positive integer' do
+    expect(1.hundred).to eql 100
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.hundred).to eql 10.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.hundred).to eql -100
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.hundred).to eql -10.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.hundred).to eql 0
+    expect(0.0.hundred).to eql 0.0
+  end
+end
+
+describe 'Numeric#thousand' do
+  it 'returns positive integer for positive integer' do
+    expect(1.thousand).to eql 1000
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.thousand).to eql 100.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.thousand).to eql -1000
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.thousand).to eql -100.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.thousand).to eql 0
+    expect(0.0.thousand).to eql 0.0
+  end
+end
+
+describe 'Numeric#million' do
+  it 'returns positive integer for positive integer' do
+    expect(1.million).to eql 1000000
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.million).to eql 100000.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.million).to eql -1000000
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.million).to eql -100000.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.million).to eql 0
+    expect(0.0.million).to eql 0.0
+  end
+end
+
+describe 'Numeric#billion' do
+  it 'returns positive integer for positive integer' do
+    expect(1.billion).to eql 1000000000
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.billion).to eql 100000000.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.billion).to eql -1000000000
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.billion).to eql -100000000.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.billion).to eql 0
+    expect(0.0.billion).to eql 0.0
+  end
+end
+
+describe 'Numeric#trillion' do
+  it 'returns positive integer for positive integer' do
+    expect(1.trillion).to eql 1000000000000
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.trillion).to eql 100000000000.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.trillion).to eql -1000000000000
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.trillion).to eql -100000000000.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.trillion).to eql 0
+    expect(0.0.trillion).to eql 0.0
+  end
+end
+
+describe 'Numeric#quadrillion' do
+  it 'returns positive integer for positive integer' do
+    expect(1.quadrillion).to eql 1000000000000000
+  end
+
+  it 'returns positive float for positive float' do
+    expect(0.1.quadrillion).to eql 100000000000000.0
+  end
+
+  it 'returns false for negative integer' do
+    expect(-1.quadrillion).to eql -1000000000000000
+  end
+
+  it 'returns false for negative float' do
+    expect(-0.1.quadrillion).to eql -100000000000000.0
+  end
+
+  it 'returns 0 for 0' do
+    expect(0.quadrillion).to eql 0
+    expect(0.0.quadrillion).to eql 0.0
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: powerpack
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Bozhidar Batsov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-03 00:00:00.000000000 Z
+date: 2013-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -76,17 +76,20 @@ files:
 - .gitignore
 - .rspec
 - .travis.yml
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/powerpack.rb
 - lib/powerpack/array.rb
+- lib/powerpack/array/butfirst.rb
 - lib/powerpack/array/butlast.rb
-- lib/powerpack/array/tail.rb
 - lib/powerpack/enumerable.rb
+- lib/powerpack/enumerable/average.rb
 - lib/powerpack/enumerable/drop_last.rb
 - lib/powerpack/enumerable/drop_last_while.rb
+- lib/powerpack/enumerable/exactly.rb
 - lib/powerpack/enumerable/frequencies.rb
 - lib/powerpack/enumerable/several.rb
 - lib/powerpack/enumerable/sum.rb
@@ -97,6 +100,7 @@ files:
 - lib/powerpack/numeric.rb
 - lib/powerpack/numeric/neg.rb
 - lib/powerpack/numeric/pos.rb
+- lib/powerpack/numeric/scale.rb
 - lib/powerpack/string.rb
 - lib/powerpack/string/blank.rb
 - lib/powerpack/string/format.rb
@@ -105,10 +109,12 @@ files:
 - lib/powerpack/string/strip_margin.rb
 - lib/powerpack/version.rb
 - powerpack.gemspec
+- spec/powerpack/array/butfirst_spec.rb
 - spec/powerpack/array/butlast_spec.rb
-- spec/powerpack/array/tail_spec.rb
+- spec/powerpack/enumerable/average_spec.rb
 - spec/powerpack/enumerable/drop_last_spec.rb
 - spec/powerpack/enumerable/drop_last_while_spec.rb
+- spec/powerpack/enumerable/exactly_spec.rb
 - spec/powerpack/enumerable/frequencies_spec.rb
 - spec/powerpack/enumerable/several_spec.rb
 - spec/powerpack/enumerable/sum_spec.rb
@@ -117,6 +123,7 @@ files:
 - spec/powerpack/hash/symbolize_keys_spec.rb
 - spec/powerpack/numeric/neg_spec.rb
 - spec/powerpack/numeric/pos_spec.rb
+- spec/powerpack/numeric/scale_spec.rb
 - spec/powerpack/string/blank_spec.rb
 - spec/powerpack/string/format_spec.rb
 - spec/powerpack/string/squish_spec.rb
@@ -148,10 +155,12 @@ signing_key:
 specification_version: 4
 summary: A few useful extensions to core Ruby classes.
 test_files:
+- spec/powerpack/array/butfirst_spec.rb
 - spec/powerpack/array/butlast_spec.rb
-- spec/powerpack/array/tail_spec.rb
+- spec/powerpack/enumerable/average_spec.rb
 - spec/powerpack/enumerable/drop_last_spec.rb
 - spec/powerpack/enumerable/drop_last_while_spec.rb
+- spec/powerpack/enumerable/exactly_spec.rb
 - spec/powerpack/enumerable/frequencies_spec.rb
 - spec/powerpack/enumerable/several_spec.rb
 - spec/powerpack/enumerable/sum_spec.rb
@@ -160,6 +169,7 @@ test_files:
 - spec/powerpack/hash/symbolize_keys_spec.rb
 - spec/powerpack/numeric/neg_spec.rb
 - spec/powerpack/numeric/pos_spec.rb
+- spec/powerpack/numeric/scale_spec.rb
 - spec/powerpack/string/blank_spec.rb
 - spec/powerpack/string/format_spec.rb
 - spec/powerpack/string/squish_spec.rb