refinements 9.7.1 → 9.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dbec0b903b2ce6a78545bf34285ab60d20fd1b511975c750829a883107de915
-  data.tar.gz: 14c0fa259be4dd70fcc3766bcf745b9c267af3b1a58c0f32fc0f1fdfbb9d6458
+  metadata.gz: 1cd2e7a6476708f49a9261d1021f1cab7e5342e96e03279e31f3ca598a285d09
+  data.tar.gz: 97144fe2d70d45b8b6c8769d98987882f10df33b297ffe4e842703f826c8bf02
 SHA512:
-  metadata.gz: 0bdd1ea6074fd07ae02659c283a1a035da4695d5375150264eea4e88ca5eae7b041a41ea6a14384305143695752fd6c1397477be387a28e75d39f80c907c8f87
-  data.tar.gz: 0caa5d7b26ad27a5378daad28b9a0cc7c7bc6c6f0d5db5d3fc2f20cacc0a834ae902269b74432196df89b90510d918afa60a941ae19254cb6bf0eecc46fec8f8
+  metadata.gz: e3af9aa7b5ed89ce79cde70b6b9985495034b02b5b3ae39c832140652c03d768d04f90a94a3fd206b4a64a539e26445cdccbfa859abdece1d0e00de43cbbdd3c
+  data.tar.gz: 844ca609869449d11639e1f69c2c968768ee4f5df6034c9230315851ea90ef0d31fa6fc4e44bdcad23824ed403972bfde75e8ff5eb212a12228d80ef7c2e31cd

data/README.adoc

@@ -574,6 +574,82 @@ example.symbolize_keys!  # {a: 1, b: 2}
 example                  # {a: 1, b: 2}
 ----
 
+===== #transform_with
+
+Transforms key/value pairs based on specific operations where each operation (i.e. function that responds to the `call` message). Does not mutate itself.
+
+You can transform multiple values at once:
+
+[source,ruby]
+----
+example = {name: "Jayne Doe", email: "<jd@example.com>"}
+
+example.transform_with name: -> value { value.delete_suffix " Doe" },
+                       email: -> value { value.tr "<>", "" }
+# {name: "Jayne", email: "jd@example.com"}
+----
+
+Invalid keys are ignored:
+
+[source,ruby]
+----
+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]
+----
+example  # {name: "Jayne Doe", email: "<jd@example.com>"}
+----
+
+===== #transform_with!
+
+Transforms key/value pairs based on specific operations where each operation (i.e. function that responds to the `call` message). Mutates itself.
+
+You can transform multiple values at once:
+
+[source,ruby]
+----
+example = {name: "Jayne Doe", email: "<jd@example.com>"}
+
+example.transform_with! name: -> value { value.delete_suffix " Doe" },
+                        email: -> value { value.tr "<>", "" }
+# {name: "Jayne", email: "jd@example.com"}
+----
+
+Invalid keys are ignored:
+
+[source,ruby]
+----
+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]
+----
+example  # {name: "Jayne", email: "jd@example.com"}
+----
+
 ===== #use
 
 Passes each hash value as a block argument for further processing.
@@ -1135,6 +1211,16 @@ Answers a snake cased string.
 "ThisIsAnExample".snakecase  # "this_is_an_example"
 ----
 
+===== #squish
+
+Removes leading, in body, and trailing whitespace, including any tabs or newlines, without mutating itself. Processes ASCII and unicode whitespace as well.
+
+[source,ruby]
+----
+"one two three".squish                  # "one two three"
+" one  two   \n    \t   three ".squish  # "one two three"
+----
+
 ===== #titleize
 
 Answers a title string with proper capitalization of each word.

data/lib/refinements/hashes.rb

@@ -47,9 +47,7 @@ module Refinements
 
       def deep_symbolize_keys! = replace(deep_symbolize_keys)
 
-      def fetch_value(key, *default_value, &)
-        fetch(key, *default_value, &) || default_value.first
-      end
+      def fetch_value(key, *default_value, &) = fetch(key, *default_value, &) || default_value.first
 
       # :reek:TooManyStatements
       def flatten_keys prefix: nil, delimiter: "_", cast: :to_sym
@@ -58,7 +56,7 @@ module Refinements
         reduce({}) do |flat, (key, value)|
           flat_key = prefix ? "#{prefix}#{delimiter}#{key}" : key
 
-          next flat.merge flat_key.public_send(cast) => value unless value.is_a? self.class
+          next flat.merge flat_key.public_send(cast) => value unless value in Hash
 
           flat.merge(
             recurse { value.flatten_keys prefix: flat_key, delimiter:, cast: }
@@ -74,10 +72,7 @@ module Refinements
         return self unless block
 
         transform = yield self
-
-        transform.each do |key, value|
-          transform[key] = value.recurse(&block) if value.is_a? self.class
-        end
+        transform.each { |key, value| transform[key] = value.recurse(&block) if value in Hash }
       end
 
       def stringify_keys = transform_keys(&:to_s)
@@ -88,6 +83,17 @@ module Refinements
 
       def symbolize_keys! = transform_keys!(&:to_sym)
 
+      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
+
+        self
+      end
+
       def use &block
         return [] unless block
 

data/lib/refinements/strings.rb

@@ -50,6 +50,8 @@ module Refinements
                                            .then { |parts| combine parts, :down, "_" }
       end
 
+      def squish = gsub(/[[:space:]]+/, " ").tap(&:strip!)
+
       def titleize
         return capitalize unless match? DELIMITERS
 

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "9.7.1"
+  spec.version = "9.8.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/refinements"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.7.1
+  version: 9.8.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-10-22 00:00:00.000000000 Z
+date: 2022-11-15 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.24
+rubygems_version: 3.3.25
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.