tins 1.59.0 → 1.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7843ec2310ee0b79ceccdfab9e4f1ad6269ffab2735ba0fbac09cad7d931df43
-  data.tar.gz: 577d7f162cf3838f33afe119d847fdfd23b748f6807bf0c54aad592e6121b3ec
+  metadata.gz: c17298f1ee629a9226613814a7590bf107ab45e978cedf938407dd3160d1174a
+  data.tar.gz: b0246606c5dee0de323b62f91623a5d8f3b37f7da486c800e0fbef87a5a538a5
 SHA512:
-  metadata.gz: 44ccfe0501987243c4fb871055ef1af9083079e4d7a676e56eb389100f3b6a8fcffbd0cfa05b7be495a829d930d840c32c69faa50b3c0dc81af4ea3de9f5f418
-  data.tar.gz: 942ea6999ec5d3ed20dada3e6d5395fd68d0ab38f6c11723c05071522f92c756caeadc44b91a018a990e29184896f71b4d4dcf85795c5057c49e71d37eb0a564
+  metadata.gz: a24706b341766327830215b3ccb48cc498087e7559c1b230757e363cf2db9797737bf32d05e91e05a9eabda331918131e758ea899985865162ea5c65ba308e13
+  data.tar.gz: d55dea1d7ad3db342c8e60097bf716f8f74937f340c63ac76fc1bd6cbeb516ffd853e5cee7ad674b16143f318b36d424f4cd4345f02b71a6689aee8756733197

data/CHANGES.md

@@ -1,5 +1,18 @@
 # Changes
 
+## 2026-10-02 v1.60.0
+
+* Add unpadded `%H`, `%M`, and `%u` format directives to `Duration#format` for
+  unpadded hours, minutes, and seconds, complementing the existing zero-padded
+  `%h`, `%m`, and `%s`
+* Update the directive regex in `format` from `/%[DdhmSs%]/` to
+  `/%[DdHhMmuSs%]/` to match the new directives
+* Extend YARD documentation with an `@example` block demonstrating unpadded
+  components in a natural-language template
+* Add `test_format_unpadded_directives` covering all three new directives in
+  both template and standalone usage
+* Fix `assert_equal` argument order in `test_parse_percentage`
+
 ## 2026-09-25 v1.59.0
 
 * Add `*sels` and `&block` parameters to `squeeze` and `squeeze!`, allowing

data/lib/tins/duration.rb

@@ -161,8 +161,11 @@ module Tins
     # The template string supports the following directives:
     # - `%S` - Sign indicator (negative sign if duration is negative)
     # - `%d` - Days component
+    # - `%H` - Hours component (unpadded)
     # - `%h` - Hours component (zero-padded to 2 digits)
+    # - `%M` - Minutes component (unpadded)
     # - `%m` - Minutes component (zero-padded to 2 digits)
+    # - `%u` - Seconds component (unpadded)
     # - `%s` - Seconds component (zero-padded to 2 digits)
     # - `%f` - Fractional seconds component (without the leading decimal point)
     # - `%D` - Smart format (automatically includes days, fractional seconds, and sign)
@@ -186,13 +189,21 @@ module Tins
     #
     # @example Custom precision
     #   duration.format('%s.%f', precision: 2) # => "04.12"
+    #
+    # @example Unpadded components
+    #   duration = Tins::Duration.new(93_784)
+    #   duration.format('%d day(s), %H hours, %M minutes, and %u seconds')
+    #   # => "1 day(s), 2 hours, 3 minutes, and 4 seconds"
     def format(template = '%S%d+%h:%m:%s.%f', precision: nil)
-      result = template.gsub(/%[DdhmSs%]/) { |directive|
+      result = template.gsub(/%[DdHhMmuSs%]/) { |directive|
         case directive
         when '%S' then ?- if negative?
         when '%d' then @days
+        when '%H' then '%u' % @hours
         when '%h' then '%02u' % @hours
+        when '%M' then '%u' % @minutes
         when '%m' then '%02u' % @minutes
+        when '%u' then '%u' % @seconds
         when '%s' then '%02u' % @seconds
         when '%D' then format_smart
         when '%%' then '%'

data/lib/tins/version.rb

@@ -1,6 +1,6 @@
 module Tins
   # Tins version
-  VERSION         = '1.59.0'
+  VERSION         = '1.60.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/tests/duration_test.rb

@@ -96,7 +96,18 @@ module Tins
     def test_parse_percentage
       duration_string = '1%2'
       seconds = Tins::Duration.parse(duration_string, template: '%h%%%m')
-      assert_equal seconds, 3720
+      assert_equal 3720, seconds
+    end
+
+    def test_format_unpadded_directives
+      d = Tins::Duration.new(93_784) # 1d 2h 3m 4s
+      assert_equal(
+        '1 day(s), 2 hours, 3 minutes, and 4 seconds',
+        d.format('%d day(s), %H hours, %M minutes, and %u seconds')
+      )
+      assert_equal '2', d.format('%H')
+      assert_equal '3', d.format('%M')
+      assert_equal '4', d.format('%u')
     end
   end
 end

data/tins.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: tins 1.59.0 ruby lib
+# stub: tins 1.60.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "tins".freeze
-  s.version = "1.59.0".freeze
+  s.version = "1.60.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tins
 version: !ruby/object:Gem::Version
-  version: 1.59.0
+  version: 1.60.0
 platform: ruby
 authors:
 - Florian Frank