more_core_extensions 3.6.0 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 605b41f75443bf69e235fccd80b9b94c48cbf44f95e5205ea540d5b36a84a75d
-  data.tar.gz: 8cd816257ef3a0e564960273a65415173c207a962fe0aa8e681b4b83565edc12
+  metadata.gz: d8d52470776addb4edcca50184d26029d46a6a513cbc51125d539816974c2758
+  data.tar.gz: a0bbdb4f9f454eef6881cc85babc15523dcab44c1d5516f67aeae0037b69491b
 SHA512:
-  metadata.gz: a6300d6be1bc10872dbc485160f1c51a2b388fa687e160944712d27d2ef12f41a98e122697855ff8fca3ea87a9f2f2b3d4cfacc9e83286d0f3559cf4375a56a9
-  data.tar.gz: 76554a13bfcce20c1a7b361185f7215c552e7306b747168b8d3a21ae19d0908b6d02d30c91f127f1823f3bee5d5a5143721972e3d3252ece8f6ccd5e5ebe284e
+  metadata.gz: f1bc6f58dffd72b60a0746ad568bf9b7a4dbc0c7e0b742f9546ea10b75a54f9a098938726cde53fcfcec1a810b173d20d164ee15c0d570cac2033a785c702ca1
+  data.tar.gz: b301d6ed331a268b9ecf6d5e7b8ea0afdfb4b2a6333dc1eb8886e5a496be807bdc43a9c9335e6f514ac32ba3717bc8e8068cc4cf4feecd007ed8a77f21d27677

data/.travis.yml

@@ -1,15 +1,15 @@
 language: ruby
 rvm:
-  - "2.0"
   - "2.1"
   - "2.2"
-  - "2.3.3"
-  - "2.4.0"
+  - "2.3"
+  - "2.4"
+  - "2.5.8"
+  - "2.6.6"
+  - "2.7.1"
   - 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:

data/CHANGELOG.md

@@ -4,6 +4,42 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [4.2.0] - 2020-07-20
+### Added
+- Add bundler-inject allowing developers to override dependencies [[#89](https://github.com/ManageIQ/more_core_extensions/pull/89)]
+- Add Array and Hash #deep_clone and #deep_delete [[#91](https://github.com/ManageIQ/more_core_extensions/pull/91)]
+- Add Digest::UUID.clean to properly format UUID strings [[#81](https://github.com/ManageIQ/more_core_extensions/pull/81)]
+
+###Changed
+- Update ArrayTableize to properly set field width for color text [[#87](https://github.com/ManageIQ/more_core_extensions/pull/87)]
+- Change Array#format_table header output to markdown vs postgres [[#83](https://github.com/ManageIQ/more_core_extensions/pull/83)]
+
+## [4.1.0] - 2020-04-30
+### Added
+- Added Ruby 2.7 support [[#79](https://github.com/ManageIQ/more_core_extensions/pull/79)]
+- Added Process#pause, Process#resume, and Process#alive? [[#73](https://github.com/ManageIQ/more_core_extensions/pull/73)]
+
+## [4.0.0] - 2020-01-31
+### Changed
+- **BREAKING**: Moved Object#descendant_get to Class#descendant_get [[#75](https://github.com/ManageIQ/more_core_extensions/pull/75)]
+- **BREAKING**: Removed deprecated Enumerable#stable_sort_by [[#76](https://github.com/ManageIQ/more_core_extensions/pull/76)]
+
+## [3.8.0] - 2020-01-31
+### Changed
+- Renamed Enumerable#stable_sort_by to Array#tabular_sort [[#68](https://github.com/ManageIQ/more_core_extensions/pull/68)]
+- Deprecated Enumerable#stable_sort_by [[#74](https://github.com/ManageIQ/more_core_extensions/pull/74)]
+
+### Added
+- Added Class#leaf_subclasses [[#71](https://github.com/ManageIQ/more_core_extensions/pull/71)]
+- Added Array#compact_map [[#63](https://github.com/ManageIQ/more_core_extensions/pull/63)]
+
+## [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 +97,12 @@ 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/v4.2.0...HEAD
+[4.2.0]: https://github.com/ManageIQ/more_core_extensions/compare/v4.1.0...v4.2.0
+[4.1.0]: https://github.com/ManageIQ/more_core_extensions/compare/v4.0.0...v4.1.0
+[4.0.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.8.0...v4.0.0
+[3.8.0]: https://github.com/ManageIQ/more_core_extensions/compare/v3.7.0...v3.8.0
+[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/Gemfile

@@ -1,8 +1,16 @@
 source 'https://rubygems.org'
 
+plugin 'bundler-inject'
+require File.join(Bundler::Plugin.index.load_paths("bundler-inject")[0], "bundler-inject") rescue nil
+
 # Specify your gem's dependencies in more_core_extensions.gemspec
 gemspec
 
-# HACK: Rails 5 dropped support for Ruby < 2.2.2
-active_support_version = "< 5" if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.2.2")
+# Rails 5 dropped support for Ruby < 2.2.2
+# Rails 6 dropped support for Ruby < 2.4.4
+if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.2.2")
+  active_support_version = "< 5"
+elsif Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.4.4")
+  active_support_version = "< 6"
+end
 gem 'activesupport', active_support_version

data/README.md

@@ -14,9 +14,12 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 
 #### Array
 
+* core_ext/array/compact_map.rb
+  * `#compact_map` - Collect non-nil results from the block
 * core_ext/array/deletes.rb
   * `#delete_blanks` - Deletes all items where the value is blank
   * `#delete_nils` - Deletes all items where the value is nil
+  * `#deep_delete` - Deletes nested hash key elements
 * core_ext/array/duplicates.rb
   * `#duplicates` - Returns an Array of the duplicates found
 * core_ext/array/element_counts.rb
@@ -35,6 +38,8 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 * core_ext/array/random.rb
   * `#random_index` - Picks a valid index randomly
   * `#random_element` - Picks an element randomly
+* core_ext/array/sorting.rb
+  * `#tabular_sort` - Sorts an Array of Hashes by specific columns
 * core_ext/array/stretch.rb
   * `.stretch` - Stretch all argument Arrays to make them the same size
   * `.stretch!` - Stretch all argument Arrays to make them the same size. Modifies the arguments in place.
@@ -44,11 +49,20 @@ 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
+  * `#descendant_get` - Returns the descendant with a given name
+  * `#hierarchy` - Returns a tree-like Hash structure of all descendants.
+  * `#lineage` - Returns an Array of all superclasses.
+  * `#leaf_subclasses` - Returns an Array of all descendants which have no subclasses.
+
 #### Hash
 
 * core_ext/hash/deletes.rb
   * `#delete_blanks` - Deletes all keys where the value is blank
   * `#delete_nils` - Deletes all keys where the value is nil
+  * `#deep_delete` - Deletes nested hash key elements
 * core_ext/hash/nested.rb (see [Shared](#shared))
   * `#delete_blank_paths` - Deletes all paths where the value is blank
 * core_ext/hash/sorting.rb (see [Shared](#shared))
@@ -75,11 +89,16 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 
 #### Object
 
-* core_ext/module/descendants.rb
-  * `#descendant_get` - Returns the descendant with a given name
 * core_ext/module/namespace.rb
   * `#in_namespace?` - Returns whether or not the object is in the given namespace
 
+#### Process
+
+* core_ext/process/pause_resume.rb
+  * `.pause` - Pauses a process
+  * `.resume` - Resumes a paused process
+  * `.alive?` - Returns whether or not a process is running
+
 #### Range
 
 * core_ext/range/step_value.rb
@@ -112,6 +131,7 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 #### Shared
 
 * core_ext/shared/nested.rb
+  * `#deep_clone` - Performs a Marshal based deep clone
   * `#delete_path` - Delete the value at the specified nesting
   * `#fetch_path` - Fetch the value at the specified nesting
   * `#find_path` - Detect which nesting holds the specified value

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,10 +1,15 @@
 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/digest'
 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'
+require 'more_core_extensions/core_ext/process'
 require 'more_core_extensions/core_ext/range'
 require 'more_core_extensions/core_ext/string'
 require 'more_core_extensions/core_ext/symbol'

data/lib/more_core_extensions/core_ext/array.rb

@@ -1,3 +1,4 @@
+require 'more_core_extensions/core_ext/array/compact_map'
 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'
@@ -5,5 +6,6 @@ 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/sorting'
 require 'more_core_extensions/core_ext/array/stretch'
 require 'more_core_extensions/core_ext/array/tableize'

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

@@ -0,0 +1,19 @@
+module MoreCoreExtensions
+  module ArrayCompactMap
+    # Collect non-nil results from the block.  Basically [].collect { |i| ... }.compact
+    #
+    #   [1,2,3,4,5].compact_map { |i| i * 2 if i.odd?} # => [2,6,10]
+    def compact_map
+      return enum_for(:compact_map) unless block_given?
+
+      [].tap do |results|
+        each do |i|
+          result = yield(i)
+          results << result if result
+        end
+      end
+    end
+  end
+end
+
+Array.send(:include, MoreCoreExtensions::ArrayCompactMap)

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

@@ -15,6 +15,15 @@ module MoreCoreExtensions
     def delete_blanks
       delete_if { |i| i.blank? }
     end
+
+    # Deletes all keys and subkeys that match +key+.
+    #
+    #   [{:a => {:b => 2, :c => 3}}].deep_delete(:b) # => [{:a => {:c => 3}}]
+    #
+    def deep_delete(key)
+      each { |i| i.deep_delete(key) if i.respond_to?(:deep_delete) }
+      self
+    end
   end
 end
 

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

@@ -0,0 +1,57 @@
+module MoreCoreExtensions
+  module StableSorting
+    # Sorts an Array of Hashes by specific columns.
+    #
+    # Rows are sorted by +col_names+, if given, otherwise by the given block.
+    #   The +order+ parameter can be given :ascending or :descending and
+    #   defaults to :ascending.
+    #
+    # Note:
+    # - Strings are sorted case-insensitively
+    # - nil values are sorted last
+    # - Boolean values are sorted alphabetically (i.e. false then true)
+    #
+    #   [
+    #     {:col1 => 'b', :col2 => 2},
+    #     {:col1 => 'b', :col2 => 1},
+    #     {:col1 => 'A', :col2 => 1}
+    #   ].tabular_sort([:col1, :col2])
+    #
+    #   # => [
+    #   #   {:col1 => 'A', :col2 => 1},
+    #   #   {:col1 => 'b', :col2 => 1},
+    #   #   {:col1 => 'b', :col2 => 2}
+    #   # ]
+    def tabular_sort(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
+
+Array.send(:include, MoreCoreExtensions::StableSorting)

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

@@ -53,6 +53,9 @@ module MoreCoreExtensions
 
       private
 
+      ANSI_ESCAPE_SEQUENCE = /\e\[[^m]+m/.freeze
+      ANSI_RESET = "\e[0m".freeze
+
       def tableize_hashes
         # Convert the target to an Array of Arrays
         keys = options[:columns] || columns_from_hash_keys
@@ -102,7 +105,7 @@ module MoreCoreExtensions
       end
 
       def apply_width!(widths, field, field_i)
-        widths[field_i] = [widths[field_i].to_i, field.to_s.length].max
+        widths[field_i] = [widths[field_i].to_i, ansi_strip(field.to_s).length].max
         widths[field_i] = [options[:max_width], widths[field_i].to_i].min if options[:max_width]
       end
 
@@ -118,13 +121,44 @@ module MoreCoreExtensions
       end
 
       def format_field(field, width, justification)
-        field = field.to_s.gsub(/\n|\r/, '').slice(0, width)
+        field = field.to_s.gsub(/\n|\r/, '')
+        field = ansi_truncate(field, width)
         "%0#{justification}#{width}s" % field
       end
 
+      def ansi_escapes?(field)
+        !!field.match(ANSI_ESCAPE_SEQUENCE)
+      end
+
+      def ansi_escapes(field)
+        field.to_enum(:scan, ANSI_ESCAPE_SEQUENCE).map { Regexp.last_match }
+      end
+
+      def ansi_strip(field)
+        field.gsub(ANSI_ESCAPE_SEQUENCE, '')
+      end
+
+      def ansi_truncate(field, width)
+        escapes = ansi_escapes(field)
+        if escapes.none?
+          field.slice(0, width)
+        else
+          escape_widths = 0
+          escapes.each do |e|
+            break if e.offset(0).first - escape_widths >= width
+
+            escape_widths += e[0].size
+          end
+
+          field = field.slice(0, width + escape_widths)
+          field << ANSI_RESET if ansi_escapes?(field) && !field.end_with?(ANSI_RESET)
+          field
+        end
+      end
+
       def format_table(table, widths)
         if options[:header] && table.size > 1
-          header_separator = widths.collect { |w| "-" * (w + 2) }.join("+")
+          header_separator = widths.collect { |w| "-" * (w + 2) }.join("|")
           table.insert(1, header_separator)
         end
         table.join("\n") << "\n"

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,55 @@
+require 'active_support/core_ext/class/subclasses'
+require 'active_support/core_ext/object/try'
+
+module MoreCoreExtensions
+  module ClassHierarchy
+    # Returns the descendant with a given name
+    #
+    #   require 'socket'
+    #   IO.descendant_get("IO")
+    #   # => IO
+    #   IO.descendant_get("BasicSocket")
+    #   # => BasicSocket
+    #   IO.descendant_get("IPSocket")
+    #   # => IPSocket
+    def descendant_get(desc_name)
+      return self if desc_name == name || desc_name.nil?
+      klass = descendants.find { |desc| desc.name == desc_name }
+      raise ArgumentError, "#{desc_name} is not a descendant of #{name}" unless klass
+      klass
+    end
+
+    # 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
+
+    # Returns an Array of all descendants which have no subclasses
+    #
+    #   require 'socket'
+    #   BasicSocket.leaf_subclasses
+    #   # => [Socket, TCPServer, UDPSocket, UNIXServer]
+    def leaf_subclasses
+      descendants.select { |d| d.subclasses.empty? }
+    end
+  end
+end
+
+Class.send(:include, MoreCoreExtensions::ClassHierarchy)

data/lib/more_core_extensions/core_ext/digest.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/digest/uuid'

data/lib/more_core_extensions/core_ext/digest/uuid.rb

@@ -0,0 +1,26 @@
+require 'active_support/core_ext/digest/uuid'
+
+module Digest
+  module UUID
+    UUID_REGEX_FORMAT = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.freeze
+
+    # Takes a UUID string of varying formats and cleans it. It will strip invalid characters,
+    # such as leading and trailing brackets as well as whitespace. The result is a lowercased,
+    # canonical UUID string.
+    #
+    # If the +guid+ argument is nil or blank, then nil is returned. If the +guid+ is already
+    # clean, then no additional cleaning occurs, and it is returned as-is.
+    #
+    # @param guid [String] A string that should more or less represent a UUID.
+    # @return [String] A lowercase v4 UUID string stripped of any extraneous characters.
+    #
+    def self.clean(guid)
+      return nil if guid.nil?
+      g = guid.to_s.downcase
+      return nil if g.strip.empty?
+      return g if g.length == 36 && g =~ UUID_REGEX_FORMAT
+      g.delete!('^0-9a-f')
+      g.sub!(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, '\1-\2-\3-\4-\5')
+    end
+  end
+end

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

@@ -15,6 +15,16 @@ module MoreCoreExtensions
     def delete_blanks
       delete_if { |k, v| v.blank? }
     end
+
+    # Deletes all keys and subkeys that match +key+.
+    #
+    #   {:a => {:b => 2, :c => 3}}.deep_delete(:b) # => {:a => {:c => 3}}
+    #
+    def deep_delete(key)
+      key = [key] unless key.kind_of?(Array)
+      key.each { |k| delete(k) }
+      each_value { |v| v.deep_delete(key) if v.respond_to?(:deep_delete) }
+    end
   end
 end
 

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/core_ext/object.rb

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

data/lib/more_core_extensions/core_ext/process.rb

@@ -0,0 +1 @@
+require 'more_core_extensions/core_ext/process/pause_resume'

data/lib/more_core_extensions/core_ext/process/pause_resume.rb

@@ -0,0 +1,110 @@
+module MoreCoreExtensions
+  module ProcessPauseResume
+    if Gem.win_platform?
+      require 'fiddle'
+      ntdll = Fiddle.dlopen('ntdll')
+      kernel32 = Fiddle.dlopen('kernel32')
+
+      NtSuspendProcess = Fiddle::Function.new(
+        ntdll['NtSuspendProcess'],
+        [Fiddle::TYPE_UINTPTR_T],
+        Fiddle::TYPE_INT
+      )
+
+      private_constant :NtSuspendProcess
+
+      NtResumeProcess = Fiddle::Function.new(
+        ntdll['NtResumeProcess'],
+        [Fiddle::TYPE_UINTPTR_T],
+        Fiddle::TYPE_INT
+      )
+
+      private_constant :NtResumeProcess
+
+      OpenProcess = Fiddle::Function.new(
+        kernel32['OpenProcess'],
+        [Fiddle::TYPE_LONG, Fiddle::TYPE_INT, Fiddle::TYPE_LONG],
+        Fiddle::TYPE_UINTPTR_T
+      )
+
+      private_constant :OpenProcess
+
+      CloseHandle = Fiddle::Function.new(
+        kernel32['CloseHandle'],
+        [Fiddle::TYPE_UINTPTR_T],
+        Fiddle::TYPE_INT
+      )
+
+      private_constant :CloseHandle
+
+      PROCESS_SUSPEND_RESUME = 0x00000800
+
+      private_constant :PROCESS_SUSPEND_RESUME
+    end
+
+    # Returns whether or not the given process is running.
+    #
+    def alive?(pid)
+      Process.kill(0, pid)
+      true
+    rescue Errno::ESRCH
+      false
+    end
+
+    # Suspend the process +pid+. If the process isn't running then this is no-op.
+    #
+    if Gem.win_platform?
+      def pause(pid)
+        return unless alive?(pid)
+
+        begin
+          handle = OpenProcess.call(PROCESS_SUSPEND_RESUME, 0, pid)
+
+          if handle == 0
+            raise SystemCallError, Fiddle.win32_last_error, "OpenProcess"
+          end
+
+          if NtSuspendProcess.call(handle) != 0
+            raise SystemCallError, Fiddle.win32_last_error, "NtSuspendProcess"
+          end
+        ensure
+          CloseHandle.call(handle) if handle
+        end
+        1 # For cross-platform compatibility
+      end
+    else
+      def pause(pid)
+        Process.kill('STOP', pid) if alive?(pid)
+      end
+    end
+
+    # Resume the process +pid+. If the process isn't running then this is a no-op.
+    #
+    if Gem.win_platform?
+      def resume(pid)
+        return unless alive?(pid)
+
+        begin
+          handle = OpenProcess.call(PROCESS_SUSPEND_RESUME, 0, pid)
+
+          if handle == 0
+            raise SystemCallError, Fiddle.win32_last_error, "OpenProcess"
+          end
+
+          if NtResumeProcess.call(handle) != 0
+            raise SystemCallError, Fiddle.win32_last_error, "NtResumeProcess"
+          end
+        ensure
+          CloseHandle.call(handle) if handle
+        end
+        1 # For cross-platform compatibility
+      end
+    else
+      def resume(pid)
+        Process.kill('CONT', pid) if alive?(pid)
+      end
+    end
+  end
+end
+
+Process.send(:extend, MoreCoreExtensions::ProcessPauseResume)

data/lib/more_core_extensions/core_ext/shared/nested.rb

@@ -100,6 +100,21 @@ module MoreCoreExtensions
         end
         []
       end
+
+      # Create a deep clone of the object. This is similar to deep_dup
+      # but uses a Marshal based approach instead.
+      #
+      #   h1 = {:a => "hello"}
+      #   h2 = h1.deep_clone
+      #
+      #   h1[:a] << " world"
+      #
+      #   h1[:a] # "hello world"
+      #   h2[:a] # "hello"
+      #
+      def deep_clone
+        Marshal.load(Marshal.dump(self))
+      end
     end
   end
 end

data/lib/more_core_extensions/version.rb

@@ -1,3 +1,3 @@
 module MoreCoreExtensions
-  VERSION = "3.6.0".freeze
+  VERSION = "4.2.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"
@@ -30,4 +30,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "timecop"
 
   spec.add_runtime_dependency "activesupport"
+  spec.add_runtime_dependency "sync"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: more_core_extensions
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 4.2.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: 2020-07-20 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
@@ -109,6 +109,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: sync
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: MoreCoreExtensions are a set of core extensions beyond those provided
   by ActiveSupport.
 email:
@@ -133,6 +147,7 @@ files:
 - lib/more_core_extensions.rb
 - lib/more_core_extensions/all.rb
 - lib/more_core_extensions/core_ext/array.rb
+- lib/more_core_extensions/core_ext/array/compact_map.rb
 - lib/more_core_extensions/core_ext/array/deletes.rb
 - lib/more_core_extensions/core_ext/array/duplicates.rb
 - lib/more_core_extensions/core_ext/array/element_counts.rb
@@ -140,12 +155,21 @@ files:
 - 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/sorting.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/digest.rb
+- lib/more_core_extensions/core_ext/digest/uuid.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
@@ -154,8 +178,9 @@ files:
 - 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/descendants.rb
 - lib/more_core_extensions/core_ext/object/namespace.rb
+- lib/more_core_extensions/core_ext/process.rb
+- lib/more_core_extensions/core_ext/process/pause_resume.rb
 - lib/more_core_extensions/core_ext/range.rb
 - lib/more_core_extensions/core_ext/range/step_value.rb
 - lib/more_core_extensions/core_ext/shared/nested.rb
@@ -187,8 +212,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: MoreCoreExtensions are a set of core extensions beyond those provided by

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

@@ -1,17 +0,0 @@
-require 'active_support/core_ext/class/subclasses'
-
-module MoreCoreExtensions
-  module Descendants
-    #
-    # Retrieve a descendant by its name
-    #
-    def descendant_get(desc_name)
-      return self if desc_name == name || desc_name.nil?
-      klass = descendants.find { |desc| desc.name == desc_name }
-      raise ArgumentError, "#{desc_name} is not a descendant of #{name}" unless klass
-      klass
-    end
-  end
-end
-
-Object.send(:include, MoreCoreExtensions::Descendants)