calcpace 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42ce231ceded47814ccd2f3a0e8ecb79d0e8572253533980a76e11a70afeb6f1
-  data.tar.gz: a2680a1f0607ef49d5178431b415cce7e0945a722ad3dbec8bb58b2c2a698131
+  metadata.gz: 76b9c7242a528134ed36832a7be8fc3e83ccb65fc7e139232d2987a78116498b
+  data.tar.gz: f87752c75360bfa9dca40ae93bfdeaafc1522f7592d9ba3ca236cd9fb1d63a56
 SHA512:
-  metadata.gz: 836dd745def09ebc585241308d56298b986693c075b4676e12b1d95e57d4847f05b979d41cf203491dedd4e1228561163782c7c14886e4c75a9fe7f577c70820
-  data.tar.gz: 672cb17a7a142cc6f693c8b3c6d3597223e3391f8d9cd3c6c552259a1eb1a377805bdaa26c95adb8e8e56d3b2acde94da66a8c125d0044c02fee3a11fd13174c
+  metadata.gz: 63421f8934eb0c94aa0713056fb6014ee7fa1ef7e1f611d16477ab3c84fb9235909b4f2e82e0e6e38a59d66ce801d109a76215ffbe08dddafd19523330327172
+  data.tar.gz: 9754c81c00f31f76e0250ebd0388dd7779cac95312513945364fc8f3efe914efd2f871c47afda9afbe442fdcc68d0c1eee3454348119bbd998f168c258af449c

data/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.13.0] - 2026-08-28
+
+### Added
+- `convert_to_clocktime(seconds, compact: true)` — the display format a runner
+  reads, next to the padded format the gem already returned
+  - drops the hour when it is zero and the leading zero of the most significant
+    component, keeping two digits on everything after it:
+    `convert_to_clocktime(292, compact: true)` #=> `'4:52'`,
+    `convert_to_clocktime(45, compact: true)` #=> `'0:45'`,
+    `convert_to_clocktime(5025, compact: true)` #=> `'1:23:45'`
+  - past 24 hours it keeps counting hours (`100_000` #=> `'27:46:40'`) instead
+    of the padded format's day prefix (`'1 03:46:40'`) — a day count brings back
+    the padding and the extra unit the compact format exists to strip
+  - fractional seconds truncate, as they already did in the padded format:
+    `292.9` #=> `'4:52'`
+
+  The default stays `compact: false`, byte-for-byte the previous output, so every
+  existing caller is unaffected.
+
+### Fixed
+- `convert_to_clocktime` with a negative number now raises
+  `Calcpace::NonPositiveInputError` instead of silently wrapping around
+  (`-5` used to return `'23:59:55'`, a `Time.at` artifact). Zero remains a valid
+  duration in both formats. Non-numeric input keeps raising as before.
+
+## [1.12.1] - 2026-08-15
+
+### Changed
+- Development dependency bumps: rubocop 1.89, rdoc 8.0, simplecov 1.1, erb 6.0.7.
+  No library code changes.
+
 ## [1.12.0] - 2026-08-01
 
 ### Added
@@ -294,7 +325,8 @@ predictors are untouched.
 
 See git history for changes in earlier versions.
 
-[Unreleased]: https://github.com/0jonjo/calcpace/compare/v1.12.0...HEAD
+[Unreleased]: https://github.com/0jonjo/calcpace/compare/v1.13.0...HEAD
+[1.13.0]: https://github.com/0jonjo/calcpace/compare/v1.12.1...v1.13.0
 [1.12.0]: https://github.com/0jonjo/calcpace/compare/v1.11.0...v1.12.0
 [1.11.0]: https://github.com/0jonjo/calcpace/compare/v1.10.0...v1.11.0
 [1.10.0]: https://github.com/0jonjo/calcpace/compare/v1.9.10...v1.10.0

data/Gemfile

@@ -5,6 +5,6 @@ source 'https://rubygems.org'
 gem 'minitest', '~> 6.0'
 gem 'rake', '~> 13.2'
 gem 'rake-compiler', '~> 1.0'
-gem 'rdoc', '~> 7.0'
+gem 'rdoc', '~> 8.0'
 gem 'rubocop', '~> 1.69'
-gem 'simplecov', '~> 0.22', require: false
+gem 'simplecov', '~> 1.1', require: false

data/Gemfile.lock

@@ -2,35 +2,36 @@ GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
-    date (3.5.1)
-    docile (1.4.1)
     drb (2.2.3)
-    erb (6.0.4)
-    json (2.19.9)
-    language_server-protocol (3.17.0.5)
+    erb (6.0.7)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
+    logger (1.7.0)
     minitest (6.0.6)
       drb (~> 2.0)
       prism (~> 1.5)
     parallel (2.1.0)
-    parser (3.3.11.1)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
-    psych (5.4.0)
-      date
-      stringio
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
     rake-compiler (1.3.1)
       rake
-    rdoc (7.2.0)
+    rbs (4.1.3)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rdoc (8.0.0)
       erb
-      psych (>= 4.0.0)
+      prism (>= 1.6.0)
+      rbs (>= 4.0.0)
       tsort
     regexp_parser (2.12.0)
-    rubocop (1.88.0)
+    rubocop (1.89.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -41,17 +42,11 @@ GEM
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     ruby-progressbar (1.13.0)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.13.2)
-    simplecov_json_formatter (0.1.4)
-    stringio (3.2.0)
+    simplecov (1.1.1)
     tsort (0.2.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
@@ -65,9 +60,9 @@ DEPENDENCIES
   minitest (~> 6.0)
   rake (~> 13.2)
   rake-compiler (~> 1.0)
-  rdoc (~> 7.0)
+  rdoc (~> 8.0)
   rubocop (~> 1.69)
-  simplecov (~> 0.22)
+  simplecov (~> 1.1)
 
 BUNDLED WITH
   4.0.6

data/README.md

@@ -367,6 +367,21 @@ calc.convert_to_clocktime(3600)      # => "01:00:00"
 calc.check_time('01:00:00')          # => nil (valid)
 ```
 
+`convert_to_clocktime` takes a `compact:` keyword for the format a runner reads
+on a screen — no zero hour, no leading zero on the most significant component:
+
+```ruby
+calc.convert_to_clocktime(292, compact: true)      # => "4:52"
+calc.convert_to_clocktime(45, compact: true)       # => "0:45"
+calc.convert_to_clocktime(5025, compact: true)     # => "1:23:45"
+calc.convert_to_clocktime(100_000, compact: true)  # => "27:46:40"
+```
+
+Past 24 hours the compact format keeps counting hours, where the padded one
+prefixes a day count (`"1 03:46:40"`). Fractional seconds truncate in both.
+A negative number of seconds raises `Calcpace::NonPositiveInputError`; zero is a
+valid duration (`"00:00:00"` / `"0:00"`).
+
 ---
 
 ### Errors

data/lib/calcpace/converter.rb

@@ -99,13 +99,38 @@ module Converter
 
   # Converts seconds to a clocktime string
   #
-  # @param seconds [Numeric] total seconds
-  # @return [String] time in HH:MM:SS format, or "D HH:MM:SS" for durations over 24 hours
+  # The default (padded) format is the machine-readable one: always HH:MM:SS,
+  # with a day prefix past 24 hours. The compact format is the one a runner
+  # reads on a screen — it drops a zero hour and the leading zero of the most
+  # significant component, keeping two digits on everything after it.
   #
-  # @example
+  # Fractional seconds are truncated, not rounded, in both formats, so a
+  # predictor returning 292.9 s prints the same 4:52 either way. Past 24 hours
+  # the compact format keeps counting hours ('27:46:40') instead of adding the
+  # padded format's day prefix: a day count reintroduces the very padding and
+  # the extra unit the compact format exists to strip, and ultra finish times
+  # are read as a running hour count.
+  #
+  # @param seconds [Numeric] total seconds, zero or more
+  # @param compact [Boolean] when true, return the compact display format
+  # @return [String] time in HH:MM:SS format, or "D HH:MM:SS" for durations over
+  #   24 hours; with compact: true, "M:SS" or "H:MM:SS"
+  # @raise [Calcpace::NonPositiveInputError] if seconds is negative
+  #
+  # @example padded (default)
   #   convert_to_clocktime(3600)    #=> '01:00:00' (1 hour)
+  #   convert_to_clocktime(292)     #=> '00:04:52'
   #   convert_to_clocktime(100000)  #=> '1 03:46:40' (1 day, 3 hours, 46 minutes, 40 seconds)
-  def convert_to_clocktime(seconds)
+  #
+  # @example compact
+  #   convert_to_clocktime(45, compact: true)      #=> '0:45'
+  #   convert_to_clocktime(292, compact: true)     #=> '4:52'
+  #   convert_to_clocktime(5025, compact: true)    #=> '1:23:45'
+  #   convert_to_clocktime(100000, compact: true)  #=> '27:46:40'
+  def convert_to_clocktime(seconds, compact: false)
+    check_not_negative(seconds)
+    return compact_clocktime(seconds) if compact
+
     days = (seconds / 86_400).to_i
     format = days.positive? ? "#{days} %H:%M:%S" : '%H:%M:%S'
     Time.at(seconds).utc.strftime(format)
@@ -149,6 +174,28 @@ module Converter
 
   private
 
+  # Formats a duration without padding the most significant component, dropping
+  # the hour when there is none. Hours accumulate past 24 rather than rolling
+  # over into a day count.
+  def compact_clocktime(seconds)
+    total = seconds.to_i
+    parts = { hours: total / 3600, minutes: (total % 3600) / 60, seconds: total % 60 }
+    return format('%<hours>d:%<minutes>02d:%<seconds>02d', parts) if parts[:hours].positive?
+
+    format('%<minutes>d:%<seconds>02d', parts)
+  end
+
+  # Guards against negative durations. Unlike Checker#check_positive, zero is a
+  # legitimate duration here — a zero split prints as 00:00:00 — so only a
+  # negative value is rejected. Non-numeric input is left to raise on its own,
+  # as it always has.
+  def check_not_negative(seconds)
+    return unless seconds.is_a?(Numeric) && seconds.negative?
+
+    raise Calcpace::NonPositiveInputError,
+          'Seconds must not be a negative number'
+  end
+
   # Guards the "race name + distance_unit" combination. A standard race already
   # carries its own distance, so the keyword can only be a caller mistake —
   # better to say so than to ignore it silently.

data/lib/calcpace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Calcpace
-  VERSION = '1.12.0'
+  VERSION = '1.13.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: calcpace
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - João Gilberto Saraiva