philiprehberger-env_loader 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7bda9ba33185eb43d4c7075a8fff984bfd0c2c74616414a987f650366c84805
-  data.tar.gz: 9de085c7594eb86b5e5611e6c3acb2c1e1480666aa713b32440238850f65b8ba
+  metadata.gz: 5695fc29c75310a93a32d21ca2b7b1919771d2ef434b79e1142ff0386cc87248
+  data.tar.gz: 45bc9bbf6d34968df565216ea9bf42030c7abe6d52d0b5b6a9888e966bb62ee1
 SHA512:
-  metadata.gz: ca16348ef8d38e61cff91d8bf4b9dbf2313f1115840cc7f029f15c818baa466e98bb4185a7569fbe898b5b8182206a2bb612403747ecb98c585370c89bcc92c4
-  data.tar.gz: 4f0f69b2371534485cd84f1704e49fbc5ca29551f917a042a757f3f167eb9b45eba0f01ebbf19a613d38ed8645728ac6cc75faeda065ce993b04a8e414a8f6bd
+  metadata.gz: ca424e6b156ec4b4aa011b5120cf97bd9fe58e2e7de23e992b81f130cb6cb6372e01aa836a8fdd2e3997061fe0fdfcb7e382f1729207fc07002e290c609a35e1
+  data.tar.gz: 3405dd52700c5ede06248dc1fffe2ea3d983061641100429aac85c74f2e1724f783e10559b09a72fb46c63f943e1d7b3908b11e073d327eb4e6a6f9077d07cb1

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-05-01
+
+### Added
+- `EnvLoader.parse(content)` — parse `.env`-formatted content from a string into a hash without touching ENV; useful for tests and embedded configs
+
+## [0.2.1] - 2026-04-15
+
+### Changed
+- Verified compliance with Ruby package, gemspec, and README guides
+
 ## [0.2.0] - 2026-04-04
 
 ### Added

data/README.md

@@ -73,6 +73,21 @@ Philiprehberger::EnvLoader.generate_template(
 )
 ```
 
+### Parse from a String
+
+Parse `.env`-formatted text without reading from disk and without touching ENV:
+
+```ruby
+content = <<~ENV
+  APP_HOST=localhost
+  APP_PORT=3000
+  # comments and blank lines are ignored
+ENV
+
+Philiprehberger::EnvLoader.parse(content)
+# => { "APP_HOST" => "localhost", "APP_PORT" => "3000" }
+```
+
 ## API
 
 | Method | Description |
@@ -80,6 +95,7 @@ Philiprehberger::EnvLoader.generate_template(
 | `.load(*files, required:, types:, defaults:, prefix:, strip_prefix:)` | Load variables from .env files with options |
 | `.validate!(*keys)` | Raise if any keys are missing or empty in ENV |
 | `.generate_template(output:, keys:)` | Generate a .env.template file |
+| `.parse(content)` | Parse `.env`-formatted content from a string into a hash without touching ENV |
 | `EnvLoader::Error` | Base error class for all gem errors |
 | `EnvLoader::ValidationError` | Raised when required keys are missing or empty |
 

data/lib/philiprehberger/env_loader/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module EnvLoader
-    VERSION = '0.2.0'
+    VERSION = '0.3.0'
   end
 end

data/lib/philiprehberger/env_loader.rb

@@ -65,13 +65,18 @@ module Philiprehberger
       File.write(output, "#{content}\n")
     end
 
-    # Parse a .env file into a hash of key-value pairs.
+    # Parse `.env`-formatted content from a string into a hash.
     #
-    # @param path [String] the file path
-    # @return [Hash<String, String>] parsed key-value pairs
-    def self.parse_file(path)
+    # Useful for tests, embedded configurations, and any scenario where the
+    # `.env` content does not live in a file. Comments (`#`), blank lines,
+    # and surrounding whitespace are ignored. Single- and double-quoted
+    # values are unwrapped. ENV is not touched.
+    #
+    # @param content [String] the `.env`-formatted text
+    # @return [Hash{String => String}] parsed key-value pairs
+    def self.parse(content)
       result = {}
-      File.readlines(path).each do |line|
+      content.to_s.each_line do |line|
         line = line.strip
         next if line.empty? || line.start_with?('#')
 
@@ -86,6 +91,14 @@ module Philiprehberger
       end
       result
     end
+
+    # Parse a .env file into a hash of key-value pairs.
+    #
+    # @param path [String] the file path
+    # @return [Hash<String, String>] parsed key-value pairs
+    def self.parse_file(path)
+      parse(File.read(path))
+    end
     private_class_method :parse_file
 
     # Apply type coercions to ENV values.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-env_loader
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-05-02 00:00:00.000000000 Z
 dependencies: []
 description: Load environment variables from multiple .env files with configurable
   precedence, type coercion, required key validation, default values, and template