refinements 9.3.2 → 9.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1944163ba2c01a7e4f8426eb4f51f0a69f03a5cbfc917481f0737eade97606f8
-  data.tar.gz: 507ace61bb505e081844540f9a1c55613ae380f3dd24ae55bbaced230ac33b74
+  metadata.gz: 06c161de8cf1a100c8df6267ef2116368743557dac4504e9617b19dd063520aa
+  data.tar.gz: 60389a48bc41a581d835ac67c80e71a8db438ddbccf070336e1128d4d430e87a
 SHA512:
-  metadata.gz: 921398ebe01062ee06c620a8ec317e8675bac9e75a71db95ce93af132968f807cd36387437d5ae3f4b33635137f618577972dd813fdafcb122e2dfcc941d58f5
-  data.tar.gz: 26b54641a9809e34890fff971f343322abb543f4566af35df2f11724ac6520d9f93833e6959c23191e2ec5279c0123953c6c133d4b80f5a89ede48cd0aef7bda
+  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/lib/refinements/pathnames.rb

@@ -14,7 +14,7 @@ module Refinements
     end
 
     refine Pathname.singleton_class do
-      def home = new(ENV["HOME"])
+      def home = new ENV.fetch("HOME", "")
 
       def make_temp_dir prefix: "temp-", suffix: nil, root: nil
         if block_given?

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "9.3.2"
+  spec.version = "9.5.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/refinements"
@@ -13,6 +13,7 @@ Gem::Specification.new do |spec|
     "bug_tracker_uri" => "https://github.com/bkuhlmann/refinements/issues",
     "changelog_uri" => "https://www.alchemists.io/projects/refinements/versions",
     "documentation_uri" => "https://www.alchemists.io/projects/refinements",
+    "funding_uri" => "https://github.com/sponsors/bkuhlmann",
     "label" => "Refinements",
     "rubygems_mfa_required" => "true",
     "source_code_uri" => "https://github.com/bkuhlmann/refinements"

data.tar.gz.sig

@@ -1,3 +1 @@
-4��D�
-a��
-�P	��k�a�	�4�7y��˅\_�5)}�+]�/�]r��ΰ�/ǯԵ>Ihٝ����$�̰.�ْ���ʬn��4G��A�m݄aA�Hl�b��$���9�,�EjR���7NV()!dx2#�H��|���)Ҕ؝'Yk�Uɉhn��*
+7[�%�";\�EP	**sO6��Eg���mӛũ�?�����]]���97����ѕh�<?$C؇\��>���o���b��[��(�/�q�+�M%�O
-�/]`��h�(������s��ɺ�Z֯D��S/�Ҋ�j�x���d��"Ν_7}8�_�������w�,г�G�Y_R�ݼ��C���0,'���F����s�P��	��´��Z�_�9�v��5�&
�6����#,��Ҝ��

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.3.2
+  version: 9.5.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-04-09 00:00:00.000000000 Z
+date: 2022-06-25 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -61,6 +61,7 @@ metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/refinements/issues
   changelog_uri: https://www.alchemists.io/projects/refinements/versions
   documentation_uri: https://www.alchemists.io/projects/refinements
+  funding_uri: https://github.com/sponsors/bkuhlmann
   label: Refinements
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/bkuhlmann/refinements
@@ -79,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.11
+rubygems_version: 3.3.16
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.