more_core_extensions 3.6.0 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 605b41f75443bf69e235fccd80b9b94c48cbf44f95e5205ea540d5b36a84a75d
-  data.tar.gz: 8cd816257ef3a0e564960273a65415173c207a962fe0aa8e681b4b83565edc12
+SHA1:
+  metadata.gz: 45280e85179a5cec518a1a078c3ef57502042771
+  data.tar.gz: a38d6af1cc7f313f4f0254fd466ba3c8309d42cd
 SHA512:
-  metadata.gz: a6300d6be1bc10872dbc485160f1c51a2b388fa687e160944712d27d2ef12f41a98e122697855ff8fca3ea87a9f2f2b3d4cfacc9e83286d0f3559cf4375a56a9
-  data.tar.gz: 76554a13bfcce20c1a7b361185f7215c552e7306b747168b8d3a21ae19d0908b6d02d30c91f127f1823f3bee5d5a5143721972e3d3252ece8f6ccd5e5ebe284e
+  metadata.gz: ca86d8e6a9a9ff26fbc1a6a5ad96d2b7ef05dc637f9474f0f160bee51b38e97d625cbc6ff85c7765886f38947b924f528c54ea7c99fa3e2fe1a4fcadac2e706b
+  data.tar.gz: 68af4c4bb3230ece550bc6908016bd4faf5f2f495f4c9e9871704203aeac84fa83b576fa6654d20444f3197b5ce4b57c9bb988f87a6cdbe466ce073e4ddca8ca

data/.travis.yml

@@ -1,18 +1,20 @@
 language: ruby
 rvm:
   - "2.0"
-  - "2.1"
-  - "2.2"
-  - "2.3.3"
-  - "2.4.0"
+  - "2.1.10"
+  - "2.2.10"
+  - "2.3.8"
+  - "2.4.5"
+  - "2.5.3"
+  - "2.6.0"
   - ruby-head
   - jruby-head
 sudo: false
 cache: bundler
-before_install: gem install bundler -v ">= 1.13.6"
 after_script: bundle exec codeclimate-test-reporter
 matrix:
   allow_failures:
+    - rvm: "2.6.0"
     - rvm: ruby-head
     - rvm: jruby-head
   fast_finish: true

data/CHANGELOG.md

@@ -4,6 +4,13 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [3.7.0] - 2019-02-04
+### Added
+- Added Enumerable#stable_sort_by [[#67](https://github.com/ManageIQ/more_core_extensions/pull/67)]
+- Added Math#slope_y_intercept, #slope_x_intercept, #linear_regression [[#50](https://github.com/ManageIQ/more_core_extensions/pull/50)]
+- Added Benchmark#realtime_store, #realtime_block and helper methods [[#65](https://github.com/ManageIQ/more_core_extensions/pull/65)]
+- Added Class#hierarchy and #lineage [[#61](https://github.com/ManageIQ/more_core_extensions/pull/61)]
+
 ## [3.6.0] - 2018-03-01
 ### Added
 - Added String#decimal_si_to_big_decimal [[#59](https://github.com/ManageIQ/more_core_extensions/pull/59)]
@@ -61,7 +68,8 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Upgraded to RSpec 3 [[#16](https://github.com/ManageIQ/more_core_extensions/pull/16)]
 - Added the Change Log!
 
-[Unreleased]: https://github.com/ManageIQ/more_core_extensions/compare/v3.6.0...HEAD
+[Unreleased]: https://github.com/ManageIQ/more_core_extensions/compare/v3.7.0...HEAD
+[3.7.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.6.0...v3.7.0
 [3.6.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.5.0...v3.6.0
 [3.5.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.4.0...v3.5.0
 [3.4.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.3.0...v3.4.0

data/README.md

@@ -44,6 +44,12 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 * core_ext/array/tableize.rb
   * `#tableize` - Create a string representation of receiver in a tabular format if receiver is an Array of Arrays or an Array of Hashes
 
+#### Class
+
+* core_ext/class/hierarchy.rb
+  * `#hierarchy` - Returns a tree-like Hash structure of all descendants.
+  * `#lineage` - Returns an Array of all superclasses.
+
 #### Hash
 
 * core_ext/hash/deletes.rb

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
 require "bundler/setup"
-require "more_core_extensions"
+require "more_core_extensions/all"
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.

data/lib/more_core_extensions/all.rb

@@ -1,7 +1,11 @@
 require 'more_core_extensions/version'
 
 require 'more_core_extensions/core_ext/array'
+require 'more_core_extensions/core_ext/benchmark'
+require 'more_core_extensions/core_ext/class'
+require 'more_core_extensions/core_ext/enumerable'
 require 'more_core_extensions/core_ext/hash'
+require 'more_core_extensions/core_ext/math'
 require 'more_core_extensions/core_ext/module'
 require 'more_core_extensions/core_ext/numeric'
 require 'more_core_extensions/core_ext/object'

data/lib/more_core_extensions/core_ext/benchmark.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/benchmark/realtime_store'

data/lib/more_core_extensions/core_ext/benchmark/realtime_store.rb

@@ -0,0 +1,107 @@
+require 'benchmark'
+
+module MoreCoreExtensions
+  module BenchmarkRealtimeStore
+    # Stores the elapsed real time used to execute the given block in the given
+    # hash for the given key and returns the result from the block.  If the hash
+    # already has a value for that key, the time is accumulated.
+    #
+    #   timings = {}
+    #
+    #   Benchmark.realtime_store(timings, :sleep) { sleep 2; "foo" } # => "foo"
+    #   timings # => {:sleep => 2.00}
+    #
+    #   Benchmark.realtime_store(timings, :sleep) { sleep 2; "bar" } # => "bar"
+    #   timings # => {:sleep => 4.00}
+    def realtime_store(hash, key)
+      ret = nil
+      r0 = Time.now
+      begin
+        ret = yield
+      ensure
+        r1 = Time.now
+        hash[key] = (hash[key] || 0) + (r1.to_f - r0.to_f)
+      end
+      ret
+    end
+
+    # Stores the elapsed real time used to execute the given block for the given
+    # key and returns the hash as well as the result from the block.  The hash is
+    # stored globally, keyed on thread id, and is cleared once the topmost nested
+    # call completes.  If the hash already has a value for that key, the time is
+    # accumulated.
+    #
+    #   Benchmark.realtime_block(:sleep) do
+    #     sleep 2
+    #     "foo"
+    #   end # => ["foo", {:sleep => 2.00}]
+    #
+    #   Benchmark.realtime_block(:outer_sleep) do
+    #     sleep 2
+    #     Benchmark.realtime_block(:inner_sleep) { sleep 2 }
+    #     "bar"
+    #   end # => ["bar", {:inner_sleep => 2.00, :outer_sleep => 4.00}]
+    #
+    #   Benchmark.realtime_block(:outer_sleep) do
+    #     sleep 2
+    #     2.times do
+    #       Benchmark.realtime_block(:inner_sleep) { sleep 2 }
+    #     end
+    #     "baz"
+    #   end # => ["baz", {:inner_sleep => 4.00, :outer_sleep => 6.00}]
+    def realtime_block(key, &block)
+      hash = current_realtime
+
+      if in_realtime_block?
+        ret = realtime_store(hash, key, &block)
+        return ret, hash
+      else
+        begin
+          self.current_realtime = hash
+          begin
+            ret = realtime_store(hash, key, &block)
+            return ret, hash
+          rescue Exception => err # rubocop:disable Lint/RescueException
+            err.define_singleton_method(:timings) { hash } unless err.respond_to?(:timings)
+            raise
+          ensure
+            delete_current_realtime
+          end
+        ensure
+          # A second layer of protection in case Timeout::Error struck right after
+          # setting self.current_realtime, or right before `delete_current_realtime`.
+          # In those cases, current_realtime might (wrongly) still exist.
+          delete_current_realtime if in_realtime_block?
+        end
+      end
+    end
+
+    def in_realtime_block?
+      @@realtime_by_tid.key?(thread_unique_identifier)
+    end
+
+    def current_realtime
+      @@realtime_by_tid[thread_unique_identifier] || Hash.new(0)
+    end
+
+    def current_realtime=(hash)
+      @@realtime_by_tid[thread_unique_identifier] = hash
+    end
+
+    def delete_current_realtime
+      @@realtime_by_tid.delete(thread_unique_identifier)
+    end
+
+    private
+
+    def thread_unique_identifier
+      # Forks inherit the @@realtime_by_tid and parent/child Thread.current.object_id
+      # are equal, so we need to index into the hash with the pid too.
+      "#{Process.pid}-#{Thread.current.object_id}"
+    end
+
+    @@realtime_by_tid = {}
+  end
+end
+
+Benchmark.send(:extend, MoreCoreExtensions::BenchmarkRealtimeStore)

data/lib/more_core_extensions/core_ext/class.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/class/hierarchy'

data/lib/more_core_extensions/core_ext/class/hierarchy.rb

@@ -0,0 +1,30 @@
+require 'active_support/core_ext/class/subclasses'
+require 'active_support/core_ext/object/try'
+
+module MoreCoreExtensions
+  module ClassHierarchy
+    # Returns a tree-like Hash structure of all descendants.
+    #
+    #   require 'socket'
+    #   IO.hierarchy
+    #   # => {BasicSocket=>
+    #   #      {Socket=>{},
+    #   #       IPSocket=>{TCPSocket=>{TCPServer=>{}}, UDPSocket=>{}},
+    #   #       UNIXSocket=>{UNIXServer=>{}}},
+    #   #     File=>{}}
+    def hierarchy
+      subclasses.each_with_object({}) { |k, h| h[k] = k.hierarchy }
+    end
+
+    # Returns an Array of all superclasses.
+    #
+    #   require 'socket'
+    #   TCPServer.lineage
+    #   # => [TCPSocket, IPSocket, BasicSocket, IO, Object, BasicObject]
+    def lineage
+      superclass.nil? ? [] : superclass.lineage.unshift(superclass)
+    end
+  end
+end
+
+Class.send(:include, MoreCoreExtensions::ClassHierarchy)

data/lib/more_core_extensions/core_ext/enumerable.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/enumerable/sorting'

data/lib/more_core_extensions/core_ext/enumerable/sorting.rb

@@ -0,0 +1,39 @@
+module MoreCoreExtensions
+  module StableSorting
+    def self.included(klass)
+      klass.class_eval do
+        def stable_sort_by(col_names = nil, order = nil, &block)
+          # stabilizer is needed because of
+          # http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/170565
+          stabilizer = 0
+          nil_rows, sortable =
+              partition do |r|
+                Array(col_names).any? { |c| r[c].nil? }
+              end
+
+          data_array =
+              if col_names
+                sortable.sort_by do |r|
+                  stabilizer += 1
+                  [Array(col_names).map do |col|
+                    val = r[col]
+                    val = val.downcase if val.kind_of?(String)
+                    val = val.to_s     if val.kind_of?(FalseClass) || val.kind_of?(TrueClass)
+                    val
+                  end, stabilizer]
+                end
+              else
+                sortable.sort_by(&block)
+              end.to_a
+
+          data_array += nil_rows
+
+          data_array.reverse! if order == :descending
+          data_array
+        end
+      end
+    end
+  end
+end
+
+Enumerable.send(:include, MoreCoreExtensions::StableSorting)

data/lib/more_core_extensions/core_ext/math.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/math/slope'

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

@@ -0,0 +1,54 @@
+require 'more_core_extensions/core_ext/numeric/math'
+
+module MoreCoreExtensions
+  module MathSlope
+    module ClassMethods
+      # Finds the y coordinate given x, slope of the line and the y intercept
+      #
+      # `y = mx + b`
+      # Where `m` is the slope of the line and `b` is the y intercept
+      #
+      #    Math.slope_y_intercept(1, 0.5, 1) # => 1.5
+      def slope_y_intercept(x, slope, y_intercept)
+        slope * x + y_intercept
+      end
+
+      # Finds the x coordinate given y, slope of the line and the y intercept
+      #
+      # `x = (y - b) / m`
+      # Where `m` is the slope of the line and `b` is the y intercept
+      #
+      #    Math.slope_x_intercept(1.5, 0.5, 1) # => 1.0
+      def slope_x_intercept(y, slope, y_intercept)
+        (y - y_intercept) / slope.to_f
+      end
+
+      # Finds the linear regression of the given coordinates.  Coordinates should be given as x, y pairs.
+      #
+      # Returns the slope of the line, the y intercept, and the R-squared value.
+      #
+      #    Math.linear_regression([1.0, 1.0], [2.0, 2.0]) # => [1.0, 0.0, 1.0]
+      def linear_regression(*coordinates)
+        return if coordinates.empty?
+
+        x_array, y_array = coordinates.transpose
+        sum_x  = x_array.sum
+        sum_x2 = x_array.map(&:square).sum
+        sum_y  = y_array.sum
+        sum_y2 = y_array.map(&:square).sum
+        sum_xy = coordinates.map { |x, y| x * y }.sum
+
+        n = coordinates.size.to_f
+        slope = (n * sum_xy - sum_x * sum_y) / (n * sum_x2 - sum_x.square)
+        return if slope.nan?
+
+        y_intercept = (sum_y - slope * sum_x) / n
+        r_squared   = (n * sum_xy - sum_x * sum_y) / Math.sqrt((n * sum_x2 - sum_x.square) * (n * sum_y2 - sum_y.square)) rescue nil
+
+        return slope, y_intercept, r_squared
+      end
+    end
+  end
+end
+
+Math.send(:extend, MoreCoreExtensions::MathSlope::ClassMethods)

data/lib/more_core_extensions/version.rb

@@ -1,3 +1,3 @@
 module MoreCoreExtensions
-  VERSION = "3.6.0".freeze
+  VERSION = "3.7.0".freeze
 end

data/more_core_extensions.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 2.0.0"
 
-  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "bundler"
   spec.add_development_dependency "codeclimate-test-reporter"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec", ">= 3.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: more_core_extensions
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.7.0
 platform: ruby
 authors:
 - Jason Frey
@@ -9,22 +9,22 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-03-01 00:00:00.000000000 Z
+date: 2019-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: codeclimate-test-reporter
   requirement: !ruby/object:Gem::Requirement
@@ -142,10 +142,18 @@ files:
 - lib/more_core_extensions/core_ext/array/random.rb
 - lib/more_core_extensions/core_ext/array/stretch.rb
 - lib/more_core_extensions/core_ext/array/tableize.rb
+- lib/more_core_extensions/core_ext/benchmark.rb
+- lib/more_core_extensions/core_ext/benchmark/realtime_store.rb
+- lib/more_core_extensions/core_ext/class.rb
+- lib/more_core_extensions/core_ext/class/hierarchy.rb
+- lib/more_core_extensions/core_ext/enumerable.rb
+- lib/more_core_extensions/core_ext/enumerable/sorting.rb
 - lib/more_core_extensions/core_ext/hash.rb
 - lib/more_core_extensions/core_ext/hash/deletes.rb
 - lib/more_core_extensions/core_ext/hash/nested.rb
 - lib/more_core_extensions/core_ext/hash/sorting.rb
+- lib/more_core_extensions/core_ext/math.rb
+- lib/more_core_extensions/core_ext/math/slope.rb
 - lib/more_core_extensions/core_ext/module.rb
 - lib/more_core_extensions/core_ext/module/cache_with_timeout.rb
 - lib/more_core_extensions/core_ext/module/namespace.rb
@@ -188,7 +196,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.6.14.3
 signing_key: 
 specification_version: 4
 summary: MoreCoreExtensions are a set of core extensions beyond those provided by