l43_time 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1db35c0f9b6010c5bd1a6b3085ad15af47090f623fda05a56aabe349e6cf859
-  data.tar.gz: 850d40ccfb5a005844904c228237c1d856895ced30848ac4a65ab150fa40725f
+  metadata.gz: bb8d0086d7b02dcaa7bd6c24b9e5980ac2cb6d0875683afc1d61113da767e123
+  data.tar.gz: 20062fa91fa9d8041febf75bfb4086697eb30de0a68bc722a86418873d1eb18e
 SHA512:
-  metadata.gz: 81b6aab4c32bc2ac243870108203f352bd63ee1a36c2676b6798cb496bb098ccbbd3ad88cb1cfec04f38ad158d98f33fde522346b3b1c5f592ee92c926be7623
-  data.tar.gz: a98f913efa68696359b5866403c6aaa5a50f6dbf4bed4074c1f3179d2095e2981659bac2a90343aa1d749327db53c64b74ef5d2bd356403a1cd84eb4720a6571
+  metadata.gz: 050bc006c6ba584d0a6fb392faee971b5eee4f93f4f530ff3a0cabede66ff9928747f84ac6cbb083cdd94873a50f9173dd2ecb0ab03e0ff6404775528a9c9d79
+  data.tar.gz: 8146d8dfaff9b339daab0247166db7a7dcd11bb11e925b3518e1cf0478192a2f1a73adb7f6ea31e1bb825e9a016562af8dea44a258abf0c801ec76af5de01556

data/bin/help_str_to_time

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'l43/color/output'
+require_relative '../lib/l43/time/to_time'
+
+include L43::Color::Output
+putc(:bold, "Syntax of ", :cyan, "L43::Time::ToTime.str_to_time") 
+putc("")
+putc(L43::Time::ToTime.help_str_to_time(indent: 1))
+
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/time/to_time.rb

@@ -26,6 +26,25 @@ module L43
         end
       end
 
+      def help_str_to_time(indent: 3, name_col: :blue, val_col: [:bold, :magenta])
+        [
+          [:bold, "the following formats of the parameter to ", name_col, "str_to_time", :reset, :bold,
+           " are translated as follows to ", name_col, "Time ", :reset, :bold, "objects", :reset, nil],
+           [1, :bold, "Absolute dates", :reset],
+           [2, "14 digits", :dim, " to YYYYMMDDhhmmss"],
+           [2, "12 digits", :dim, " to YYMMDDhhmmss"],
+           [2, "6 digits", :dim, " to YYMMDD000000"],
+           [2, "4 digits", :dim, " to MMDD000000"],
+           [2, "2 digits", :dim, " to DD000000"],
+           [2, val_col, "'today'", :reset, :dim, " to midnight of current date"],
+           [2, val_col, "'yesterday'|'yd'", :reset, :dim, " to midnight of yesterday"],
+           "",
+           [1, :bold, "Relative times"],
+           [2, val_col, "'-3d2h40s'", :reset, :dim, " 3 days 2 hours and 40 seconds before now"],
+           [2, val_col, "'10m4s'", :reset, :dim, " 10 minuyes 4 seconds after now"],
+        ].map { [indent, *it, :reset, nil] }
+      end
+
       private
       def parse_symbolic_or_duration(str)
         case symbolic_time(str)

data/lib/l43/time/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: l43_time
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Robert Dober
@@ -37,14 +37,30 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.5
+- !ruby/object:Gem::Dependency
+  name: l43_color
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
 description: 'Time related tools
 
   '
 email: robert.dober@gmail.com
-executables: []
+executables:
+- help_str_to_time
 extensions: []
 extra_rdoc_files: []
 files:
+- bin/help_str_to_time
 - lib/l43/time.rb
 - lib/l43/time/consts.rb
 - lib/l43/time/delta.rb