refinements 8.1.1 → 8.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c04df598103624b71b08d5b175c319d21c9fa5ff773976c5956f6e1aa0acdb70
-  data.tar.gz: d6b9d57e2a23a74d1bed6e98146590e1bdc4f4a843ea9ed72747b6ccd3d847bc
+  metadata.gz: 5706b329caaea4cbf42c9dd34d8da325d5e4b5628385a760de2ca4b4c5efaf06
+  data.tar.gz: c20a4aad691df3a683d3ea29d58ae0dbcef4475d297460a945874c2298972864
 SHA512:
-  metadata.gz: 996ac02a62679e6cd2bd083863ee587d9915a65bee40883bb21875a196d79126eacae345458f4e5f784203e9d26af17a8735c46a6c3e2eacf77adecacea07d08
-  data.tar.gz: 5a4d11cb1010fbe61137b5e0382568bec9bdb4812d169f68d749e2e9809a033109102631a1568030eef53b6372e5bda4a23d93b3ceb7cef0f164f6b5e9b6a91d
+  metadata.gz: d14f810b454fe4e3116dc35b04a3701485b9ddad99889db58da96cec8e8556271ec53292447861748909add9d293a21a7c3c7a49fc16720fd61f7654dc2251a4
+  data.tar.gz: 61defc07d39c9de58db72ae0f937319694d156c6a0ed2896f6c2a9b645bfbb5fd829e01e96c242764cb4115dc030dbb5ffcb8010446cec34316b7666b62f8061

data/README.adoc

@@ -135,6 +135,23 @@ Removes given array or elements without mutating itself.
 [1, 2, 3, 4, 5].excluding 4, 5    # => [1, 2, 3]
 ----
 
+===== #filter_find
+
+Answers the first truthy and filtered result from a collection.
+
+[source,ruby]
+----
+handlers = [
+  ->(object) { object if object == :b },
+  proc { false },
+  ->(object) { object if object == :a }
+]
+
+handlers.filter_find                                # => Enumerator::Lazy
+handlers.filter_find { |handler| handler.call :a }  # => :a
+handlers.filter_find { |handler| handler.call :x }  # => nil
+----
+
 ===== #including
 
 Adds given array or elements without mutating itself.
@@ -156,6 +173,19 @@ Inserts additional elements or array between all members of given array.
 [1, 2, 3].intersperse %i[a b c]  # => [1, :a, :b, :c, 2, :a, :b, :c, 3]
 ----
 
+===== #maximum
+
+Answers the maximum extracted value from a collection of objects.
+
+[source,ruby]
+----
+Point = Struct.new :x, :y, keyword_init: true
+points = [Point[x: 1, y: 2], Point[x: 0, y: 1], Point[x: 2, y: 3]]
+
+points.maximum(:x)  # => 2
+points.maximum(:y)  # => 3
+----
+
 ===== #mean
 
 Answers mean/average all elements within an array.
@@ -168,6 +198,19 @@ Answers mean/average all elements within an array.
 [1.25, 1.5, 1.75].mean  # => 1.5
 ----
 
+===== #minimum
+
+Answers the minimum extracted value from a collection of objects.
+
+[source,ruby]
+----
+Point = Struct.new :x, :y, keyword_init: true
+points = [Point[x: 1, y: 2], Point[x: 0, y: 1], Point[x: 2, y: 3]]
+
+points.minimum(:x)  # => 0
+points.minimum(:y)  # => 1
+----
+
 ===== #pad
 
 Answers new array padded with given value up to a maximum size. Useful in situations where an array

data/lib/refinements/arrays.rb

@@ -9,12 +9,18 @@ module Refinements
 
       def excluding(*elements) = self - elements.flatten
 
+      def filter_find(&block) = block ? lazy.map(&block).find(&:itself) : lazy
+
       def including(*elements) = self + elements.flatten
 
       def intersperse(*elements) = product([elements]).tap(&:pop).flatten.push(last)
 
+      def maximum(key) = map(&key).max
+
       def mean = size.zero? ? 0 : sum(0) / size
 
+      def minimum(key) = map(&key).min
+
       def pad(value, max: size) = dup.fill(value, size..(max - 1))
 
       def ring(&block) = [last, *self, first].each_cons(3, &block)

data/lib/refinements/identity.rb

@@ -5,7 +5,7 @@ module Refinements
   module Identity
     NAME = "refinements"
     LABEL = "Refinements"
-    VERSION = "8.1.1"
+    VERSION = "8.2.0"
     VERSION_LABEL = "#{LABEL} #{VERSION}"
   end
 end

data/lib/refinements/structs.rb

@@ -21,9 +21,7 @@ module Refinements
       def revalue attributes = each_pair
         return self unless block_given?
 
-        dup.tap do |copy|
-          attributes.each { |key, value| copy[key] = yield self[key], value }
-        end
+        dup.tap { |copy| attributes.each { |key, value| copy[key] = yield self[key], value } }
       end
 
       def revalue! attributes = each_pair

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 8.1.1
+  version: 8.2.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
   W2A=
   -----END CERTIFICATE-----
-date: 2021-04-18 00:00:00.000000000 Z
+date: 2021-05-25 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.16
+rubygems_version: 3.2.17
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.