refinements 9.4.0 → 9.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48645ddfcd7e2ab3a7930401d2161dd259de6bf89ac2f5dbdf8f32015a9c9ed2
-  data.tar.gz: 8788e3eef62a5856f9136b38b6b76fe9d4c5a8db56b39394f8021bb6ea1db36d
+  metadata.gz: 06c161de8cf1a100c8df6267ef2116368743557dac4504e9617b19dd063520aa
+  data.tar.gz: 60389a48bc41a581d835ac67c80e71a8db438ddbccf070336e1128d4d430e87a
 SHA512:
-  metadata.gz: 51c14c8e25b187ae86630f6c8c017cae3f53f16a4a1a72a9cbdfd3d5e2e83fe1e1bb07b2eacfb4865e35c5bd32092021f4758fdc454be900f42477a8f1a5f190
-  data.tar.gz: 8b4a378f5bd2e1eec9a3ca9c1bf72c0a5e3773dbe3ece7bebf5ac4bf3be815bd35b25ddc918de5a51116e6d43c98d4b0e54b423beaa2e1532a48645f477337b5
+  metadata.gz: 95c680f9fe5df9820d72462e40984eafe398b0cf81589b6525026978a477950723608d8d39b89b3fe0c61e888ce3a2a166d2e54ec26676a3c9621f6b712e3828
+  data.tar.gz: b3743029174a74733328346ce1264d9f7dab9876222deb4a3b3f96a38817cf8b7c0b35eabc62639b5f7e7f4f2e1572282d1f31952e6c55b90d6f65df2b190bef

data/README.adoc

@@ -254,6 +254,21 @@ example.ring { |(before, current, after)| puts "#{before} #{current} #{after}" }
 # [2 3 1]
 ----
 
+===== #to_sentence
+
+Answers a sentence using `", "` as the default delimiter and `"and"` as the default conjunction.
+Useful when building documentation, answering human readable error messages, etc.
+
+[source,ruby]
+----
+[].to_sentence                                                     # ""
+["test"].to_sentence                                               # "test"
+["a", :b].to_sentence                                              # "a and b"
+[1, "a", :b, 2.0, /\w+/].map(&:inspect).to_sentence                # 1, "a", :b, 2.0, and /\w+/
+%w[one two three].to_sentence                                      # "one, two, and three"
+%w[eins zwei drei].to_sentence delimiter: " ", conjunction: "und"  # "eins zwei und drei"
+----
+
 ==== Big Decimal
 
 ===== #inspect

data/lib/refinements/arrays.rb

@@ -32,6 +32,14 @@ module Refinements
       def pad(value, max: size) = dup.fill(value, size..(max - 1))
 
       def ring(&) = [last, *self, first].each_cons(3, &)
+
+      def to_sentence delimiter: ", ", conjunction: "and"
+        case length
+          when (3..) then "#{self[..-2].join delimiter}#{delimiter}#{conjunction} #{last}"
+          when 2 then join " #{conjunction} "
+          else join
+        end
+      end
     end
   end
 end

data/lib/refinements/hashes.rb

@@ -21,7 +21,8 @@ module Refinements
       def compress!
         return self if empty?
 
-        compact!.delete_if { |_key, value| value.respond_to?(:empty?) && value.empty? }
+        compact!
+        delete_if { |_key, value| value.respond_to?(:empty?) && value.empty? }
       end
 
       def deep_merge other

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "9.4.0"
+  spec.version = "9.5.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.4.0
+  version: 9.5.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-05-07 00:00:00.000000000 Z
+date: 2022-06-25 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.13
+rubygems_version: 3.3.16
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.