philiprehberger-env_validator 0.2.9 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7880d4b817b1eb742182c5967ba6881626978a31303900cb1e7428674beab40
-  data.tar.gz: b20afee2c7ca8ebe026e1c10bf52126466e9d2bd2488ac2bd61c295c90e582d0
+  metadata.gz: 5f5eb2c42fbde35384ba3f7b6dc6c15ae3c73f7ef9a51da44f743f4f5a1a759c
+  data.tar.gz: f77bc75aa9b0eef7de0f5601fc294733812b9e478667a539126498d94e4546c1
 SHA512:
-  metadata.gz: 44de6ab04e8c33df4a7692c96feef5da5073e72659bf1068129231e5707b60423779d180eab81c7993d7d0dcdc3e36f952ef05a4cd6ce9b5546d9c02b1a54fca
-  data.tar.gz: db17df01d68d556079242e450ddb28cd3cfe96c737fb9cfbc1891fd2ddcd77bfc83de16da869c5cb683bf072f56adb10b8c20a05ea1da9e6b01daffa5d456bbd
+  metadata.gz: 3547c88cb78b081d3799044704cbc4dc7ee0269b9a7b700284b0e48868e21a6a132e7ff03f6e9c2baea4ca98124cc9682ebbc5d2c08285e2c502d455791e372c
+  data.tar.gz: ce9ab8674cdf6409519b73f4126b08e98c95f58f5830c9567a2c7c1c7488f4f59b39943e6185b1737bb59e0e5ec405ba5860978a2b4be1e59ce90736616508fd

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-10
+
+### Added
+- `prefix:` option for `EnvValidator.define` to group related variables under a shared prefix
+
+### Changed
+- Trim `.rubocop.yml` to minimal config per guide standards
+- Update issue templates to match guide (add gem version field, alternatives field)
+
+### Fixed
+- Merge duplicate `[0.2.2]` CHANGELOG entries into single entry
+
 ## [0.2.9] - 2026-04-08
 
 ### Changed
@@ -50,8 +62,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Update rubocop configuration for Windows compatibility
 
-## [0.2.2] - 2026-03-21
-
 ### Fixed
 - Standardize Installation section in README
 

data/README.md

@@ -82,6 +82,25 @@ config.key?(:PORT)     # => true
 config.slice(:PORT)    # => { "PORT" => 3000 }
 ```
 
+### Prefix
+
+Group related variables with a shared prefix:
+
+```ruby
+env = { "REDIS_HOST" => "localhost", "REDIS_PORT" => "6379", "REDIS_PASSWORD" => "secret" }
+
+config = Philiprehberger::EnvValidator.define(env: env, prefix: "REDIS_") do
+  string  :HOST, required: true
+  integer :PORT, default: 6379
+  string  :PASSWORD
+end
+
+config[:HOST] # => "localhost"
+config[:PORT] # => 6379
+```
+
+The prefix is prepended when looking up each variable in the environment. Result keys use the short name (without prefix). Error messages include the full prefixed name.
+
 ### Validation Errors
 
 ```ruby
@@ -107,7 +126,7 @@ end
 
 | Method / Class | Description |
 |----------------|-------------|
-| `EnvValidator.define(env:, &block)` | Define schema and validate |
+| `EnvValidator.define(env:, prefix:, &block)` | Define schema and validate |
 | `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/validator.rb

@@ -9,9 +9,11 @@ module Philiprehberger
 
       # @param schema [Schema] the schema to validate against
       # @param env [Hash] the environment hash (default: ENV)
-      def initialize(schema, env: ENV)
+      # @param prefix [String, nil] optional prefix prepended to variable names during lookup
+      def initialize(schema, env: ENV, prefix: nil)
         @schema = schema
         @env = env
+        @prefix = prefix
       end
 
       # Validate and return a Result.
@@ -36,20 +38,21 @@ module Philiprehberger
       private
 
       def resolve(name, definition)
-        raw = @env[name]
+        env_key = @prefix ? "#{@prefix}#{name}" : name
+        raw = @env[env_key]
 
-        return resolve_missing(name, definition) if raw.nil? || raw.empty?
+        return resolve_missing(env_key, definition) if raw.nil? || raw.empty?
 
-        value = cast(raw, definition[:type], name)
-        validate_choices(name, value, definition[:choices])
+        value = cast(raw, definition[:type], env_key)
+        validate_choices(env_key, value, definition[:choices])
         [value, nil]
       rescue CastError => e
         [nil, e.message]
       end
 
-      def resolve_missing(name, definition)
+      def resolve_missing(env_key, definition)
         if definition[:required] && definition[:default].nil?
-          [nil, "Missing required variable: #{name}"]
+          [nil, "Missing required variable: #{env_key}"]
         else
           [definition[:default], nil]
         end

data/lib/philiprehberger/env_validator/version.rb

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

data/lib/philiprehberger/env_validator.rb

@@ -18,14 +18,15 @@ module Philiprehberger
     # Define and validate environment variables.
     #
     # @param env [Hash] the environment hash (default: ENV)
+    # @param prefix [String, nil] optional prefix prepended to variable names during lookup
     # @yield [schema] configure the schema
     # @yieldparam schema [Schema]
     # @return [Result] validated values
     # @raise [ValidationError] if validation fails
-    def self.define(env: ENV, &block)
+    def self.define(env: ENV, prefix: nil, &block)
       schema = Schema.new
       schema.instance_eval(&block)
-      Validator.new(schema, env: env).validate!
+      Validator.new(schema, env: env, prefix: prefix).validate!
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-env_validator
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-04-11 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.