philiprehberger-env_loader 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5695fc29c75310a93a32d21ca2b7b1919771d2ef434b79e1142ff0386cc87248
-  data.tar.gz: 45bc9bbf6d34968df565216ea9bf42030c7abe6d52d0b5b6a9888e966bb62ee1
+  metadata.gz: eb02740e5ccfd37833abf860aab8ab0c2f8a46cab63f1b1bcd17746384212c3a
+  data.tar.gz: 8641f1e44aa514fa8dfc5d1ca2643431ff0e48de19bc4ea0825ef10f2bde506e
 SHA512:
-  metadata.gz: ca424e6b156ec4b4aa011b5120cf97bd9fe58e2e7de23e992b81f130cb6cb6372e01aa836a8fdd2e3997061fe0fdfcb7e382f1729207fc07002e290c609a35e1
-  data.tar.gz: 3405dd52700c5ede06248dc1fffe2ea3d983061641100429aac85c74f2e1724f783e10559b09a72fb46c63f943e1d7b3908b11e073d327eb4e6a6f9077d07cb1
+  metadata.gz: 3e4a088a9664ff7325464b2eac8330178e7bb7a83a91869e9938c80195597aa668676b306cf850e62de2250e05c09b4a3b3c354ee84b63eef3a0ceac822cafed
+  data.tar.gz: c5b2552f169cbc78f043441ea105c517b4fabef753469b71bd3cfef41775ac335a7bc3785faf80137d0f82a93ac1f7724b75064556a295725e6c37aad6fdf552

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-29
+
+### Added
+- `EnvLoader.dump(hash)` serializes a hash to `.env`-formatted text suitable for `parse` or for writing to a file; alphabetically sorted keys, double-quotes for values containing whitespace/`=`/`#`/quotes, backslash-escapes inner `"` and `\`, trailing newline
+- `parse` now unescapes `\"`, `\\`, and `\n` inside double-quoted values so `parse(dump(h))` round-trips cleanly for values with inner quotes
+
 ## [0.3.0] - 2026-05-01
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-env_loader.svg)](https://rubygems.org/gems/philiprehberger-env_loader)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-env-loader)](https://github.com/philiprehberger/rb-env-loader/commits/main)
 
+![philiprehberger-env_loader](https://raw.githubusercontent.com/philiprehberger/rb-env-loader/main/package-card.webp)
+
 Multi-source environment variable loader with precedence and validation
 
 ## Requirements
@@ -88,6 +90,21 @@ Philiprehberger::EnvLoader.parse(content)
 # => { "APP_HOST" => "localhost", "APP_PORT" => "3000" }
 ```
 
+### Dump to `.env` Format
+
+Serialize a hash back to `.env`-formatted text. Round-trips with `parse` for any input. Values that contain whitespace, `=`, `#`, or quote characters are double-quoted with inner `"` and `\` backslash-escaped. Keys are sorted alphabetically.
+
+```ruby
+text = Philiprehberger::EnvLoader.dump(
+  'APP_HOST' => 'localhost',
+  'APP_PORT' => '3000',
+  'NOTE' => 'has "quote"'
+)
+# => "APP_HOST=localhost\nAPP_PORT=3000\nNOTE=\"has \\\"quote\\\"\"\n"
+
+File.write('.env', text)
+```
+
 ## API
 
 | Method | Description |
@@ -96,6 +113,7 @@ Philiprehberger::EnvLoader.parse(content)
 | `.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 |
+| `.dump(hash)` | Serialize a hash to `.env`-formatted text (round-trips with `parse`) |
 | `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.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/env_loader.rb

@@ -85,8 +85,11 @@ module Philiprehberger
 
         key = key.strip
         value = value.strip
-        value = value[1..-2] if (value.start_with?('"') && value.end_with?('"')) ||
-                                (value.start_with?("'") && value.end_with?("'"))
+        if value.length >= 2 && value.start_with?('"') && value.end_with?('"')
+          value = value[1..-2].gsub(/\\(.)/) { Regexp.last_match(1) == 'n' ? "\n" : Regexp.last_match(1) }
+        elsif value.length >= 2 && value.start_with?("'") && value.end_with?("'")
+          value = value[1..-2]
+        end
         result[key] = value
       end
       result
@@ -101,6 +104,44 @@ module Philiprehberger
     end
     private_class_method :parse_file
 
+    # Serialize a hash to `.env`-formatted text suitable for writing to a
+    # file or passing to {parse}.
+    #
+    # Keys are emitted in alphabetical order. Values that contain
+    # whitespace, `=`, `#`, or quote characters are wrapped in double
+    # quotes with inner `"` and `\` backslash-escaped. `nil` values become
+    # empty (`KEY=`). The output always ends with a single trailing
+    # newline.
+    #
+    # @example Round trip
+    #   Philiprehberger::EnvLoader.parse(
+    #     Philiprehberger::EnvLoader.dump('A' => '1', 'B' => 'two words')
+    #   )
+    #   # => { "A" => "1", "B" => "two words" }
+    #
+    # @param hash [Hash{String, Symbol => Object}] the key-value pairs to serialize
+    # @return [String] `.env`-formatted text
+    def self.dump(hash)
+      lines = hash.to_h
+                  .transform_keys(&:to_s)
+                  .sort_by(&:first)
+                  .map { |key, value| "#{key}=#{format_value(value)}" }
+      "#{lines.join("\n")}\n"
+    end
+
+    # @api private
+    def self.format_value(value)
+      return '' if value.nil?
+
+      str = value.to_s
+      return '' if str.empty?
+      return str unless str.match?(/[\s="'#]/)
+
+      escaped = str.gsub('\\') { '\\\\' }.gsub('"') { '\\"' }
+      %("#{escaped}")
+    end
+    private_class_method :format_value
+
     # Apply type coercions to ENV values.
     #
     # @param types [Hash<String, Symbol>] key => type mapping

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-env_loader
 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-05-02 00:00:00.000000000 Z
+date: 2026-05-30 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