environment_helpers 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71bfb123e7f90d29f9e038849bc995207b9c11b166aae7e0938cf162e7ed70f5
-  data.tar.gz: bb88e8d31c0c343a54f7be6a6919af08446a2a9fff973868b9ba22a9f1fc3f9a
+  metadata.gz: c789efc6ec01f80dab6e39fcf2ae8c1941642b61751e8585ed4765e7679260c2
+  data.tar.gz: 29fab39b2237db66ef6d980880f606d4ec0ba4be4991ccb38a3aface1149d68f
 SHA512:
-  metadata.gz: f9adafc223d6c2edff2c4179bb86d172e2febe28d8761a2d55b9b76db02d6076ce981229cd8f758c905c4e4e524ad4b6b6e589ff55ced624fbc510ad8a183ed1
-  data.tar.gz: 7d6ae5d630de28a2d5db1776d06ed7d2a6117a905b66c12aa61b2b7fe5c4dd64dd8cd5e764c450fcf846b077ee23c7f74f6bd393d3cec8b161f6365a27cd498b
+  metadata.gz: 617d37082c5f021bbf1691332e4cade122014508394c8f6f3a8b6e80e20847a57d41793a1fbb99ff3f9ca15bfd5f86666ff8b72883643681f72341757f88043e
+  data.tar.gz: 040fc4d6d63f5306c96bdf39fd4814608912c23063b9ced4f101b9250c39cbbf0ebf93626e47d41813e8872bebc946dfcbd54d4003fcf994b711ba820c201672

data/README.md

@@ -38,6 +38,7 @@ ENV.integer_range("ID_RANGE", default: (500..6000))
 ENV.integer("MAX_THREAD_COUNT", default: 5)
 ENV.file_path("FILE_PATH", default: "/some/path", required: true)
 ENV.date("SCHEDULED_DATE", required: true, format: "%Y-%m-%d")
+ENV.date_time("RUN_AT", required: true, default: DateTime.now)
 ```
 
 Each of the supplied methods takes a positional parameter for the name of the environment variable,
@@ -64,3 +65,8 @@ The available methods added to `ENV`:
   which would parse a date like `2023-12-25`. It will handle invalid values (or format strings) like
   the variable not being present, though if it's specified as `required`, you will see a different
   exception in each case.
+* `date_time` - produces a `DateTime` object, using either `DateTime.strptime` or `DateTime.iso8601`.
+  The default format is `:iso8601`, and `:unix` is also an allowed 'format'. But if it is supplied
+  as a _string_, it will be handled as a strptime format string (the `:unix` format is equivalent to
+  the format string `"%s"`). It handles invalid or unparseable values like `ENV.date` does, in that
+  they are treated as if not supplied.

data/lib/environment_helpers/datetime_helpers.rb

@@ -12,6 +12,16 @@ module EnvironmentHelpers
       fail(InvalidDateText, "Required date environment variable #{name} had inappropriate content '#{text}'")
     end
 
+    def date_time(name, format: :iso8601, default: nil, required: false)
+      check_default_type(:date_time, default, DateTime)
+      text = fetch_value(name, required: required)
+      dt = parse_date_time_from(text, format: format)
+
+      return dt if dt
+      return default unless required
+      fail(InvalidDateTimeText, "Require date_time environment variable #{name} had inappropriate content '#{text}'")
+    end
+
     private
 
     def parse_date_from(text, format:)
@@ -20,5 +30,37 @@ module EnvironmentHelpers
     rescue ArgumentError
       nil
     end
+
+    def parse_date_time_from(text, format:)
+      if text.nil?
+        nil
+      elsif format == :iso8601
+        iso8601_date_time(text)
+      elsif format == :unix
+        unix_date_time(text)
+      elsif format.is_a?(String)
+        strptime_date_time(text, format: format)
+      else
+        fail(BadFormat, "ENV.date_time requires either a strptime format string, :unix, or :iso8601")
+      end
+    end
+
+    def iso8601_date_time(text)
+      DateTime.iso8601(text)
+    rescue
+      nil
+    end
+
+    def unix_date_time(text)
+      DateTime.strptime(text, "%s")
+    rescue
+      nil
+    end
+
+    def strptime_date_time(text, format:)
+      DateTime.strptime(text, format)
+    rescue
+      nil
+    end
   end
 end

data/lib/environment_helpers/version.rb

@@ -1,3 +1,3 @@
 module EnvironmentHelpers
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/lib/environment_helpers.rb

@@ -14,12 +14,14 @@ module EnvironmentHelpers
   Error = Class.new(::StandardError)
   MissingVariableError = Class.new(Error)
   BadDefault = Class.new(Error)
+  BadFormat = Class.new(Error)
 
   InvalidValue = Class.new(Error)
   InvalidBooleanText = Class.new(InvalidValue)
   InvalidRangeText = Class.new(InvalidValue)
   InvalidIntegerText = Class.new(InvalidValue)
   InvalidDateText = Class.new(InvalidValue)
+  InvalidDateTimeText = Class.new(InvalidValue)
 
   include AccessHelpers
   include StringHelpers

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: environment_helpers
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Eric Mueller
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-28 00:00:00.000000000 Z
+date: 2023-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -128,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: A set of convenience methods for accessing environment data