more_core_extensions 3.8.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 524540f9e367a22c26d7512ba3a1b6fea7853f00cb9c982b847c38647afb50ce
-  data.tar.gz: 8ec0767016594dc332cfb62c47bf1807f1c9a0f709f0663c454bdd47bb4bb9b6
+  metadata.gz: ef4118bf7eac11398770bff4fe85a32527febec7e9d8d45a4c3c91f527e4bac5
+  data.tar.gz: c48abbcc780d5cbe1d6284de32c106795cb0d1a268b8adb3f6212c6e838c1228
 SHA512:
-  metadata.gz: 6fe6963df47f3334862545d9ab33870a0de051cc5766e62041441fe4a2b51f15fc66d243b36e794470c8db00db45a6864dcbbd26a1df233caa90ebe2c1fb7ec3
-  data.tar.gz: fee6fc9df914d2d24f9167503e1ede607f79f7700f444f61803429af7dbc35e0f625f9a69ce5bcc2d65429c9e1d80004b27b41033ddb83bf9156eb86c34c815d
+  metadata.gz: 62c7e0dc1b63655c03c509899d60e9224e310626ceff3be2095ce4008165692877b9099a86f2a0768eae414831b24ac733d160dbb2cb2fb7ded18cdbc56488b2
+  data.tar.gz: f4921953a78e5370e90946da2ec7f6456124f3078688f6d0cc901857d9b5b6b98c5e8c4f34f43b885d8bb79ee62c80a45cacf9baf56a95f384b78070e1699a3f

data/CHANGELOG.md

@@ -4,6 +4,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [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)]

data/README.md

@@ -14,6 +14,8 @@ 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
@@ -35,6 +37,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.
@@ -47,6 +51,7 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 #### 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.
@@ -82,8 +87,6 @@ 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
 

data/lib/more_core_extensions/all.rb

@@ -3,7 +3,6 @@ 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'

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

@@ -1,5 +1,27 @@
 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

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

@@ -3,6 +3,22 @@ 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'

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/version.rb

@@ -1,3 +1,3 @@
 module MoreCoreExtensions
-  VERSION = "3.8.0".freeze
+  VERSION = "4.0.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: more_core_extensions
 version: !ruby/object:Gem::Version
-  version: 3.8.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Jason Frey
@@ -148,8 +148,6 @@ files:
 - 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
@@ -164,7 +162,6 @@ 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/range.rb
 - lib/more_core_extensions/core_ext/range/step_value.rb

data/lib/more_core_extensions/core_ext/enumerable.rb

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

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

@@ -1,15 +0,0 @@
-module MoreCoreExtensions
-  module StableSorting
-    def self.included(klass)
-      klass.class_eval do
-        # <b>DEPRECATED:</b> Please use <tt>tabular_sort</tt> instead.
-        def stable_sort_by(*args)
-          warn "[DEPRECATION] `stable_sort_by` is deprecated.  Please use `Array#tabular_sort` instead."
-          to_a.tabular_sort(*args)
-        end
-      end
-    end
-  end
-end
-
-Enumerable.send(:include, MoreCoreExtensions::StableSorting)

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)