philiprehberger-env_validator 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f5eb2c42fbde35384ba3f7b6dc6c15ae3c73f7ef9a51da44f743f4f5a1a759c
-  data.tar.gz: f77bc75aa9b0eef7de0f5601fc294733812b9e478667a539126498d94e4546c1
+  metadata.gz: cb9d6d9b1aeee1b8eb35392807aec880212627edbcbb426c8108e1056824dc07
+  data.tar.gz: 0366aba96e46ec24ba6a769b4ba17271d29fa89ccf24bc99ca08a528e056d845
 SHA512:
-  metadata.gz: 3547c88cb78b081d3799044704cbc4dc7ee0269b9a7b700284b0e48868e21a6a132e7ff03f6e9c2baea4ca98124cc9682ebbc5d2c08285e2c502d455791e372c
-  data.tar.gz: ce9ab8674cdf6409519b73f4126b08e98c95f58f5830c9567a2c7c1c7488f4f59b39943e6185b1737bb59e0e5ec405ba5860978a2b4be1e59ce90736616508fd
+  metadata.gz: 176cf272fcecb3fbb9e88acd9d11daaf509751265ef6eab0f4c7fddeb45c16550984525a48eb8f7e7711ba8b776bd7c34934da2c3c011c789d69970342aae6d1
+  data.tar.gz: 266c6471e7c5d11e0933edce3f639add0bf0a0252c8ab43253af0e5eae6652cc03018edcfd1b7540b7954a3a11b4c5626509741538cded0dcba97008253fd043

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-16
+
+### Added
+- `Schema#array(name, item_type:, separator:, required:, default:)` for parsing delimited ENV values as lists with per-element type casting (`:string`, `:integer`, `:float`, `:boolean`)
+
 ## [0.3.0] - 2026-04-10
 
 ### Added

data/README.md

@@ -113,6 +113,30 @@ end
 #    Missing required variable: DATABASE_URL; Missing required variable: API_KEY
 ```
 
+### Arrays (Delimited Lists)
+
+Parse a delimited ENV value into an array of typed elements:
+
+```ruby
+env = {
+  "TAGS"    => "ruby,rails,hotwire",
+  "PORTS"   => "3000,3001,3002",
+  "PATHS"   => "/usr/bin:/usr/local/bin"
+}
+
+config = Philiprehberger::EnvValidator.define(env: env) do
+  array :TAGS
+  array :PORTS, item_type: :integer
+  array :PATHS, separator: ":"
+end
+
+config[:TAGS]  # => ["ruby", "rails", "hotwire"]
+config[:PORTS] # => [3000, 3001, 3002]
+config[:PATHS] # => ["/usr/bin", "/usr/local/bin"]
+```
+
+Each element is stripped of surrounding whitespace and cast to `item_type`. An empty or missing ENV value yields `[]` (or the configured `default:`). If any element fails to cast a `ValidationError` is raised.
+
 ### Supported Types
 
 | Type | Method | Accepts |
@@ -121,12 +145,14 @@ end
 | Integer | `integer` | Numeric strings (`"42"`, `"-1"`) |
 | Float | `float` | Numeric strings (`"3.14"`, `"1"`) |
 | Boolean | `boolean` | `true/false/1/0/yes/no/on/off` (case-insensitive) |
+| Array | `array` | Delimited string cast to a list of typed elements |
 
 ## API
 
 | Method / Class | Description |
 |----------------|-------------|
 | `EnvValidator.define(env:, prefix:, &block)` | Define schema and validate |
+| `Schema#array(name, item_type:, separator:, required:, default:)` | Declare a delimited list ENV var parsed into a typed array |
 | `Result#fetch(name)` / `Result#[name]` | Get a validated value |
 | `Result#keys` | List all defined variable names |
 | `Result#key?(name)` | Check if a variable was defined |

data/lib/philiprehberger/env_validator/schema.rb

@@ -52,6 +52,29 @@ module Philiprehberger
       def boolean(name, required: false, default: nil, choices: nil)
         @definitions[name.to_s] = { type: :boolean, required: required, default: default, choices: choices }
       end
+
+      # Define an array variable parsed from a delimited string.
+      #
+      # The ENV value is split on `separator`, each element is stripped of
+      # surrounding whitespace, and each element is cast to `item_type`
+      # using the same type caster the other schema methods use.
+      #
+      # @param name [Symbol, String] the ENV variable name
+      # @param item_type [Symbol] element type (:string, :integer, :float, :boolean)
+      # @param separator [String] delimiter between elements (default: ',')
+      # @param required [Boolean] whether the variable is required
+      # @param default [Array, nil] default value if not set
+      # @return [void]
+      def array(name, item_type: :string, separator: ',', required: false, default: nil)
+        @definitions[name.to_s] = {
+          type: :array,
+          item_type: item_type,
+          separator: separator,
+          required: required,
+          default: default,
+          choices: nil
+        }
+      end
     end
   end
 end

data/lib/philiprehberger/env_validator/validator.rb

@@ -41,6 +41,7 @@ module Philiprehberger
         env_key = @prefix ? "#{@prefix}#{name}" : name
         raw = @env[env_key]
 
+        return resolve_array(env_key, raw, definition) if definition[:type] == :array
         return resolve_missing(env_key, definition) if raw.nil? || raw.empty?
 
         value = cast(raw, definition[:type], env_key)
@@ -58,6 +59,25 @@ module Philiprehberger
         end
       end
 
+      def resolve_array(env_key, raw, definition)
+        return resolve_missing_array(env_key, definition) if raw.nil?
+        return [[], nil] if raw.empty?
+
+        elements = raw.split(definition[:separator]).map(&:strip)
+        values = elements.map { |element| cast(element, definition[:item_type], env_key) }
+        [values, nil]
+      rescue CastError => e
+        [nil, e.message]
+      end
+
+      def resolve_missing_array(env_key, definition)
+        if definition[:required] && definition[:default].nil?
+          [nil, "Missing required variable: #{env_key}"]
+        else
+          [definition[:default] || [], nil]
+        end
+      end
+
       def validate_choices(name, value, choices)
         return if choices.nil? || choices.include?(value)
 

data/lib/philiprehberger/env_validator/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module EnvValidator
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-env_validator
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-11 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: Define environment variable schemas with type casting, required/optional
   flags, and defaults. Validates at boot time and provides typed accessors.