environment_helpers 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab82696a30367d94de8f033006be9fc63883b3d300075f97e73513e62427e0bf
-  data.tar.gz: 0bef7e80bc554b195be934e2fecc70908756e9951ad2db1805445ff20a7297c6
+  metadata.gz: 202ea78421b65c63b2d3151a55ddfc891aab67569d67dceba358939f0b89fcd7
+  data.tar.gz: 82344f0d77473dd80a467a915c33d5897ae763eaa8d9faa18e81b9b9c99e9774
 SHA512:
-  metadata.gz: b693dd3fe48277cd352cfd30d5f455fe1b14dbaf4b692f5fe603b00b83e5d621c7d6f6680b12a413da44155b268da42e365115373ba491eb4a646639445373b1
-  data.tar.gz: 902d55c02d71b6b7211fb8bbe76f2d6a7c805857491c170d214794ee8b9919df877d3903f0649f42a60546e168acb0de22828d106bb5a51874993320a7d54c2b
+  metadata.gz: f7b0d5146de039a774301fb24266f4d2cdb467e095e0915121771b543aed10782c88e80f5c9c24e234b6cf9821e76637232f7220812061774599ec03b0f500b9
+  data.tar.gz: 3aa3c4435e7e7a9ebf83d1fbf9277e55a7fb12be6280119045ab2dbaf80f20715116a357f09dca9884a57772c889890defa509df7cf2a551ee3ecf8f8f8cbe9a

data/README.md

@@ -34,6 +34,7 @@ methods onto `ENV` for your use.
 ENV.string("APP_NAME", default: "local")
 ENV.symbol("BUSINESS_DOMAIN", default: :engineering, required: true)
 ENV.boolean("ENABLE_FEATURE_FOO", default: false)
+ENV.integer_range("ID_RANGE", default: (500..6000))
 ENV.integer("MAX_THREAD_COUNT", default: 5)
 ENV.date("SCHEDULED_DATE", required: true, format: "%Y-%m-%d")
 ```
@@ -51,6 +52,8 @@ The available methods added to `ENV`:
   a fair variety of strings to map onto those boolean value, though you should probably just use
   "true" and "false" really. If you specify `required: true` and get a value like "maybe?", it'll
   raise an `EnvironmentHelpers::InvalidBooleanText` exception.
+* `integer_range` - produces an integer Range object. It accepts `N-N`, `N..N`, or `N...N`, (the
+  latter means 'excluding the upper bound, as in ruby).
 * `integer` - produces an integer from the environment variable, by calling `to_i` on it (if it's
   present). Note that this means that providing a value like "hello" means you'll get `0`, since
   that's what ruby does when you call `"hello".to_i`.

data/environment_helpers.gemspec

@@ -28,9 +28,9 @@ Gem::Specification.new do |spec|
   spec.executables = []
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "rspec", ">= 3.10"
-  spec.add_development_dependency "simplecov"
-  spec.add_development_dependency "pry"
-  spec.add_development_dependency "standard"
-  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rspec", "~> 3.10"
+  spec.add_development_dependency "simplecov", "~> 0.22.0"
+  spec.add_development_dependency "pry", "~> 0.14"
+  spec.add_development_dependency "standard", "~> 1.28"
+  spec.add_development_dependency "rubocop", "~> 1.50"
 end

data/lib/environment_helpers/range_helpers.rb

@@ -0,0 +1,42 @@
+module EnvironmentHelpers
+  module RangeHelpers
+    def integer_range(name, default: nil, required: false)
+      check_default_type(:integer_range, default, Range)
+      check_range_endpoint(:integer_range, default.begin) if default
+      check_range_endpoint(:integer_range, default.end) if default
+
+      text = fetch_value(name, required: required)
+      range = parse_range_from(text)
+      return range if range
+      return default unless required
+      fail(InvalidRangeText, "Required Integer Range environment variable #{name} had inappropriate content '#{text}'")
+    end
+
+    private
+
+    def check_range_endpoint(context, value)
+      return if value.is_a?(Integer)
+      fail(BadDefault, "Invalid endpoint for default range of #{context} - must be Integer")
+    end
+
+    def parse_range_bound_from(text)
+      return nil if text.nil?
+      return nil if text.empty?
+      text.to_i
+    end
+
+    def parse_range_from(text)
+      text =~ /\A(\d*)(-|\.\.|\.\.\.)(\d*)\z/
+      lower_bound = parse_range_bound_from($1)
+      separator = $2
+      upper_bound = parse_range_bound_from($3)
+
+      return nil if lower_bound.nil? || upper_bound.nil?
+      if separator == "..."
+        (lower_bound...upper_bound)
+      else
+        (lower_bound..upper_bound)
+      end
+    end
+  end
+end

data/lib/environment_helpers/version.rb

@@ -1,3 +1,3 @@
 module EnvironmentHelpers
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/environment_helpers.rb

@@ -1,6 +1,7 @@
 require_relative "./environment_helpers/access_helpers"
 require_relative "./environment_helpers/string_helpers"
 require_relative "./environment_helpers/boolean_helpers"
+require_relative "./environment_helpers/range_helpers"
 require_relative "./environment_helpers/numeric_helpers"
 require_relative "./environment_helpers/datetime_helpers"
 
@@ -11,12 +12,14 @@ module EnvironmentHelpers
 
   InvalidValue = Class.new(Error)
   InvalidBooleanText = Class.new(InvalidValue)
+  InvalidRangeText = Class.new(InvalidValue)
   InvalidIntegerText = Class.new(InvalidValue)
   InvalidDateText = Class.new(InvalidValue)
 
   include AccessHelpers
   include StringHelpers
   include BooleanHelpers
+  include RangeHelpers
   include NumericHelpers
   include DatetimeHelpers
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: environment_helpers
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Eric Mueller
@@ -14,72 +14,72 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.10'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.22.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.22.0
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.28'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.28'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.50'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.50'
 description: |
   Convenience helpers for more simply accessing data passed to applications through the
   environment that may have types and/or defaults
@@ -103,6 +103,7 @@ files:
 - lib/environment_helpers/boolean_helpers.rb
 - lib/environment_helpers/datetime_helpers.rb
 - lib/environment_helpers/numeric_helpers.rb
+- lib/environment_helpers/range_helpers.rb
 - lib/environment_helpers/string_helpers.rb
 - lib/environment_helpers/version.rb
 homepage: https://github.com/nevinera/environment_helpers