philiprehberger-env_validator 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d161696b2b9fea1ec0e79df18b0ee38234514d61f109abc400f7f2402206e35e
-  data.tar.gz: 5ec74ae0e07adc4ab28d6c2cd0ad8439d6dbf9253341b00f1be10af6a3da532c
+  metadata.gz: 5f5eb2c42fbde35384ba3f7b6dc6c15ae3c73f7ef9a51da44f743f4f5a1a759c
+  data.tar.gz: f77bc75aa9b0eef7de0f5601fc294733812b9e478667a539126498d94e4546c1
 SHA512:
-  metadata.gz: 3cc7c136467286ba23bde1bcc833894be9e3ff00ad6c775545aa881bf8095d1da4fc30051cbd4606e37d1ef7189ff5bb8cbfe499bc02b4c3cb14fbd0f8e88b45
-  data.tar.gz: e291e0c387a9616463921832c7d18851732d091c0824a3e48cb0b0d2d12d4ce51f256400a7f5d6b5db0da7252e539a12c6ffd6f484ebda49236036f3de29838f
+  metadata.gz: 3547c88cb78b081d3799044704cbc4dc7ee0269b9a7b700284b0e48868e21a6a132e7ff03f6e9c2baea4ca98124cc9682ebbc5d2c08285e2c502d455791e372c
+  data.tar.gz: ce9ab8674cdf6409519b73f4126b08e98c95f58f5830c9567a2c7c1c7488f4f59b39943e6185b1737bb59e0e5ec405ba5860978a2b4be1e59ce90736616508fd

data/CHANGELOG.md

@@ -7,6 +7,28 @@ 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
+- Align gemspec summary with README description.
+
+## [0.2.8] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.2.7] - 2026-03-31
 
 ### Changed
@@ -40,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.7'
+    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.7
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 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.
@@ -26,11 +26,11 @@ files:
 - lib/philiprehberger/env_validator/schema.rb
 - lib/philiprehberger/env_validator/validator.rb
 - lib/philiprehberger/env_validator/version.rb
-homepage: https://github.com/philiprehberger/rb-env-validator
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-env_validator
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-env-validator
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-env_validator
   source_code_uri: https://github.com/philiprehberger/rb-env-validator
   changelog_uri: https://github.com/philiprehberger/rb-env-validator/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-env-validator/issues
@@ -53,5 +53,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Schema-based environment variable validation with typed accessors for Ruby
+summary: Schema-based environment variable validation with typed accessors
 test_files: []