more_core_extensions 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c8d64c7762ab50f5ccf50df6ab0617196c5033ff
-  data.tar.gz: 6eddc491ea72be38afd73e62e1f81440c52622fb
+  metadata.gz: de0bf2437f3829de0a5f82ebd288a6cac59f0a71
+  data.tar.gz: 386ac9e9871d381269e507143b72df08619bfd75
 SHA512:
-  metadata.gz: e31fdff37332985b3849f2047b5826988060bfcf53ee2fd34c934e3b2b0f3174a8a99321719eb2af6376b14dddd730d887352cbe5d20a4dbdbab80784a26c5eb
-  data.tar.gz: 4b54bf02dc41e38429d4b819981444e1a868708214dff14c14b9f0583b0aac533b90b26f6a46b35f92f75a2cd39e1c75ee9ca6d89fe6e57eda6590d740cbd783
+  metadata.gz: a132740693a2bd42601ef83c2cedb3680a742e7ad87a44c0643953d1f0f10a77c51118609532c184e21e5766404acdc90fcb0222e7b2a123d846c5d69dbec777
+  data.tar.gz: e7c599a6db36661dc88a85666aaac6ac6355441c059e9a54e04b6834f68359a4a970a104e9ba7321b037084527c49fa440db207096caccd303199aecdcd49c1f

data/README.md

@@ -1,5 +1,7 @@
 # MoreCoreExtensions
 
+[![Join the chat at https://gitter.im/ManageIQ/more_core_extensions](https://badges.gitter.im/ManageIQ/more_core_extensions.svg)](https://gitter.im/ManageIQ/more_core_extensions?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
 MoreCoreExtensions are a set of core extensions beyond those provided by ActiveSupport.
 
 [![Gem Version](https://badge.fury.io/rb/more_core_extensions.svg)](http://badge.fury.io/rb/more_core_extensions)
@@ -14,8 +16,9 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
   * delete_nils
   * delete_blanks
   * delete_blank_paths
-  * duplicates
   * delete_path
+  * deviation
+  * duplicates
   * include_any?
   * include_none?
   * include_all?
@@ -25,13 +28,16 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
     * include_path?
     * key_path?
     * member_path?
+  * mean
   * random_index
   * random_element
+  * squares
   * store_path
   * stretch
   * stretch!
   * zip_stretched
   * tableize
+  * variance
 * Hash
   * delete_nils
   * delete_blanks
@@ -44,6 +50,10 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
     * key_path?
     * member_path?
   * store_path
+* Numeric
+  * square
+  * round_down
+  * round_up
 * String
   * email?
   * domain_name?

data/lib/more_core_extensions/all.rb

@@ -3,5 +3,6 @@ require 'more_core_extensions/version'
 require 'more_core_extensions/core_ext/array'
 require 'more_core_extensions/core_ext/hash'
 require 'more_core_extensions/core_ext/module'
+require 'more_core_extensions/core_ext/numeric'
 require 'more_core_extensions/core_ext/object'
 require 'more_core_extensions/core_ext/string'

data/lib/more_core_extensions/core_ext/array/deletes.rb

@@ -1,4 +1,4 @@
-require 'more_core_extensions/core_ext/object/blank'
+require 'active_support/core_ext/object/blank'
 
 module MoreCoreExtensions
   module ArrayDeletes

data/lib/more_core_extensions/core_ext/array/math.rb

@@ -0,0 +1,35 @@
+require 'active_support/core_ext/enumerable' # For Array#sum
+
+module MoreCoreExtensions
+  module ArrayMath
+    #
+    # Returns the mean of an Array of Numerics.
+    #
+    #   [1, 2, 3, 4, 5].mean  #=> 3.0
+    #   [1.0, 2.0, 3.0].mean  #=> 2.0
+    def mean
+      sum.to_f / length
+    end
+
+    #
+    # Returns the standard deviation of an Array of Numerics.
+    #
+    #   [1, 2, 3, 4, 5].stddev  #=> 1.5811388300841898
+    #   [1.0, 2.0, 3.0].stddev  #=> 1.0
+    def stddev
+      Math.sqrt(variance)
+    end
+
+    #
+    # Returns the variance of an Array of Numerics.
+    #
+    #   [1, 2, 3, 4, 5].variance  #=> 2.5
+    #   [1.0, 2.0, 3.0].variance  #=> 1.0
+    def variance
+      μ = mean
+      reduce(0) { |m, i| m + (i - μ).square } / (length - 1)
+    end
+  end
+end
+
+Array.send(:include, MoreCoreExtensions::ArrayMath)

data/lib/more_core_extensions/core_ext/array.rb

@@ -2,6 +2,7 @@ require 'more_core_extensions/core_ext/array/deletes'
 require 'more_core_extensions/core_ext/array/duplicates'
 require 'more_core_extensions/core_ext/array/element_counts'
 require 'more_core_extensions/core_ext/array/inclusions'
+require 'more_core_extensions/core_ext/array/math'
 require 'more_core_extensions/core_ext/array/nested'
 require 'more_core_extensions/core_ext/array/random'
 require 'more_core_extensions/core_ext/array/stretch'

data/lib/more_core_extensions/core_ext/hash/deletes.rb

@@ -1,4 +1,4 @@
-require 'more_core_extensions/core_ext/object/blank'
+require 'active_support/core_ext/object/blank'
 
 module MoreCoreExtensions
   module HashDeletes

data/lib/more_core_extensions/core_ext/numeric/math.rb

@@ -0,0 +1,14 @@
+module MoreCoreExtensions
+  module NumericMath
+    #
+    # Returns the square of a Numeric.
+    #
+    #   2.square     #=> 4
+    #   10.0.square  #=> 100.0
+    def square
+      self * self
+    end
+  end
+end
+
+Numeric.send(:prepend, MoreCoreExtensions::NumericMath)

data/lib/more_core_extensions/core_ext/numeric/rounding.rb

@@ -0,0 +1,17 @@
+module MoreCoreExtensions
+  module NumericRounding
+    def round_up(nearest = 1)
+      return self if nearest == 0
+      return self if (self % nearest) == 0
+      self + nearest - (self % nearest)
+    end
+
+    def round_down(nearest = 1)
+      return self if nearest == 0
+      return self if (self % nearest) == 0
+      self - (self % nearest)
+    end
+  end
+end
+
+Numeric.send(:prepend, MoreCoreExtensions::NumericRounding)

data/lib/more_core_extensions/core_ext/numeric.rb

@@ -0,0 +1,2 @@
+require 'more_core_extensions/core_ext/numeric/math'
+require 'more_core_extensions/core_ext/numeric/rounding'

data/lib/more_core_extensions/core_ext/object.rb

@@ -1,2 +1,2 @@
-require 'more_core_extensions/core_ext/object/blank'
+require 'active_support/core_ext/object/blank'
 require 'more_core_extensions/core_ext/object/namespace'

data/lib/more_core_extensions/version.rb

@@ -1,3 +1,3 @@
 module MoreCoreExtensions
-  VERSION = "3.0.0"
+  VERSION = "3.1.0"
 end

data/spec/core_ext/array/math_spec.rb

@@ -0,0 +1,16 @@
+describe Array do
+  let(:floats)   { [1.1, 2.2, 3.3, 4.4, 5.5] }
+  let(:integers) { [1, 2, 3, 4, 5] }
+
+  context "with floats" do
+    it("#stddev")   { expect(floats.stddev).to   be_within(0.00001).of(1.73925) }
+    it("#mean")     { expect(floats.mean).to     be_within(0.00001).of(3.30000) }
+    it("#variance") { expect(floats.variance).to be_within(0.00001).of(3.02500) }
+  end
+
+  context "with integers" do
+    it("#stddev")   { expect(integers.stddev).to   be_within(0.00001).of(1.58113) }
+    it("#mean")     { expect(integers.mean).to     be_within(0.00001).of(3.00000) }
+    it("#variance") { expect(integers.variance).to be_within(0.00001).of(2.50000) }
+  end
+end

data/spec/core_ext/numeric/math_spec.rb

@@ -0,0 +1,6 @@
+describe Numeric do
+  context "#square" do
+    it("Fixnum") { expect(10.square).to   eq(100) }
+    it("Float")  { expect(10.2.square).to eq(104.03999999999999) }
+  end
+end

data/spec/core_ext/numeric/rounding_spec.rb

@@ -0,0 +1,19 @@
+describe Numeric do
+  context "#round_up" do
+    it("Fixnum")  { expect(1.round_up).to   eq(1) }
+    it("Float")   { expect(1.1.round_up).to eq(2.0) }
+    context "with a 'nearest' param" do
+      it("Fixnum")  { expect(1.round_up(10)).to    eq(10) }
+      it("Float")   { expect(1.1.round_up(0.5)).to eq(1.5) }
+    end
+  end
+
+  context "#round_down" do
+    it("Fixnum")  { expect(1.round_down).to   eq(1) }
+    it("Float")   { expect(1.1.round_down).to eq(1.0) }
+    context "with a 'nearest' param" do
+      it("Fixnum")  { expect(11.round_down(10)).to   eq(10) }
+      it("Float")   { expect(1.6.round_down(0.5)).to eq(1.5) }
+    end
+  end
+end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: more_core_extensions
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Jason Frey
+- Brandon Dunne
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-07 00:00:00.000000000 Z
+date: 2016-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -73,7 +74,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -84,6 +85,7 @@ description: MoreCoreExtensions are a set of core extensions beyond those provid
   by ActiveSupport.
 email:
 - fryguy9@gmail.com
+- bdunne@redhat.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -98,6 +100,7 @@ files:
 - lib/more_core_extensions/core_ext/array/duplicates.rb
 - lib/more_core_extensions/core_ext/array/element_counts.rb
 - lib/more_core_extensions/core_ext/array/inclusions.rb
+- lib/more_core_extensions/core_ext/array/math.rb
 - lib/more_core_extensions/core_ext/array/nested.rb
 - lib/more_core_extensions/core_ext/array/random.rb
 - lib/more_core_extensions/core_ext/array/stretch.rb
@@ -107,8 +110,10 @@ files:
 - lib/more_core_extensions/core_ext/hash/nested.rb
 - lib/more_core_extensions/core_ext/module.rb
 - lib/more_core_extensions/core_ext/module/namespace.rb
+- lib/more_core_extensions/core_ext/numeric.rb
+- lib/more_core_extensions/core_ext/numeric/math.rb
+- lib/more_core_extensions/core_ext/numeric/rounding.rb
 - lib/more_core_extensions/core_ext/object.rb
-- lib/more_core_extensions/core_ext/object/blank.rb
 - lib/more_core_extensions/core_ext/object/namespace.rb
 - lib/more_core_extensions/core_ext/shared/nested.rb
 - lib/more_core_extensions/core_ext/string.rb
@@ -119,13 +124,15 @@ files:
 - spec/core_ext/array/duplicates_spec.rb
 - spec/core_ext/array/element_counts_spec.rb
 - spec/core_ext/array/inclusions_spec.rb
+- spec/core_ext/array/math_spec.rb
 - spec/core_ext/array/nested_spec.rb
 - spec/core_ext/array/random_spec.rb
 - spec/core_ext/array/stretch_spec.rb
 - spec/core_ext/array/tableize_spec.rb
 - spec/core_ext/hash/deletes_spec.rb
 - spec/core_ext/hash/nested_spec.rb
-- spec/core_ext/object/blank_spec.rb
+- spec/core_ext/numeric/math_spec.rb
+- spec/core_ext/numeric/rounding_spec.rb
 - spec/core_ext/object/namespace_spec.rb
 - spec/core_ext/string/formats_spec.rb
 - spec/core_ext/string/hex_dump_spec.rb
@@ -150,7 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.3
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: MoreCoreExtensions are a set of core extensions beyond those provided by
@@ -160,13 +167,15 @@ test_files:
 - spec/core_ext/array/duplicates_spec.rb
 - spec/core_ext/array/element_counts_spec.rb
 - spec/core_ext/array/inclusions_spec.rb
+- spec/core_ext/array/math_spec.rb
 - spec/core_ext/array/nested_spec.rb
 - spec/core_ext/array/random_spec.rb
 - spec/core_ext/array/stretch_spec.rb
 - spec/core_ext/array/tableize_spec.rb
 - spec/core_ext/hash/deletes_spec.rb
 - spec/core_ext/hash/nested_spec.rb
-- spec/core_ext/object/blank_spec.rb
+- spec/core_ext/numeric/math_spec.rb
+- spec/core_ext/numeric/rounding_spec.rb
 - spec/core_ext/object/namespace_spec.rb
 - spec/core_ext/string/formats_spec.rb
 - spec/core_ext/string/hex_dump_spec.rb

data/lib/more_core_extensions/core_ext/object/blank.rb

@@ -1,149 +0,0 @@
-# Copied from https://github.com/rails/rails/blob/v5.0.0/activesupport/lib/active_support/core_ext/object/blank.rb
-# With the release of ActiveSupport v5.0.0 a minimum required_ruby_version of '>= 2.2.2' was added.
-# This code has been copied here so that we can continue to support ruby versions that don't meet that requirement.
-
-unless Object.respond_to?(:blank?)
-  class Object
-    # An object is blank if it's false, empty, or a whitespace string.
-    # For example, +false+, '', '   ', +nil+, [], and {} are all blank.
-    #
-    # This simplifies
-    #
-    #   !address || address.empty?
-    #
-    # to
-    #
-    #   address.blank?
-    #
-    # @return [true, false]
-    def blank?
-      respond_to?(:empty?) ? !!empty? : !self
-    end
-
-    # An object is present if it's not blank.
-    #
-    # @return [true, false]
-    def present?
-      !blank?
-    end
-
-    # Returns the receiver if it's present otherwise returns +nil+.
-    # <tt>object.presence</tt> is equivalent to
-    #
-    #    object.present? ? object : nil
-    #
-    # For example, something like
-    #
-    #   state   = params[:state]   if params[:state].present?
-    #   country = params[:country] if params[:country].present?
-    #   region  = state || country || 'US'
-    #
-    # becomes
-    #
-    #   region = params[:state].presence || params[:country].presence || 'US'
-    #
-    # @return [Object]
-    def presence
-      self if present?
-    end
-  end
-
-  class NilClass
-    # +nil+ is blank:
-    #
-    #   nil.blank? # => true
-    #
-    # @return [true]
-    def blank?
-      true
-    end
-  end
-
-  class FalseClass
-    # +false+ is blank:
-    #
-    #   false.blank? # => true
-    #
-    # @return [true]
-    def blank?
-      true
-    end
-  end
-
-  class TrueClass
-    # +true+ is not blank:
-    #
-    #   true.blank? # => false
-    #
-    # @return [false]
-    def blank?
-      false
-    end
-  end
-
-  class Array
-    # An array is blank if it's empty:
-    #
-    #   [].blank?      # => true
-    #   [1,2,3].blank? # => false
-    #
-    # @return [true, false]
-    alias_method :blank?, :empty?
-  end
-
-  class Hash
-    # A hash is blank if it's empty:
-    #
-    #   {}.blank?                # => true
-    #   { key: 'value' }.blank?  # => false
-    #
-    # @return [true, false]
-    alias_method :blank?, :empty?
-  end
-
-  class String
-    BLANK_RE = /\A[[:space:]]*\z/
-
-    # A string is blank if it's empty or contains whitespaces only:
-    #
-    #   ''.blank?       # => true
-    #   '   '.blank?    # => true
-    #   "\t\n\r".blank? # => true
-    #   ' blah '.blank? # => false
-    #
-    # Unicode whitespace is supported:
-    #
-    #   "\u00a0".blank? # => true
-    #
-    # @return [true, false]
-    def blank?
-      # The regexp that matches blank strings is expensive. For the case of empty
-      # strings we can speed up this method (~3.5x) with an empty? call. The
-      # penalty for the rest of strings is marginal.
-      empty? || BLANK_RE === self
-    end
-  end
-
-  class Numeric #:nodoc:
-    # No number is blank:
-    #
-    #   1.blank? # => false
-    #   0.blank? # => false
-    #
-    # @return [false]
-    def blank?
-      false
-    end
-  end
-
-  class Time #:nodoc:
-    # No Time is blank:
-    #
-    #   Time.now.blank? # => false
-    #
-    # @return [false]
-    def blank?
-      false
-    end
-  end
-end

data/spec/core_ext/object/blank_spec.rb

@@ -1,46 +0,0 @@
-describe "blank" do
-  class EmptyTrue
-    def empty?
-      0
-    end
-  end
-
-  class EmptyFalse
-    def empty?
-      nil
-    end
-  end
-
-  BLANK   = [EmptyTrue.new, nil, false, '', '   ', "  \n\t  \r ", '　', "\u00a0", [], {}].freeze
-  PRESENT = [EmptyFalse.new, Object.new, true, 0, 1, 'a', [nil], {nil => 0}].freeze
-
-  describe "#blank?" do
-    context "true" do
-      BLANK.each { |v| it(v.inspect) { expect(v).to be_blank } }
-    end
-
-    context "false" do
-      PRESENT.each { |v| it(v.inspect) { expect(v).to_not be_blank } }
-    end
-  end
-
-  describe "#present?" do
-    context "true" do
-      PRESENT.each { |v| it(v.inspect) { expect(v).to be_present } }
-    end
-
-    context "false" do
-      BLANK.each { |v| it(v.inspect) { expect(v).to_not be_present } }
-    end
-  end
-
-  describe "#presence" do
-    context "object" do
-      PRESENT.each { |v| it(v.inspect) { expect(v.presence).to eq(v) } }
-    end
-
-    context "nil" do
-      BLANK.each { |v| it(v.inspect) { expect(v.presence).to be_nil } }
-    end
-  end
-end