l43_time 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5e4bda3b58d2b640b5a2314a056f1e3080f8ae1282c410900b1ba9b1f5af459
-  data.tar.gz: 2be473abf597a07b7212a17998d13065924bf34e8783e8071cf59575187b36a4
+  metadata.gz: a51d17ccbe9e3c6392c3a7739c2745d79e4b7e05791b53f63de5e7d2135ca984
+  data.tar.gz: 29ba80c388b3b6473d60bd513233fe77a064d91dce9db76ae7405b11f5e145ff
 SHA512:
-  metadata.gz: dcebf38e4b55d2ac034d11a68334cf7da16f64d5cc6ae4f12699b3bf4602a34d430d9bf6c7792c5e860fd2b7fd7ceff3b7f12ad56450dc26782de4e6c6c79d4e
-  data.tar.gz: 2c2de6d072b43a1cfc79bfcbe39c38b64a5003abcf72d914f0be3b4053d7bdd4e55a12fa8bb903dee978ff7bfe614ace5b447c1fd7fbc18c64bf91697b8db3cc
+  metadata.gz: 70f0beb33e0a6620f2d70ae1b68841c432df7adfd1a07f1b70da973e62b989629136971de49272abaee031addcfd26e9c06c63fb42fb2c1995c539623a5402e3
+  data.tar.gz: 63025a68db8b283b83eb257268f13ba1c7f12015c70b81ab95e069236ff497928c00229454b4fc9935a7aa912d825f9c94d629e1c6d1adfd2f7547405050a486

data/lib/l43/time/parser.rb

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 
+
 require_relative 'consts'
 require_relative 'errors'
-require_relative 'tools/scanner'
 require_relative 'ts'
 
+require 'l43/time/tools/format_ts'
+require 'l43/time/tools/scanner'
+
 module L43
   module Time
     module Parser
@@ -20,6 +23,12 @@ module L43
           (?<value>[[:digit:]]+ (?:\.[[:digit:]]+)?) [[:space:]]* (?<unit>[[:lower:]]+)
         }x
 
+        #
+
+        def format_ts(ts, **opts) = Tools::FormatTs.format_ts(ts, **opts)
+
+        def format_ts!(ts, **opts) = Tools::FormatTs.format_ts!(ts, **opts)
+
         def parse_duration!(str)
           case parse_duration(str)
           in :ok, value

data/lib/l43/time/tools/format_ts.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'l43/core/result'
+require 'l43/open_object'
+
+module L43
+  module Time
+    module Tools
+      module FormatTs extend self
+        include Core
+        class Options
+          extend OpenObject
+          attributes decs: 1, 
+            dec_seps: /[.,]/,
+            decimal_point: '.',
+            fill: true,
+            joiner: ':',
+            seps: /[-:]/,
+            suppress_leading_zeroes: false,
+            timestamp: nil
+        end
+
+        def format_ts(ts, **opts)
+          options = Options.new(timestamp: ts, **opts)
+          ts = ts.strip
+          case split_parts(ts, options:)
+          in :ok, parts
+            format_parts(parts, options:)
+          in error
+            error
+          end
+        end
+
+        def format_ts!(ts, **opts)
+          case format_ts(ts, **opts)
+          in :ok, value
+            value
+          in :error, message
+            raise BadFormat, message
+          end
+        end
+
+
+        private
+        def check_parts(hs, ms, secs, frac, options)
+          culprit = ""
+          int_values = [ 
+            [hs, "hours"], [ms, "minutes"], [secs, "seconds"], [frac, "second's decimal part"]]
+            .map do |value, name|
+              culprit = name
+              Integer(value)
+            end
+          check_range(*int_values, options:)
+        rescue ArgumentError => ae
+          if ae.message.start_with?("invalid value for Integer():")
+            return error_result("invalid integer in #{culprit}", options:)
+          end
+          raise
+        end
+
+        MAX_ALLOWED_FOR_M_OR_S = 59
+        def check_range(hs, ms, secs, frac, options:)
+          return error_result("minutes > #{MAX_ALLOWED_FOR_M_OR_S}", options:) if ms > MAX_ALLOWED_FOR_M_OR_S
+          return error_result("seconds > #{MAX_ALLOWED_FOR_M_OR_S}", options:) if secs > MAX_ALLOWED_FOR_M_OR_S
+
+          Result.ok([hs, ms, secs, frac])
+        end
+
+        def convert_and_decimals(parts, options:)
+          parts => *hms, secs
+          case secs.split(options.dec_seps)
+          in [_]
+            check_parts(*hms, secs, 0, options)
+          in [s, frac]
+            check_parts(*hms, s, frac, options)
+          else
+            error_result("too many decimal points in seconds part", options:)
+          end
+        end
+
+        def error_result(message, options:) = Result.error("#{message} in timestamp: #{options.timestamp.inspect}")
+
+        def format_parts(parts, options:)
+          parts =
+            parts.drop_while(&:zero?) if options.suppress_leading_zeroes
+          parts => *parts, frac
+          parts = parts.map { format("%02d", it) } if options.fill
+          parts => *parts, seconds
+
+          seconds = seconds.to_s + options.decimal_point + frac.to_s[0...options.decs]
+          Result.ok([*parts, seconds].join(options.joiner))
+        end
+
+        def split_parts(ts, options:)
+          return error_result("empty timestamp", options:) if ts.empty?
+
+          parts = 
+            case ts.split(options.seps)
+            in [secs]
+              [0, 0, secs]
+            in [mins, secs]
+              [0, mins, secs]
+            in [_, _, _] => tripple
+              tripple
+            else
+              return error_result("too many parts", options:)
+            end
+
+          convert_and_decimals(parts, options:)
+        end
+
+      end
+    end
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/time/version.rb

@@ -2,7 +2,7 @@
 
 module L43
   module Time
-    VERSION = '0.1.6'
+    VERSION = '0.1.7'
   end
 end
 # SPDX-License-Identifier: AGPL-3.0-or-later

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: l43_time
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Robert Dober
 bindir: bin
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ostruct
@@ -37,6 +37,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: l43_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+- !ruby/object:Gem::Dependency
+  name: l43_open_object
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.9
 description: 'Time related tools
 
   '
@@ -56,6 +84,7 @@ files:
 - lib/l43/time/range.rb
 - lib/l43/time/time_range.rb
 - lib/l43/time/to_time.rb
+- lib/l43/time/tools/format_ts.rb
 - lib/l43/time/tools/map_ok.rb
 - lib/l43/time/tools/scanner.rb
 - lib/l43/time/ts.rb
@@ -78,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Time related tools
 test_files: []