ruby-rails-extensions 2.1.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3445f7f15fe0a736b52ccbaa2f176fd017b2b5fe0b58e42115a9a4d003599b32
-  data.tar.gz: 66ea1200362e7c25c1cb88496ac0273ba960a4ed3ed24d6ab8027fe867b0e014
+  metadata.gz: a7bd4a821e87ee1a9683247bfd699e1e95ce101a09e864be821f829cb72fd9f8
+  data.tar.gz: 0eb83cf0df52e2134930577cae1006071fdbfea14e83e0bace927eb77c531bf2
 SHA512:
-  metadata.gz: 15599ad4fc3f8a9d17fa9d3ceefca301d91a257fc79763cd29a46ef52664278a8e947b4bd717b33f54fe3434a67c45c2debfaba209717bc808c4b1c4242660a6
-  data.tar.gz: 8a01c3eae7ecd21bc27fcfe34302a2dd33946e5b213037e4b41ce29a3c03241e2a17f058f1967b474485ef36617ccba5d01088b540487b13d4bafc8201c6c1d0
+  metadata.gz: 5c8d9cd934041ee7dd40746beb4c8ba06fa9f7012e874370de548d238f23bbd5978cea9e66deba458118451b84e7b79f509fa9d56cb38c2d2895200e77755b69
+  data.tar.gz: 8c9d3eff37ed8db19f5328f5a21360e5059c1128df87e84ec76aeca3be815153395b8c635a0fb0c8529160e9e9a1bd6ad220157e834d144fd0d14d9a5565b0d3

data/CHANGELOG.md

@@ -1,7 +1,12 @@
 Unreleased Changes
 ------------------
 
-2.1.0 (Unreleased)
+2.1.1 (2024-10-11)
+------------------
+
+* Fix bad `2.1.0` publish
+
+2.1.0 (2024-10-11)
 ------------------
 
 * Modules added:
@@ -19,6 +24,7 @@ Unreleased Changes
   * `Time#quarter_str` and `DateTime#quarter_str`
   * `String#to_new_date`, `String#to_new_date_safe`, and `String#to_new_date_mm_yy`
   * `String#cutoff`
+  * `String#to_new_time`
 * Other changes:
   * Initial test framework added
   * Initial benchmark framework added

data/lib/ruby-rails-extensions/extensions/to_new_time.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module StringToNewTime
+  NEW_TIME_REGEXES = {
+    # Supports: 9:00am, 12:15 pm, 10:12am
+    hh_mm_p: /^(1[0-2]|0?[1-9]).([0-5]?[0-9])(.?[AaPp][Mm])?$/i,
+    # Supports: 16:0, 23:23, 01:00
+    hh_mm: /^(2[0-3]|[01]?[0-9]):([0-5]?[0-9])$/i,
+    # Supports: 1p, 12a, 5a, 9p
+    h_p: /^[0-1][0-9]?(.?[AaPp][Mm]?)?$/i
+  }.freeze
+
+  # Converts a string to a date object when following one of the
+  # following patterns (no space delimiters):
+  #   - HH:MM AM/PM
+  #   - HH:MM (24 hour)
+  #   - HH AM/PM
+  #
+  # @param options [Hash]
+  #
+  # @option options [Integer] :year Year to use as the base time object.
+  #   This will default to today's year.
+  #
+  # @option options [Integer] :month Month to use as the base time object.
+  #   This will default to today's month.
+  #
+  # @option options [Integer] :day Day to use as the base time object.
+  #   This will default to today's day.
+  #
+  # @return [Date, String, nil]
+  #
+  def to_new_time(options = {})
+    opts = options || {}
+    today = Date.today
+    year = opts.fetch(:year, today.year)
+    month = opts.fetch(:month, today.month)
+    day = opts.fetch(:day, today.day)
+    parts = extract_time
+
+    Time.use_zone(RubyRailsExtensions.configuration.default_time_zone || 'Eastern Time (US & Canada)') do
+      # Use {Time#parse} as there is no `Time.zone.new` method
+      Time.zone.parse("#{year}-#{month}-#{day} #{parts[:hour]}:#{parts[:minute]} #{parts[:ampm]}")
+    end
+  end
+
+  private
+
+    # Checks the string for any supported format,
+    # then converts the string time parts.
+    #
+    # @return [Hash, nil]
+    #
+    def extract_time
+      key = NEW_TIME_REGEXES.find { |_key, value| match?(value) }&.first
+
+      return if key.nil?
+
+      __send__(:"#{key}_time")
+    end
+
+    # @return [Hash]
+    def hh_mm_p_time
+      parts = scan(NEW_TIME_REGEXES[:hh_mm_p])
+
+      parts.flatten!
+
+      parts.map!(&:strip)
+
+      hour, min, ampm = parts
+
+      {
+        hour: hour,
+        minute: min,
+        second: 0,
+        ampm: ampm
+      }
+    end
+
+    # @return [Hash]
+    def hh_mm_time
+      parts = scan(NEW_TIME_REGEXES[:hh_mm])
+
+      parts.flatten!
+
+      parts.map!(&:strip)
+
+      hour, min = parts
+
+      {
+        hour: hour,
+        minute: min,
+        second: 0,
+        ampm: nil
+      }
+    end
+
+    # @return [Hash]
+    def h_p_time
+      {
+        hour: gsub(/[apm]/i, ''),
+        minute: 0,
+        second: 0,
+        ampm: match?(/a/i) ? 'am' : 'pm'
+      }
+    end
+end
+
+String.class_eval do
+  include StringToNewTime
+end

data/lib/ruby-rails-extensions/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyRailsExtensions
-  VERSION = '2.1.0'
+  VERSION = '2.1.1'
 end

data/lib/ruby-rails-extensions.rb

@@ -63,6 +63,7 @@ module RubyRailsExtensions
       to_money
       to_negative_i
       to_new_date
+      to_new_time
       to_nonzero_i
       to_or_sentence
       to_percentage

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-rails-extensions
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Brands Insurance
@@ -77,6 +77,7 @@ files:
 - lib/ruby-rails-extensions/extensions/to_money.rb
 - lib/ruby-rails-extensions/extensions/to_negative_i.rb
 - lib/ruby-rails-extensions/extensions/to_new_date.rb
+- lib/ruby-rails-extensions/extensions/to_new_time.rb
 - lib/ruby-rails-extensions/extensions/to_nonzero_i.rb
 - lib/ruby-rails-extensions/extensions/to_or_sentence.rb
 - lib/ruby-rails-extensions/extensions/to_percentage.rb