refinements 9.8.0 → 10.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1cd2e7a6476708f49a9261d1021f1cab7e5342e96e03279e31f3ca598a285d09
-  data.tar.gz: 97144fe2d70d45b8b6c8769d98987882f10df33b297ffe4e842703f826c8bf02
+  metadata.gz: 6886f2e81d621658654c24748db65834f2f0d6a1f37b9cd6f5f201dedc0d23e6
+  data.tar.gz: c047e00e34e10f9c4ed31561c5e64e4d247151dec65b1251a14f79d273e21d02
 SHA512:
-  metadata.gz: e3af9aa7b5ed89ce79cde70b6b9985495034b02b5b3ae39c832140652c03d768d04f90a94a3fd206b4a64a539e26445cdccbfa859abdece1d0e00de43cbbdd3c
-  data.tar.gz: 844ca609869449d11639e1f69c2c968768ee4f5df6034c9230315851ea90ef0d31fa6fc4e44bdcad23824ed403972bfde75e8ff5eb212a12228d80ef7c2e31cd
+  metadata.gz: 771838c7e7fa1b044b861724ec99ab78a2f1393db0dc9f2906ebf9fd58d34aa2adee55dccf7c4cd045e9ac4b3b30a49fbc613b23628ca216ce47c271289038d4
+  data.tar.gz: 13c855b9fdc681ab75e008a61059bec785f8918f7fbfa44576100a5f014102ea806d6b0061eae89475106cb8cc55625026c536d5f6d55144d8cf06127604d7cb

data/README.adoc

@@ -128,28 +128,32 @@ example.combinatorial? []           # false
 
 ===== #compress
 
-Removes `nil` and empty objects without mutating itself.
+Removes `nil` and empty objects without mutating itself. Answers itself if there is nothing to remove.
 
 [source,ruby]
 ----
 object = Object.new
 example = [1, "blueberry", nil, "", [], {}, object]
 
+[].compress       # []
+[1, 2].compress   # [1, 2]
 example.compress  # [1, "blueberry", object]
 example           # [1, "blueberry", nil, "", [], {}, object]
 ----
 
 ===== #compress!
 
-Removes `nil` and empty values while mutating itself.
+Removes `nil` and empty values while mutating itself. Answers `nil` if there is nothing to remove.
 
 [source,ruby]
 ----
 object = Object.new
 example = [1, "blueberry", nil, "", [], {}, object]
 
-example.compress  # [1, "blueberry", object]
-example           # [1, "blueberry", object]
+[].compress!       # nil
+[1, 2].compress!   # nil
+example.compress!  # [1, "blueberry", object]
+example            # [1, "blueberry", object]
 ----
 
 ===== #excluding
@@ -219,7 +223,7 @@ Answers the maximum extracted value from a collection of objects.
 
 [source,ruby]
 ----
-Point = Struct.new :x, :y, keyword_init: true
+Point = Struct.new :x, :y
 points = [Point[x: 1, y: 2], Point[x: 0, y: 1], Point[x: 2, y: 3]]
 
 points.maximum(:x)  # 2
@@ -244,7 +248,7 @@ Answers the minimum extracted value from a collection of objects.
 
 [source,ruby]
 ----
-Point = Struct.new :x, :y, keyword_init: true
+Point = Struct.new :x, :y
 points = [Point[x: 1, y: 2], Point[x: 0, y: 1], Point[x: 2, y: 3]]
 
 points.minimum(:x)  # 0
@@ -367,28 +371,32 @@ example[:b]  # []
 
 ===== #compress
 
-Removes `nil` and empty objects without mutating itself.
+Removes `nil` and empty objects without mutating itself. Answers itself if there is nothing to remove.
 
 [source,ruby]
 ----
 object = Object.new
 example = {a: 1, b: "blueberry", c: nil, d: "", e: [], f: {}, g: object}
 
-example.compress  # {a: 1, b: "blueberry", g: object}
-example           # {a: 1, b: "blueberry", c: nil, d: "", e: [], f: {}, g: object}
+{}.compress            # {}
+{a: 1, b: 2}.compress  # {a: 1, b: 2}
+example.compress       # {a: 1, b: "blueberry", g: object}
+example                # {a: 1, b: "blueberry", c: nil, d: "", e: [], f: {}, g: object}
 ----
 
 ===== #compress!
 
-Removes `nil` and empty objects while mutating itself.
+Removes `nil` and empty objects while mutating itself. Answers `nil` if there is nothing to remove.
 
 [source,ruby]
 ----
 object = Object.new
 example = {a: 1, b: "blueberry", c: nil, d: "", e: [], f: {}, g: object}
 
-example.compress!  # {a: 1, b: "blueberry", g: object}
-example            # {a: 1, b: "blueberry", g: object}
+{}.compress!            # nil
+{a: 1, b: 2}.compress!  # nil
+example.compress!       # {a: 1, b: "blueberry", g: object}
+example                 # {a: 1, b: "blueberry", g: object}
 ----
 
 ===== #deep_merge
@@ -485,9 +493,6 @@ though.
 {a: {b: 1}}.flatten_keys prefix: :test          # {test_a_b: 1}
 {a: {b: 1}}.flatten_keys delimiter: :|          # {:"a|b" => 1}
 
-{a: {b: 1}}.flatten_keys cast: :to_s            # {"a_b" => 1}
-{"a" => {"b" => 1}}.flatten_keys cast: :to_sym  # {a_b: 1}
-
 example = {a: {b: 1}}
 example.flatten_keys                            # {a_b: 1}
 example                                         # {a: {b: 1}}
@@ -500,6 +505,9 @@ though.
 
 [source,ruby]
 ----
+{a: {b: 1}}.flatten_keys! prefix: :test          # {test_a_b: 1}
+{a: {b: 1}}.flatten_keys! delimiter: :|          # {:"a|b" => 1}
+
 example = {a: {b: 1}}
 example.flatten_keys!  # {a_b: 1}
 example                # {a_b: 1}
@@ -597,14 +605,6 @@ example.transform_with bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-Nil values are skipped:
-
-[source,ruby]
-----
-{email: nil}.transform_with email: -> value { value.tr "<>", "" }
-# {email: nil}
-----
-
 The original object will not be mutated:
 
 [source,ruby]
@@ -635,14 +635,6 @@ example.transform_with! bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-Nil values are skipped:
-
-[source,ruby]
-----
-{email: nil}.transform_with! email: -> value { value.tr "<>", "" }
-# {email: nil}
-----
-
 The original object will be mutated:
 
 [source,ruby]
@@ -1273,36 +1265,6 @@ buffer                     # "This is a test."
 
 ==== Struct
 
-===== .keyworded?
-
-⚠️ Will be removed in the next major version. Use `.keyword_init?` instead.
-
-Answers whether a struct was constructed with keyword or positional arguments.
-
-[source,ruby]
-----
-Struct.new(:a, keyword_init: true).keyworded?  # true
-Struct.new(:a).keyworded?                      # false
-----
-
-===== .with_keywords
-
-Answers a struct instance with given keyword arguments regardless of
-whether the struct was constructed with positional or keyword arguments.
-
-[source,ruby]
-----
-Example = Struct.new :a, :b, :c
-Example.with_keywords a: 1, b: 2, c: 3  # #<struct a=1, b=2, c=3>
-Example.with_keywords a: 1              # #<struct a=1, b=nil, c=nil>
-Example.with_keywords c: 1              # #<struct a=nil, b=nil, c=1>
-
-Example = Struct.new :a, :b, :c, keyword_init: true
-Example.with_keywords a: 1, b: 2, c: 3  # #<struct a=1, b=2, c=3>
-Example.with_keywords a: 1              # #<struct a=1, b=nil, c=nil>
-Example.with_keywords c: 1              # #<struct a=nil, b=nil, c=1>
-----
-
 ===== .with_positions
 
 Answers a struct instance with given positional arguments regardless of

data/lib/refinements/arrays.rb

@@ -10,11 +10,11 @@ module Refinements
 
       def combinatorial?(other) = !other.empty? && size == union(other).size
 
-      def compress = dup.compress!
+      def compress = compact.delete_if { |element| element.respond_to?(:empty?) && element.empty? }
 
       def compress!
-        compact!
         delete_if { |element| element.respond_to?(:empty?) && element.empty? }
+        compact!
       end
 
       def excluding(*elements) = self - elements.flatten

data/lib/refinements/hashes.rb

@@ -16,13 +16,11 @@ module Refinements
     refine Hash do
       import_methods Shared::Enumerables::Many
 
-      def compress = dup.compress!
+      def compress = compact.delete_if { |_key, value| value.respond_to?(:empty?) && value.empty? }
 
       def compress!
-        return self if empty?
-
-        compact!
         delete_if { |_key, value| value.respond_to?(:empty?) && value.empty? }
+        compact!
       end
 
       def deep_merge other
@@ -49,24 +47,17 @@ module Refinements
 
       def fetch_value(key, *default_value, &) = fetch(key, *default_value, &) || default_value.first
 
-      # :reek:TooManyStatements
-      def flatten_keys prefix: nil, delimiter: "_", cast: :to_sym
-        fail StandardError, "Unknown cast: #{cast}." unless %i[to_sym to_s].include? cast
-
-        reduce({}) do |flat, (key, value)|
-          flat_key = prefix ? "#{prefix}#{delimiter}#{key}" : key
+      def flatten_keys prefix: nil, delimiter: "_"
+        reduce({}) do |accumulator, (key, value)|
+          flat_key = prefix ? "#{prefix}#{delimiter}#{key}".to_sym : key
 
-          next flat.merge flat_key.public_send(cast) => value unless value in Hash
+          next accumulator.merge flat_key => value unless value in Hash
 
-          flat.merge(
-            recurse { value.flatten_keys prefix: flat_key, delimiter:, cast: }
-          )
+          accumulator.merge(recurse { value.flatten_keys prefix: flat_key, delimiter: })
         end
       end
 
-      def flatten_keys! prefix: nil, delimiter: "_", cast: :to_sym
-        replace flatten_keys(prefix:, delimiter:, cast:)
-      end
+      def flatten_keys!(prefix: nil, delimiter: "_") = replace flatten_keys(prefix:, delimiter:)
 
       def recurse &block
         return self unless block
@@ -86,11 +77,7 @@ module Refinements
       def transform_with(operations) = dup.transform_with! operations
 
       def transform_with! operations
-        operations.each do |key, function|
-          value = self[key]
-          self[key] = function.call value if value
-        end
-
+        operations.each { |key, function| self[key] = function.call self[key] if key? key }
         self
       end
 

data/lib/refinements/string_ios.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "stringio"
 require "refinements/shared/ios/reread"
+require "stringio"
 
 module Refinements
   # Provides additional enhancements to the StringIO primitive.

data/lib/refinements/structs.rb

@@ -4,13 +4,6 @@ module Refinements
   # Provides additional enhancements to the Struct primitive.
   module Structs
     refine Struct.singleton_class do
-      def keyworded?
-        warn "[DEPRECATION]: .keyworded? is deprecated, use .keyword_init? instead."
-        inspect.include? "keyword_init: true"
-      end
-
-      def with_keywords(**arguments) = keyword_init? ? new(**arguments) : new.merge!(**arguments)
-
       def with_positions(*values) = keyword_init? ? new(**members.zip(values).to_h) : new(*values)
     end
 

data/lib/refinements.rb

@@ -5,10 +5,10 @@ require "refinements/big_decimals"
 require "refinements/date_times"
 require "refinements/hashes"
 require "refinements/ios"
+require "refinements/log_devices"
+require "refinements/loggers"
 require "refinements/pathnames"
-require "refinements/strings"
 require "refinements/string_ios"
+require "refinements/strings"
 require "refinements/structs"
 require "refinements/symbols"
-require "refinements/log_devices"
-require "refinements/loggers"

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "9.8.0"
+  spec.version = "10.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/refinements"
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.signing_key = Gem.default_key_path
   spec.cert_chain = [Gem.default_cert_path]
 
-  spec.required_ruby_version = "~> 3.1"
+  spec.required_ruby_version = "~> 3.2"
 
   spec.files = Dir["*.gemspec", "lib/**/*"]
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.8.0
+  version: 10.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-11-15 00:00:00.000000000 Z
+date: 2022-12-25 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -76,14 +76,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.25
+rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.

metadata.gz.sig

@@ -1,2 +1 @@
-�!u�iĪ�
-
��"g��2����͆knM�x����FT��N��(@j����d?����Z���/�|19����h�WCޖ���Xn��KgB���QE������`a�U��j���Qx���i���
}��;dS�����^6�;n����t����gcX��c  ��ꭌ�1g1�h�I�z�/�C/vEL��FR��#XxYl�4��W�)�ɽ�*�-x�O2�&��X%�F�$����r����\��z��v�#J��n
+:vqw��,�}�p���C�V3Z������w�����̇�����B@�-族�fS���c��S�7$b\g�x
�Ɂ��WS%�[��M��!�.�C��;8��w�|%u[�/��t���ƌg�H�v��#f�&�����M1�4Y���9݁�5H_�-��W[̈́B�	�D���������
!��с�g��H�v���^Ʊ�-�OOv����<�$��'`�6M�9�r���7���$�����ׇC@{I��|[>ӥ��