refinements 14.1.0 → 14.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 350ced29340ad39df23a202e41b3721db7293c3993364bc8796cca57bddc764c
-  data.tar.gz: afff690e4107212f7bd72054637c9ef8da2bd1265de55899f23fe9769fd616af
+  metadata.gz: d020697c0869daf2e3bcc99d87db35971ed15bd9a232b930f5420fdd1e463822
+  data.tar.gz: 1a90b8c69ca796cb3445939e9661d6f41f89eb54f52142f98d868783d067402c
 SHA512:
-  metadata.gz: 350c7deafda58ba8f4770ffd993ab3bdd4519fe510e18bd9f52fb383a561d5790ce00598c06aae65d20b585fc848388218118bac0430995ab19350288160cecd
-  data.tar.gz: aa43882784697baa26fdb2a522ef15ff359baa7ff91b72c6234e55b7c10d99d347bce79b33aa15051980f5ef6851eaa4536c7453f670c6bdcef51621990a5eff
+  metadata.gz: b855ed89c0deadec703182707a3a77f025ac02dd9893e81bacc1bb63f85dcf9e7c3ca63cdabd448417af4e4be1b92920271129ed3e575afc9210acc73cc8f01c
+  data.tar.gz: 7f3933aef0ab201659aa807360f84c9dacc7844e2b86800e49cebf20f62dcb3fab20e1357468df90b4b2c5e931c064f0373743097206fd180f62cdaf2214cfdd

data/README.adoc

@@ -25,6 +25,7 @@ Enhances the following objects:
 * StringIO
 * Struct
 * Symbol
+* Time
 
 == Requirements
 
@@ -91,6 +92,7 @@ require "refinements/string"
 require "refinements/string_io"
 require "refinements/struct"
 require "refinements/symbol"
+require "refinements/time"
 ----
 
 === Using
@@ -114,6 +116,7 @@ class Example
   using Refinements::StringIO
   using Refinements::Struct
   using Refinements::Symbol
+  using Refinements::Time
 end
 ----
 
@@ -462,6 +465,8 @@ Any object that _is not_ the same type will have a `nil` value as shown in the l
 
 Answers new DateTime object for current UTC date/time.
 
+⚠️ This method (and refinement) is deprecated and will be removed in the next major release.
+
 [source,ruby]
 ----
 DateTime.utc # "#<DateTime: 2019-12-31T18:17:00+00:00 ((2458849j,65820s,181867000n),+0s,2299161j)>"
@@ -1446,21 +1451,20 @@ Answers a title string with proper capitalization of each word.
 
 ===== #trim_end
 
-Answers the trimmed end of a string (non-mutated) for given length with optional delimiter and/or overflow.
+Answers the trimmed end of a string for maximum length with optional delimiter and/or overflow.
 
-The delimiter is the second positional parameter (optional) and is `nil` by default. A custom string or regular expression can be used to customize behavior.
+The delimiter is the second positional parameter (optional) and is `nil` by default. A string or regular expression can be used to customize behavior.
 
-The trailer is an optional keyword parameter that is an ellipsis (i.e. `"..."`) by default. The trailer can be a custom or empty string. The string length of the trailer is added to the length of the string being trimmed, so keep this in mind when setting length.
+The trailer is an optional keyword parameter that is an ellipsis by default. The trailer can be a custom or empty string. The string size of the trailer is added to the size of the string being trimmed, so keep this in mind when setting the maximum length.
 
 [source,ruby]
 ----
 demo = "It was the best of times"
-length = demo.length
+size = demo.size
 
 demo.trim_end 9                          # "It was..."
 demo.trim_end 12                         # "It was th..."
-demo.trim_end length                     # "It was the best of times"
-demo.trim_end Float::INFINITY            # "It was the best of times"
+demo.trim_end size                       # "It was the best of times"
 demo.trim_end 12, " "                    # "It was..."
 demo.trim_end 12, /\s/                   # "It was..."
 demo.trim_end 6, trailer: ""             # "It was"
@@ -1468,6 +1472,22 @@ demo.trim_end 16, trailer: "... (more)"  # "It was... (more)"
 "demo".trim_end 3                        # "..."
 ----
 
+===== #trim_middle
+
+Answers the trimmed middle of a string for maximum length with optional gap (default: ellipsis). The minimum length is always the size of the gap plus one character on each side of the gap.
+
+[source,ruby]
+----
+demo = "It was the best of times"
+size = demo.size
+
+demo.trim_middle 14                         # "It w...times"
+demo.trim_middle size                       # "It was the...t of times"
+"space".trim_middle 5                       # "s...e"
+demo.trim_middle 14, gap: "+"               # "It was+ times"
+demo.trim_middle 3                          # "It was the best of times"
+----
+
 ===== #truthy?
 
 Answers if string is truthy.
@@ -1633,7 +1653,6 @@ Enhances symbol-to-proc functionality by allowing you to send positional, keywor
 
 [source,ruby]
 ----
-
 %w[clue crow cow].map(&:tr.call("c", "b"))                              # ["blue", "brow", "bow"]
 [1.3, 1.5, 1.9].map(&:round.call(half: :up))                            # [1, 2, 2]
 [%w[a b c], %w[c a b]].map(&:index.call { |element| element == "b" })   # [1, 2]
@@ -1643,6 +1662,18 @@ Enhances symbol-to-proc functionality by allowing you to send positional, keywor
 
 ⚠️ Use of `#call` without any arguments should be avoided in order to not incur extra processing costs since the original symbol-to-proc call can be used instead.
 
+==== Time
+
+===== #rfc_3339
+
+Answers time, as a string, in RFC 3339 format.
+
+[source,ruby]
+----
+Time.now.rfc_3339      # "2026-01-24T08:56:55-07:00"
+Time.now.utc.rfc_3339  # "2026-01-24T15:57:13+00:00"
+----
+
 == Development
 
 To contribute, run:

data/lib/refinements/date_time.rb

@@ -6,7 +6,10 @@ module Refinements
   # Provides additional enhancements to the DateTime primitive.
   module DateTime
     refine ::DateTime.singleton_class do
-      def utc = now.new_offset(0)
+      def utc
+        warn "`DateTime.#{__method__}` is deprecated, use `Time` instead.", category: :deprecated
+        now.new_offset 0
+      end
     end
   end
 end

data/lib/refinements/pathname.rb

@@ -71,7 +71,7 @@ module Refinements
 
       def rewrite = read.then { |content| write yield(content) if block_given? }
 
-      def touch at = Time.now
+      def touch at = ::Time.now
         exist? ? utime(at, at) : write("")
         self
       end

data/lib/refinements/string.rb

@@ -52,7 +52,15 @@ module Refinements
                                            .then { |parts| combine parts, :down, "_" }
       end
 
-      def squish = gsub(/[[:space:]]+/, " ").tap(&:strip!)
+      def squish
+        duplicate = dup
+
+        # Find two or more spaces/tabs/newlines or a single space that isn't " ".
+        duplicate.gsub!(/([[:space:]]{2,}|[[[:space:]]&&[^ ]])/, " ")
+
+        duplicate.strip!
+        duplicate
+      end
 
       def titleize
         return capitalize unless match? DELIMITERS
@@ -62,12 +70,26 @@ module Refinements
                                               .then { |parts| combine parts, :up, "/" }
       end
 
-      def trim_end to, delimiter = nil, trailer: "..."
-        return dup if length <= to
+      def trim_end maximum, delimiter = nil, trailer: "..."
+        return dup if size <= maximum
+
+        offset = maximum - trailer.size
+        stop = delimiter ? rindex(delimiter, offset) || offset : offset
+        "#{self[...stop]}#{trailer}"
+      end
+
+      def trim_middle maximum, gap: "..."
+        gap_size = gap.size
+        minimum = gap_size + 2
+        limit = maximum - gap_size
+
+        return dup if maximum < minimum || maximum > size
+        return "#{first}#{gap}#{last}" if minimum == maximum
+
+        half = limit / 2
+        stop = half.odd? ? half - 1 : half
 
-        offset = to - trailer.length
-        maximum = delimiter ? rindex(delimiter, offset) || offset : offset
-        "#{self[...maximum]}#{trailer}"
+        "#{self[...stop]}#{gap}#{self[-half...]}"
       end
 
       def truthy? = %w[true yes on t y 1].include? downcase.strip

data/lib/refinements/time.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Refinements
+  # Provides additional enhancements to the Symbol primitive.
+  module Time
+    refine ::Time do
+      def rfc_3339 = strftime "%FT%T%:z"
+    end
+  end
+end

data/lib/refinements.rb

@@ -13,3 +13,4 @@ require "refinements/string"
 require "refinements/string_io"
 require "refinements/struct"
 require "refinements/symbol"
+require "refinements/time"

data/refinements.gemspec

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

data.tar.gz.sig

@@ -1,5 +1,2 @@
-?��ݍ}�
-^y VP6$.�_��@�)z
-w�p_4��̳��βg_�F8��~
-l�R�>C�wI،7	韌��柀x������<2�X��f:��~~d����D���~m8���#������WG��r?8�,7�!	�
�cO :��b&4���������)S����
-�8����yFLY!z��Zy9��{��6-�b}���������H�3��V��1cnr7~@S��Sy!
+A7g�"��^0��:~3Ef���7%��8�ڲ^�V��mB6�`K�{#*{��5"��tG���\�*��g��%���@w��$�!<~
+�W(��`�q�֊@�W��3l�;2��0��
\���V�hW_wOˡ-����p�����C�b,f��;$�ߏ"$w�[���Ц.k�Fg��'�R/ߤ�����a�>�8H�/������=��l<��'�E���U�N�W=�1_P�

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 14.1.0
+  version: 14.2.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -62,6 +62,7 @@ files:
 - lib/refinements/string_io.rb
 - lib/refinements/struct.rb
 - lib/refinements/symbol.rb
+- lib/refinements/time.rb
 - refinements.gemspec
 homepage: https://alchemists.io/projects/refinements
 licenses: