refinements 12.8.0 → 12.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81ecb80884f2fcc3c01f67b069fc4d8e46bf6c0dec1a03013a0f4183800c971e
-  data.tar.gz: 85ced417ccf67b5940b1441df1cacc2d9ca32812e4bc9f89d775e17574cce1e9
+  metadata.gz: 229ada32a4378800013462184db88be59d33109cbbd63c8c6378add52fc7b321
+  data.tar.gz: 4f0291390f858b45e2066dc9eac5e3f06ceef5c9e1051160aa7c625e734c78c4
 SHA512:
-  metadata.gz: a9d24dfcb5491cda43127501056b1cbb74fa13286964bcfca60107e42ca2bb67c56e22e35fd8773f83e91c16122c97d2723ac6ca0fc1094c6bd746bee7c5bff6
-  data.tar.gz: c8bbde575d08783fbf64d303fac8cb8cc0b0215b7bdc8e532ce1180f8451bc12e02391c9e22300edaba464ee50a1d2b1eb31b4081e8a234350e174ddc8cc7c08
+  metadata.gz: dbe61e5483ff24ffe0d9852e3f1c34e613f53a48f8a96cb15b862bf2528c448df71e9357d2910068b7e41275a916a9169f99e6b5b67c355df73eaf3e6ac2d124
+  data.tar.gz: 3f77b617a157b3d9be6735a08a9340ddd945642107d5e2728e384f6496197a44e180cfcce8c5738ec5ea509df883fcc5ca3b1261ffaddeaedbcfe0764987d9d0

data/README.adoc

@@ -635,7 +635,7 @@ Any object that _is not_ the same type will have a `nil` value as shown in the l
 
 Fetches value for exiting or missing key. Behavior is identical to `#fetch` except when the value of
 the key is `nil` you'll get the default value instead. This eliminates the need for using an _or_
-expression `example.fetch(:desired_key) || "default_value"`.
+expression: `example.fetch(:desired_key) || "default_value"`.
 
 [source,ruby]
 ----
@@ -650,8 +650,7 @@ expression `example.fetch(:desired_key) || "default_value"`.
 
 ===== #flatten_keys
 
-Flattens nested keys as top-level keys without mutating itself. Does not handle nested arrays,
-though.
+Flattens nested keys as top-level keys without mutating itself. Keys are converted to symbols. Does not handle nested arrays.
 
 [source,ruby]
 ----
@@ -665,8 +664,7 @@ example                                         # {a: {b: 1}}
 
 ===== #flatten_keys!
 
-Flattens nested keys as top-level keys while mutating itself. Does not handle nested arrays,
-though.
+Flattens nested keys as top-level keys while mutating itself. Keys are converted to symbols. Does not handle nested arrays.
 
 [source,ruby]
 ----
@@ -747,6 +745,52 @@ example.symbolize_keys!  # {a: 1, b: 2}
 example                  # {a: 1, b: 2}
 ----
 
+===== #transform_value
+
+Transforms a value for the specified key _only_ if the key exists and a block is given. Otherwise, the original hash is answered. Does not mutate itself.
+
+[source,ruby]
+----
+example = {a: 1, b: 2}
+
+example.transform_value :b                          # {a: 1, b: 2}
+example.transform_value(:b) { 20 }                  # {a: 1, b: 20}
+example.transform_value(:b) { |value| value * 10 }  # {a: 1, b: 20}
+example.transform_value :c                          # {a: 1, b: 2}
+example.transform_value(:c) { :bogus }              # {a: 1, b: 2}
+----
+
+The original object _is not_ mutated:
+
+[source,ruby]
+----
+example.transform_value(:b) { 20 }  # {a: 1, b: 20}
+example                             # {a: 1, b: 2}
+----
+
+===== #transform_value!
+
+Transforms a value for the specified key _only_ if the key exists and a block is given. Otherwise, the original hash is answered. Mutates itself.
+
+[source,ruby]
+----
+example = {a: 1, b: 2}
+
+example.transform_value! :b                          # {a: 1, b: 2}
+example.transform_value!(:b) { 20 }                  # {a: 1, b: 20}
+example.transform_value!(:b) { |value| value * 10 }  # {a: 1, b: 20}
+example.transform_value! :c                          # {a: 1, b: 2}
+example.transform_value!(:c) { :bogus }              # {a: 1, b: 2}
+----
+
+The original object _is_ mutated:
+
+[source,ruby]
+----
+example.transform_value!(:b) { 20 }  # {a: 1, b: 20}
+example                              # {a: 1, b: 20}
+----
+
 ===== #transform_with
 
 Transforms values of keys using specific operations (i.e. any object that responds to `#call`). Does not mutate itself and you can transform multiple values at once:
@@ -768,7 +812,7 @@ example.transform_with bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-The original object _will not_ be mutated:
+The original object _is not_ mutated:
 
 [source,ruby]
 ----
@@ -796,7 +840,7 @@ example.transform_with! bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-The original object _will be_ mutated:
+The original object _is_ mutated:
 
 [source,ruby]
 ----

data/lib/refinements/array.rb

@@ -19,7 +19,7 @@ module Refinements
 
       def excluding(*elements) = self - elements.flatten
 
-      def filter_find(&block) = block ? lazy.map(&block).find(&:itself) : lazy
+      def filter_find(&) = block_given? ? lazy.map(&).find(&:itself) : lazy
 
       def including(*elements) = self + elements.flatten
 

data/lib/refinements/hash.rb

@@ -80,9 +80,15 @@ module Refinements
 
       def symbolize_keys! = transform_keys!(&:to_sym)
 
-      def transform_with(operations) = dup.transform_with! operations
+      def transform_value(key, &) = dup.transform_value!(key, &)
 
-      def transform_with! operations
+      def transform_value! key
+        block_given? && key?(key) ? merge!(key => yield(self[key])) : self
+      end
+
+      def transform_with(**) = dup.transform_with!(**)
+
+      def transform_with!(**operations)
         operations.each { |key, function| self[key] = function.call self[key] if key? key }
         self
       end

data/lib/refinements/pathname.rb

@@ -53,14 +53,14 @@ module Refinements
       def delete_suffix(pattern) = parent.join %(#{name.sub(/#{pattern}\z/, "")}#{extname})
 
       def directories pattern = "*", flag: File::FNM_SYSCASE
-        glob(pattern, flag).select(&:directory?).sort
+        glob(pattern, flag).select(&:directory?)
       end
 
       def empty = file? ? (truncate(0) and self) : remove_tree.make_dir
 
       def extensions = basename.to_s.split(/(?=\.)+/).tap(&:shift)
 
-      def files(pattern = "*", flag: File::FNM_SYSCASE) = glob(pattern, flag).select(&:file?).sort
+      def files(pattern = "*", flag: File::FNM_SYSCASE) = glob(pattern, flag).select(&:file?)
 
       def gsub(pattern, replacement) = self.class.new(to_s.gsub(pattern, replacement))
 

data/refinements.gemspec

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 12.8.0
+  version: 12.9.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-09-01 00:00:00.000000000 Z
+date: 2024-10-01 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -96,7 +96,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
+rubygems_version: 3.5.20
 signing_key:
 specification_version: 4
 summary: A collection of core object refinements.