philiprehberger-env_validator 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dadb2f13023c0f7c7197f2891dbe002524aa699aaddc2d63cbea4fd3a114e57e
-  data.tar.gz: a234c798c769dbe6555076b89348937915eda6ec2ed6cbf7d14c83d34c5d3da8
+  metadata.gz: a0780e54abe494b5db8736bc9d785d1cc9383b34e41c8f3029e0a33b15f213d9
+  data.tar.gz: 06e4e7b33320265595ca48fb0ca1d4d71ab5ba978b8b75abd52d622c97e074eb
 SHA512:
-  metadata.gz: 474b45b3c68dc48b405a3a43c79763c0c221a7f4a1625771df43ae3305a4c3c7208089e02522ac2f376ea98e7b80c92460ad86f6eb8b09efa12f3d05fbbd28c5
-  data.tar.gz: d8cfbf456a5ef7addc7fd08948b8b367f99e6a5b575d9278e8674c075f169903a2a1d8e5a16a692a41ec92b6e6a5aac6dffe275bd1ad9c2040379098695fb297
+  metadata.gz: e2d37adc96b99600d61bc346fb08439cb02a5288930f7241e8f5106fd1093d4c87dc620271fd1aa79991a938e8b78eac1b703bf0987c7b929fde313bbef8dfd1
+  data.tar.gz: e3df0449a752f36558aef1e80e5fdac3399129c697bee96e4d52c4214cf52147ffe5c7b54030bde138c0e6ff83b5a1189454dbf5fae63331215e8ec768eddb1f

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-06-14
+
+### Added
+- `Result#freeze!` — deeply freezes the underlying values hash and string values, then returns `self`. Lets callers safely treat a validated `Result` as an immutable global/shared config after boot.
+
 ## [0.5.0] - 2026-04-26
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-env_validator.svg)](https://rubygems.org/gems/philiprehberger-env_validator)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-env-validator)](https://github.com/philiprehberger/rb-env-validator/commits/main)
 
+![philiprehberger-env_validator](https://raw.githubusercontent.com/philiprehberger/rb-env-validator/main/package-card.webp)
+
 Schema-based environment variable validation with typed accessors
 
 ## Requirements
@@ -154,6 +156,18 @@ Each element is stripped of surrounding whitespace and cast to `item_type`. An e
 | Boolean | `boolean` | `true/false/1/0/yes/no/on/off` (case-insensitive) |
 | Array | `array` | Delimited string cast to a list of typed elements |
 
+### Immutable Configs
+
+Once validated at boot time, prevent accidental mutation of the result:
+
+```ruby
+ENV_CONFIG = Philiprehberger::EnvValidator.define do
+  string :api_key
+end.freeze!
+
+ENV_CONFIG.fetch(:api_key) << 'tamper'  # => FrozenError
+```
+
 ## API
 
 | Method / Class | Description |
@@ -165,6 +179,7 @@ Each element is stripped of surrounding whitespace and cast to `item_type`. An e
 | `Result#key?(name)` | Check if a variable was defined |
 | `Result#slice(*names)` | Get a subset hash of specific keys |
 | `Result#to_h(exclude:)` | Get all values as a hash; pass `exclude:` to omit keys (symbols or strings) |
+| `Result#freeze!` | Deeply freeze the result; returns self for chaining |
 
 ## Development
 

data/lib/philiprehberger/env_validator/result.rb

@@ -55,6 +55,19 @@ module Philiprehberger
         excluded_keys = exclude.map(&:to_s)
         @values.reject { |key, _| excluded_keys.include?(key.to_s) }
       end
+
+      # Deeply freeze the result so it cannot be mutated after validation.
+      #
+      # Freezes the underlying values hash, all string keys, and any String
+      # values it holds. Useful for global/shared ENV configs that should be
+      # immutable after boot.
+      #
+      # @return [Result] self
+      def freeze!
+        @values.each_value { |v| v.freeze if v.is_a?(String) && !v.frozen? }
+        @values.freeze
+        self
+      end
     end
   end
 end

data/lib/philiprehberger/env_validator/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module EnvValidator
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

metadata

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