environment_helpers 1.5.0 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e1df5aabc663c1ed5969c56db3d1be35f6b329272718ce174b30260f4c2f1e8
-  data.tar.gz: 855f2cf510c568464310ef1bc30fb6115a6dff653618f25472a452fcf901cb77
+  metadata.gz: d1bd91d77fcc6e3a42c4c5a8c1fec17a9d6829b974b7377616bced1ef0cf7cfc
+  data.tar.gz: 828a4cfd5dec907ca7f8e694c7d30f963b9679a96bf063a0bcad29a607094f3f
 SHA512:
-  metadata.gz: 2dcccd3be2e778d76ce595521efc58204b680acfbe3328c86e357946574c338e323ee7a4e479e39d768f97a67fb6ecb7bb2c7aad7c68db7ed2d6f30bd761f299
-  data.tar.gz: 6a9bccc3864329bf295f59c268d64bed2078d072f9eed08ce2ff3063ead716f2e3e5a14b333f710b01b6092ec3be595bb71e74548c83515f230dfb9306e51bd7
+  metadata.gz: 71ec962fc48bb0780795ed5a5c1abc8829595ed810489721f6d94fd3f5c049a5efe79cf82f872422595e8179e2b2fb4c1e98bdf8d95bbfc067d41547b4193b1d
+  data.tar.gz: 2aa867aa7de1c8a35bb866123b99c6e9163b7159d0738c3c30ff45938d351ffaccea1e41b1782412c225ec42a87f4ad5d4c87d9bc0a3856e9b8106478c7e9bbe

data/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_WITHOUT: "typing"

data/.github/workflows/quality.yml

@@ -6,6 +6,8 @@ permissions: write-all
 jobs:
   check:
     runs-on: ubuntu-latest
+    env:
+      BUNDLE_GEMFILE: Gemfile.ruby3.3
     steps:
       - uses: actions/checkout@v4
         with:
@@ -18,12 +20,8 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.2
-
-      - name: Install gems
-        run: bundle install --jobs 4 --retry 3
+          ruby-version: 3.3
+          bundler-cache: true
 
       - name: Run QuietQuality
-        run: |
-          gem install quiet_quality standard rubocop
-          qq -C .quiet_quality.ci-cd.yml
+        run: bundle exec qq -C .quiet_quality.ci-cd.yml

data/.github/workflows/rspec.yml

@@ -8,9 +8,10 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby-version: ['2.7', '3.0', '3.1', '3.2', 'head']
+        ruby-version: ['2.7', '3.0', '3.1', '3.2', '3.3']
     env:
-      NO_STEEP: "Because we need to test on versions that are older than steep supports"
+      SIMPLECOV: "enabled"
+      BUNDLE_GEMFILE: Gemfile.ruby${{ matrix.ruby-version }}
 
     steps:
       - uses: actions/checkout@v4
@@ -19,17 +20,7 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
-
-      - name: Cache gems
-        uses: actions/cache@v3
-        with:
-          path: vendor/bundle
-          key: ${{ runner.os }}-rspec-${{ matrix.ruby-version }}-${{ hashFiles('Gemfile.lock') }}
-          restore-keys:
-            ${{ runner.os }}-rspec-${{ matrix.ruby-version }}-
-
-      - name: Install gems
-        run: bundle install --jobs 4 --retry 3
+          bundler-cache: true
 
       - name: Run RSpec
         run: bundle exec rspec

data/.gitignore

@@ -1,5 +1,4 @@
 .ruby-version
 .ruby-gemset
-Gemfile.lock
 *.gem
 coverage/

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## Relase 1.6.1
+
+* Update all of the Gemfile(.lock) symlinks to actual file copies, for platform
+  compatibility
+* Stop including Gemfiles and lockfiles in the built gem.
+
+## Release 1.6.0
+
+* Remove steep and the rbs types (#41)
+* Check the default's type in StringHelpers, preventing
+  `ENV.string("FOO", default: 5)` (#38 fixes #33)
+* Handle non-numeric values in `ENV.integer` in a more sensible way (#39 fixes #34)
+* Split Gemfile out per supported ruby, and commit all of the resulting lockfiles.
+
 ## Release 1.5.0
 
 * Add rbs/steep, and enforce types in CI (.rbs file is exported as part

data/Steepfile

@@ -7,11 +7,3 @@ target :lib do
   library "pathname"
   library "date"
 end
-
-target :test do
-  signature "sig"
-  check "test"
-  configure_code_diagnostics(D::Ruby.default)
-  library "pathname"
-  library "date"
-end

data/environment_helpers.gemspec

@@ -22,18 +22,19 @@ Gem::Specification.new do |spec|
     `git ls-files -z`
       .split("\x0")
       .reject { |f| f.start_with?("spec") }
+      .reject { |f| f.start_with?("Gemfile") }
   end
 
   spec.bindir = "bin"
   spec.executables = []
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "rspec", "~> 3.10"
+  spec.add_development_dependency "rspec", "~> 3.13"
   spec.add_development_dependency "simplecov", "~> 0.22.0"
   spec.add_development_dependency "rspec-cover_it", "~> 0.1.0"
-  spec.add_development_dependency "pry", "~> 0.14"
-  spec.add_development_dependency "standard", "~> 1.28"
-  spec.add_development_dependency "rubocop", "~> 1.50"
-  spec.add_development_dependency "quiet_quality", "~> 1.3.0"
-  spec.add_development_dependency "mdl", "~> 0.12"
+  spec.add_development_dependency "pry", "~> 0.15"
+  spec.add_development_dependency "standard", "= 1.37.0"
+  spec.add_development_dependency "rubocop", "~> 1.63"
+  spec.add_development_dependency "quiet_quality", "~> 1.5"
+  spec.add_development_dependency "mdl", "~> 0.13"
 end

data/lib/environment_helpers/numeric_helpers.rb

@@ -2,8 +2,20 @@ module EnvironmentHelpers
   module NumericHelpers
     def integer(name, default: nil, required: false)
       check_default_type(:integer, default, Integer)
-      text = fetch_value(name, required: required)
+      text = fetch_value(name, required: required)&.strip
+      text = enforced_format(name: name, text: text, required: required)
       text&.to_i || default
     end
+
+    private
+
+    def enforced_format(name:, text:, required:)
+      return nil unless text
+      return text if text.match?(/\A-?\d+\z/)
+
+      # Not a "correct" integer (we accept only limited forms here)
+      return nil unless required
+      fail(InvalidIntegerText, "The environment variable '#{name}' contains text that does not look like an integer")
+    end
   end
 end

data/lib/environment_helpers/string_helpers.rb

@@ -1,6 +1,7 @@
 module EnvironmentHelpers
   module StringHelpers
     def string(name, default: nil, required: false)
+      check_default_type(:string, default, String)
       fetch_value(name, required: required) || default
     end
 

data/lib/environment_helpers/version.rb

@@ -1,3 +1,3 @@
 module EnvironmentHelpers
-  VERSION = "1.5.0"
+  VERSION = "1.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: environment_helpers
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.1
 platform: ruby
 authors:
 - Eric Mueller
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-14 00:00:00.000000000 Z
+date: 2025-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -58,70 +58,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.28'
+        version: 1.37.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.28'
+        version: 1.37.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.50'
+        version: '1.63'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.50'
+        version: '1.63'
 - !ruby/object:Gem::Dependency
   name: quiet_quality
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: mdl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
 description: |
   Convenience helpers for more simply accessing data passed to applications through the
   environment that may have types and/or defaults
@@ -131,9 +131,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".bundle/config"
 - ".github/workflows/quality.yml"
 - ".github/workflows/rspec.yml"
-- ".github/workflows/type_check.yml"
 - ".gitignore"
 - ".mdl_rules.rb"
 - ".mdlrc"
@@ -142,7 +142,6 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
-- Gemfile
 - LICENSE
 - README.md
 - Steepfile
@@ -157,7 +156,6 @@ files:
 - lib/environment_helpers/range_helpers.rb
 - lib/environment_helpers/string_helpers.rb
 - lib/environment_helpers/version.rb
-- sig/environment_helpers.rbs
 homepage: https://github.com/nevinera/environment_helpers
 licenses:
 - MIT
@@ -179,7 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A set of convenience methods for accessing environment data

data/.github/workflows/type_check.yml

@@ -1,18 +0,0 @@
-name: Steep Type Checking
-
-on: push
-
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.3
-          bundler-cache: true
-
-      - name: Run Steep
-        run: bundle exec steep check

data/Gemfile

@@ -1,7 +0,0 @@
-source "https://rubygems.org"
-
-gemspec
-
-unless ENV["NO_STEEP"]
-  gem "steep", "~> 1.6.0"
-end

data/sig/environment_helpers.rbs

@@ -1,96 +0,0 @@
-module EnvironmentHelpers
-  VERSION: String
-
-  class Error < StandardError
-  end
-
-  class MissingVariableError < Error
-  end
-
-  class BadDefault < Error
-  end
-
-  class BadFormat < Error
-  end
-
-  class InvalidType < Error
-  end
-
-  class InvalidValue < Error
-  end
-
-  class InvalidBooleanText < InvalidValue
-  end
-
-  class InvalidRangeText < InvalidValue
-  end
-
-  class InvalidIntegerText < InvalidValue
-  end
-
-  class InvalidDateText < InvalidValue
-  end
-
-  class InvalidDateTimeText < InvalidValue
-  end
-
-  module AccessHelpers
-    # (Actually provided by ENV, which these are all extended onto)
-    def fetch: (String name) -> String?
-             | (String name, String? default) -> String?
-
-    private def fetch_value: (String name, required: bool) -> String?
-    private def check_default_type: (String | Symbol context, untyped value, *Class types) -> void
-    private def check_default_value: (String | Symbol context, untyped value, allow: Enumerable[untyped]) -> void
-  end
-
-  module FileHelpers : AccessHelpers
-    def file_path: (String name, default: String?, required: bool) -> Pathname?
-  end
-
-  module DatetimeHelpers : AccessHelpers
-    type date_time_result = DateTime? | Time?
-    def date: (String name, format: String, default: Date?, required: bool) -> Date?
-    def date_time: (String name, format: String | Symbol, default: date_time_result, required: bool) -> date_time_result
-    private def parse_date_from: (String? text, format: String) -> Date?
-    private def parse_date_time_from: (String? text, format: String | Symbol) -> DateTime?
-    private def iso8601_date_time: (String) -> DateTime?
-    private def unix_date_time: (String) -> DateTime?
-    private def strptime_date_time: (String, format: String) -> DateTime?
-  end
-
-  module NumericHelpers  : AccessHelpers
-    def integer: (String name, default: Integer?, required: bool) -> Integer?
-  end
-
-  module RangeHelpers : AccessHelpers
-    def integer_range: (String name, default: Range[Integer]?, required: bool) -> Range[Integer]?
-    private def check_range_endpoint: (String | Symbol context, untyped value) -> void
-    private def parse_range_bound_from: (String?) -> Integer?
-    private def parse_range_from: (String) -> Range[Integer]?
-  end
-
-  module BooleanHelpers : AccessHelpers
-    BOOLEAN_VALUES: Set[bool]
-    def boolean: (String name, default: bool?, required: bool) -> boolish
-    private def truthy_text?: (String?) -> boolish
-    private def falsey_text?: (String?) -> boolish
-    private def truthy_strings: () -> Set[String]
-    private def falsey_strings: () -> Set[String]
-  end
-
-  module EnumerableHelpers : AccessHelpers
-    VALID_TYPES: Array[Symbol]
-    TYPE_HANDLERS: Hash[Symbol, Symbol]
-    TYPE_MAP: Hash[Symbol, Class]
-    type arrayable = Integer | String | Symbol
-    def array: (String key, of: Symbol, delimiter: String, default: Array[arrayable]?, required: bool) -> Array[arrayable]?
-    private def check_valid_data_type!: (Symbol) -> void
-    private def check_default_data_types!: (Array[arrayable]?, Symbol) -> void
-  end
-
-  module StringHelpers : AccessHelpers
-    def string: (String name, default: String?, required: bool) -> String?
-    def symbol: (String name, default: Symbol?, required: bool) -> Symbol?
-  end
-end