refinements 8.0.1 → 8.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa3c406709e8a34ba5de77de6416ba4a180a42dc994252fb35b9414a73d941c2
-  data.tar.gz: 99426faa5a56f5352ed5620fe4a94e090121c7bd7555ad3c15d0b3a8beee65a1
+  metadata.gz: 3357c002920480a640ec080da0e8744f04a0883fa5ec54b75a88b77f7d2101d6
+  data.tar.gz: f7bd7990e5f362ec9b08e06f42beca263bff1c78be5a68d834cf7dc4fe58e961
 SHA512:
-  metadata.gz: eeb946bc0824dd153fd3bb4615287b0e088c10693c45bdc728e2ee4f2f75207f079584d357afd3085ff289b3cbae45f1f5e14aeb099c0170e78adc0b6012a6bb
-  data.tar.gz: 2fbe37e1cbc1f8c4cc966f7f3d7db70a74481481ecc4c5770053d2b156dfc681e6fd8b2ab1f4432d87daa719a9c6962dd8354a42011ccce61ed7c40d29768d25
+  metadata.gz: 968fc32529ba33a2833b814d722e38e0a5caffcfc3eba154528838a75469a0701847e3a9419d395d632a4c47cf52d927420e95558b90e0cb1b0868066ee99cd9
+  data.tar.gz: 3839e9d117a58251fd9304ad628a76aab0f22f7210542633e2e2fdc13abe38b38c25a126c111430f0c454bf29b5cc6c0b2a94d9473ed6caa59396dedeca8c2ba

checksums.yaml.gz.sig

@@ -1,2 +1,2 @@
-�$�P�~�C���e�Y���&�"`L�%C{+z@t,6�O5��Hd�D����&wy��5]l5K��j%�͖�zK���������KG�n��.t�d �ٖ]�-�e�s�gw{�������S �&3���|�&��py�T�R�#¦��%?I�m"V�����#VFk�](��5�5��y�t$Si@)�����iC�#���2�4�M{��r������*i��stk��Eu3�.t_?o�~"��3�
-�5��}
+Vm�T7�:�UlVCȡ�]��0*���8�Omr�;��V�HR�Y'������ma͒X����O
1���KW%��2U����0$�ٗ>[.T,F�@랉\��[&2ѯ�ƞ��r�X�˅(�O#7d�r#��g��0aJ��1�yK1�bbV��N���sG��
+m��

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

@@ -3,37 +3,27 @@
 module Refinements
   module Arrays
     refine Array do
-      def compress
-        compact.reject(&:empty?)
-      end
+      def compress = compact.reject(&:empty?)
 
-      def compress!
-        replace compress
-      end
+      def compress! = replace(compress)
 
-      def excluding *elements
-        self - elements.flatten
-      end
+      def excluding(*elements) = self - elements.flatten
 
-      def including *elements
-        self + elements.flatten
-      end
+      def filter_find(&block) = block ? lazy.map(&block).find(&:itself) : lazy
 
-      def intersperse *elements
-        product([elements]).tap(&:pop).flatten.push last
-      end
+      def including(*elements) = self + elements.flatten
 
-      def mean
-        size.zero? ? 0 : sum(0) / size
-      end
+      def intersperse(*elements) = product([elements]).tap(&:pop).flatten.push(last)
 
-      def pad value, max: size
-        dup.fill value, size..(max - 1)
-      end
+      def maximum(key) = map(&key).max
 
-      def ring &block
-        [last, *self, first].each_cons 3, &block
-      end
+      def mean = size.zero? ? 0 : sum(0.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)
     end
   end
 end

data/lib/refinements/big_decimals.rb

@@ -5,9 +5,7 @@ require "bigdecimal"
 module Refinements
   module BigDecimals
     refine BigDecimal do
-      def inspect
-        format "#<BigDecimal:%{id} %{string}>", id: object_id, string: to_s("F")
-      end
+      def inspect = format("#<BigDecimal:%{id} %{string}>", id: object_id, string: to_s("F"))
     end
   end
 end

data/lib/refinements/date_times.rb

@@ -5,9 +5,7 @@ require "date"
 module Refinements
   module DateTimes
     refine DateTime.singleton_class do
-      def utc
-        now.new_offset 0
-      end
+      def utc = now.new_offset(0)
     end
   end
 end

data/lib/refinements/hashes.rb

@@ -7,9 +7,7 @@ module Refinements
         new { |new_hash, missing_key| new_hash[missing_key] = new(&new_hash.default_proc) }
       end
 
-      def with_default value
-        new { |new_hash, missing_key| new_hash[missing_key] = value }
-      end
+      def with_default(value) = new { |new_hash, missing_key| new_hash[missing_key] = value }
     end
 
     refine Hash do
@@ -25,25 +23,15 @@ module Refinements
         end
       end
 
-      def deep_merge! other
-        replace deep_merge(other)
-      end
+      def deep_merge!(other) = replace(deep_merge(other))
 
-      def deep_stringify_keys
-        recurse(&:stringify_keys)
-      end
+      def deep_stringify_keys = recurse(&:stringify_keys)
 
-      def deep_stringify_keys!
-        replace deep_stringify_keys
-      end
+      def deep_stringify_keys! = replace(deep_stringify_keys)
 
-      def deep_symbolize_keys
-        recurse(&:symbolize_keys)
-      end
+      def deep_symbolize_keys = recurse(&:symbolize_keys)
 
-      def deep_symbolize_keys!
-        replace deep_symbolize_keys
-      end
+      def deep_symbolize_keys! = replace(deep_symbolize_keys)
 
       # :reek:TooManyStatements
       def flatten_keys prefix: nil, delimiter: "_", cast: :to_sym
@@ -74,21 +62,13 @@ module Refinements
         end
       end
 
-      def stringify_keys
-        reduce({}) { |hash, (key, value)| hash.merge key.to_s => value }
-      end
+      def stringify_keys = reduce({}) { |hash, (key, value)| hash.merge key.to_s => value }
 
-      def stringify_keys!
-        replace stringify_keys
-      end
+      def stringify_keys! = replace(stringify_keys)
 
-      def symbolize_keys
-        reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
-      end
+      def symbolize_keys = reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
 
-      def symbolize_keys!
-        replace symbolize_keys
-      end
+      def symbolize_keys! = replace(symbolize_keys)
 
       def use &block
         return [] unless block

data/lib/refinements/identity.rb

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

data/lib/refinements/ios.rb

@@ -23,13 +23,9 @@ module Refinements
         reopen backup
       end
 
-      def reread length = nil, buffer: nil
-        tap(&:rewind).read length, buffer
-      end
+      def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)
 
-      def squelch &block
-        self.class.void.then { |void| redirect(void, &block) }
-      end
+      def squelch(&block) = self.class.void.then { |void| redirect(void, &block) }
     end
   end
 end

data/lib/refinements/pathnames.rb

@@ -5,6 +5,7 @@ require "pathname"
 module Refinements
   module Pathnames
     refine Kernel do
+      # :reek:UncommunicativeMethodName
       def Pathname object
         return super(String(object)) unless object
 
@@ -13,9 +14,7 @@ module Refinements
     end
 
     refine Pathname.singleton_class do
-      def home
-        new ENV["HOME"]
-      end
+      def home = new(ENV["HOME"])
 
       def make_temp_dir prefix: "temp-", suffix: nil, root: nil
         Dir.mktmpdir([prefix, suffix], root) { |path| block_given? ? yield(new path) : new(path) }
@@ -25,9 +24,7 @@ module Refinements
         new(root).files(pattern).each { |path| require path.to_s }
       end
 
-      def root
-        new "/"
-      end
+      def root = new("/")
     end
 
     refine Pathname do
@@ -45,58 +42,36 @@ module Refinements
         glob(pattern, flag).select(&:directory?).sort
       end
 
-      def extensions
-        basename.to_s.split(/(?=\.)+/).tap(&:shift)
-      end
+      def extensions = basename.to_s.split(/(?=\.)+/).tap(&:shift)
 
-      def files pattern = "*", flag: File::FNM_SYSCASE
-        glob(pattern, flag).select(&:file?).sort
-      end
+      def files(pattern = "*", flag: File::FNM_SYSCASE) = glob(pattern, flag).select(&:file?).sort
 
-      def gsub pattern, replacement
-        self.class.new to_s.gsub(pattern, replacement)
-      end
+      def gsub(pattern, replacement) = self.class.new(to_s.gsub(pattern, replacement))
 
       def make_ancestors
         dirname.mkpath
         self
       end
 
-      def make_dir
-        exist? ? self : mkdir and self
-      end
+      def make_dir = exist? ? self : (mkdir and self)
 
       def make_path
         mkpath
         self
       end
 
-      def name
-        basename extname
-      end
-
-      def relative_parent root_dir
-        relative_path_from(root_dir).parent
-      end
+      def name = basename(extname)
 
-      def relative_parent_from root_dir
-        warn "[DEPRECATION]: Pathname#relative_parent_from is deprecated, " \
-             "use Pathname#relative_parent instead."
-        relative_parent root_dir
-      end
+      def relative_parent(root_dir) = relative_path_from(root_dir).parent
 
-      def remove_dir
-        exist? ? (rmdir and self) : self
-      end
+      def remove_dir = exist? ? (rmdir and self) : self
 
       def remove_tree
         rmtree if exist?
         self
       end
 
-      def rewrite
-        read.then { |content| write yield(content) if block_given? }
-      end
+      def rewrite = read.then { |content| write yield(content) if block_given? }
 
       def touch at = Time.now
         exist? ? utime(at, at) : write("")

data/lib/refinements/string_ios.rb

@@ -5,9 +5,7 @@ require "stringio"
 module Refinements
   module StringIOs
     refine StringIO do
-      def reread length = nil, buffer: nil
-        tap(&:rewind).read length, buffer
-      end
+      def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)
     end
   end
 end

data/lib/refinements/strings.rb

@@ -5,9 +5,7 @@ module Refinements
     DELIMITERS = %r([a-z][A-Z]|\s*-\s*|\s*/\s*|\s*:+\s*|\s*_\s*|\s+)
 
     refine String do
-      def blank?
-        match?(/\A\s*\z/)
-      end
+      def blank? = match?(/\A\s*\z/)
 
       def camelcase
         return up unless match? DELIMITERS
@@ -67,9 +65,7 @@ module Refinements
                                               .then { |parts| combine parts, :up, "/" }
       end
 
-      def to_bool
-        %w[true yes on t y 1].include? downcase.strip
-      end
+      def to_bool = %w[true yes on t y 1].include?(downcase.strip)
 
       def up
         return self if empty?

data/lib/refinements/structs.rb

@@ -3,23 +3,15 @@
 module Refinements
   module Structs
     refine Struct.singleton_class do
-      def keyworded?
-        inspect.include? "keyword_init: true"
-      end
+      def keyworded? = inspect.include?("keyword_init: true")
 
-      def with_keywords **arguments
-        keyworded? ? new(**arguments) : new.merge!(**arguments)
-      end
+      def with_keywords(**arguments) = keyworded? ? new(**arguments) : new.merge!(**arguments)
 
-      def with_positions *values
-        keyworded? ? new(**Hash[members.zip values]) : new(*values)
-      end
+      def with_positions(*values) = keyworded? ? new(**members.zip(values).to_h) : new(*values)
     end
 
     refine Struct do
-      def merge **attributes
-        dup.merge!(**attributes)
-      end
+      def merge(**attributes) = dup.merge!(**attributes)
 
       def merge! **attributes
         to_h.merge(**attributes).each { |key, value| self[key] = value }
@@ -29,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.0.1
+  version: 8.2.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -10,9 +10,9 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIC/jCCAeagAwIBAgIBAzANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
-  a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMDAzMTUxNDQ1MzJaFw0yMTAzMTUx
-  NDQ1MzJaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
+  MIIC/jCCAeagAwIBAgIBBDANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
+  a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMTAzMTkxMjQ4MDZaFw0yMjAzMTkx
+  MjQ4MDZaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
   IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6l1qpXTiomH1RfMRloyw7MiE
   xyVx/x8Yc3EupdH7uhNaTXQGyORN6aOY//1QXXMHIZ9tW74nZLhesWMSUMYy0XhB
   brs+KkurHnc9FnEJAbG7ebGvl/ncqZt72nQvaxpDxvuCBHgJAz+8i5wl6FhLw+oT
@@ -20,15 +20,15 @@ cert_chain:
   D5vkU0YlAm1r98BymuJlcQ1qdkVEI1d48ph4kcS0S0nv1RiuyVb6TCAR3Nu3VaVq
   3fPzZKJLZBx67UvXdbdicWPiUR75elI4PXpLIic3xytaF52ZJYyKZCNZJhNwfQID
   AQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU0nzow9vc
-  2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAIHhAlD3po4sTYqacXaQ
-  XI9jIhrfMy//2PgbHWcETtlJPBeNUbbSNBABcllUHKqYsVDlSvSmss034KSWNR8F
-  bF1GcloicyvcCC4y6IoW4it0COAcdeaaxkxiBSgKdQFpff9REnDlIKK4uQ9lLxIo
-  Y2G5xubiziKZkyfWFuSr67PIjW3Bu673D1JVBArhA1qbgQmYQcy1CkGOjo+iO8Nf
-  7u/QSfBHb+r/bXhKscDgPpnKwbUmvgO2+94zJG9KsrmIydlzYfsD09aXKx0t6Xy4
-  2XV8FRa7/JimI07sPLC13eLY3xd/aYTi85Z782KIA4j0G8XEEWAX0ouBhlXPocZv
-  QWc=
+  2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAEjpaOXHHp8s/7GL2qCb
+  YAs7urOLv9VHSPfQWAwaTMVnSsIf3Sw4xzISOP/mmfEPBPXtz61K5esrE/uTFtgb
+  FyjxQk2H0sEWgrRXGGNHBWQRhhEs7LP/TByoC15A0br++xLxRz4r7HBLGAWQQDpg
+  66BJ2TBVjxS6K64tKbq7+ACyrOZGgTfNHACh4M076y0x0oRf/rwBrU39/KRfuhbb
+  cm+nNCEtO35gTmZ2bVDHLGvWazi3gJt6+huQjfXTCUUG2YYBxwhu+GPdAGQPxpf9
+  lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
+  W2A=
   -----END CERTIFICATE-----
-date: 2020-12-29 00:00:00.000000000 Z
+date: 2021-08-08 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.3
+rubygems_version: 3.2.25
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.