refinements 12.0.0 → 12.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a497496f7842bab471ed5d7703054c050aad5d62dcdc317678d4d40d871dbefe
-  data.tar.gz: 117975da807b741ff3b9dff8d585dbba8d00243af81f7c8daf964cda0de6b7b9
+  metadata.gz: 2067ee329cd6e63e9e6a2045815951df747abe35b5e8e6c456f60ab7242b4d59
+  data.tar.gz: 4e41441c9b45b303a3b179a620c35ffe7605eb8b53992ea654812ae6ba302b3a
 SHA512:
-  metadata.gz: bf13a20ac2e6f6849ab0ae65929f0574c6569cf5840e8aada271f63749326c319531c1e6a572b9bad2526cfb5280df48d9f1ee638a4cff87105e2429edad2d23
-  data.tar.gz: 6b07855b0b39fe4d45509e9cbc11c8e7392a686cd485b73cab3c6134ad6d709f3355cb0b3f18bff81becbfb87058c8f3e0e872ad7db69a657a1c25e8d1390533
+  metadata.gz: 248aa4f7d8f182f2b6f268c135f773ea0076d89cf3a6cc671433f8383efee30fc056d0fdf660af21b1bd97e4ed10bfc1b2579298acdfa81309b6e9305ca70da5
+  data.tar.gz: fb0ba5bf68bfd7fc06477cb5b049c79a16f5e69a27dc7203088db835df3ed2f028796e637fdacb87c1b49145601c0986048272c1580f58e1a2c52c6e36e2c8ff

data/README.adoc

@@ -376,9 +376,11 @@ Useful when building documentation, answering human readable error messages, etc
 %w[eins zwei drei].to_sentence "und", delimiter: " "  # "eins zwei und drei"
 ----
 
+💡 You can use a string or a symbol for the conjunction (i.e. `"and"` or `:and`).
+
 ===== #to_usage
 
-Builds upon and enhances `#to_sentence` further by answering a sentence which all elements are inspected -- where each element of the array is called with `#inspect` -- before turned into a sentence using `"and"` as the default conjunction and `", "` as the default delimiter. This is useful when providing detailed error messages _and_ you need to detail the types of element used.
+Further enhances `#to_sentence` by answering a sentence where all elements are inspected (i.e. `#inspect`) before turned into a sentence using `"and"` as the default conjunction and `", "` as the default delimiter. This is useful when providing detailed error messages _and_ you need the _types_ of all elements preserved.
 
 [source,ruby]
 ----
@@ -390,6 +392,8 @@ Builds upon and enhances `#to_sentence` further by answering a sentence which al
 %w[eins zwei drei].to_usage "und", delimiter: " "  # "\"eins\" \"zwei\" und \"drei\""
 ----
 
+💡 You can use a string or a symbol for the conjunction (i.e. `"and"` or `:and`).
+
 ==== Data
 
 ===== #diff
@@ -575,12 +579,13 @@ expression `example.fetch(:desired_key) || "default_value"`.
 
 [source,ruby]
 ----
-{a: "demo"}.fetch_value :a, "default"  # "demo"
-{a: "demo"}.fetch_value :a             # "demo"
-{a: nil}.fetch_value :a, "default"     # "default"
-{}.fetch_value(:a) { "default" }       # "default"
-{}.fetch_value :a                      # KeyError
-{a: "demo"}.fetch_value                # ArgumentError
+{a: "demo"}.fetch_value :a, "default"   # "demo"
+{a: "demo"}.fetch_value :a              # "demo"
+{a: nil}.fetch_value :a, "default"      # "default"
+{a: nil}.fetch_value(:a) { "default" }  # "default"
+{}.fetch_value :a                       # KeyError
+{}.fetch_value(:a) { "default" }        # "default"
+{a: "demo"}.fetch_value                 # ArgumentError
 ----
 
 ===== #flatten_keys

data/lib/refinements/hash.rb

@@ -51,7 +51,9 @@ module Refinements
         each.with_object({}) { |(key, value), diff| diff[key] = [value, nil] }
       end
 
-      def fetch_value(key, *default, &) = fetch(key, *default, &) || default.first
+      def fetch_value(key, *default, &)
+        fetch(key, *default, &) || (yield if block_given?) || default.first
+      end
 
       def flatten_keys prefix: nil, delimiter: "_"
         reduce({}) do |accumulator, (key, value)|

data/lib/refinements/io.rb

@@ -28,9 +28,7 @@ module Refinements
         reopen backup
       end
 
-      # rubocop:todo Naming/BlockForwarding
       def squelch(&block) = self.class.void.then { |void| redirect(void, &block) }
-      # rubocop:enable Naming/BlockForwarding
     end
   end
 end

data/lib/refinements/symbol.rb

@@ -4,11 +4,9 @@ module Refinements
   # Provides additional enhancements to the Symbol primitive.
   module Symbol
     refine ::Symbol do
-      # rubocop:todo Naming/BlockForwarding
       def call(*arguments, &block)
         proc { |receiver| receiver.public_send self, *arguments, &block }
       end
-      # rubocop:enable Naming/BlockForwarding
     end
   end
 end

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "12.0.0"
+  spec.version = "12.1.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.0.0
+  version: 12.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-01-01 00:00:00.000000000 Z
+date: 2024-01-28 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -91,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.5
 signing_key:
 specification_version: 4
 summary: A collection of core Ruby object refinements.