tins 1.40.0 → 1.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a66e94fcc54524299e535c56b267687c56d5ac3a453bb568d7cfd0cf25741ab2
-  data.tar.gz: 8f15d1bb74a3a603c777198d8d4cf621c89872a6b03cd10db2cab54e68ba92cd
+  metadata.gz: 51a0fa48c00468630ba973991e30b4fe09ded6527da24252217dc9759d103600
+  data.tar.gz: 97512d866988df88e2855d79a08aad717cad1ee5c4a94141d3f0b3a869ec7e70
 SHA512:
-  metadata.gz: 6186ed2a25db87a92138dbf685b59c4d86234a3eca252b40fd4a6828a869e0e95573ca2949c724085657b13355767b0c71a309d6d21c31f6ecd85c8486ef7d37
-  data.tar.gz: 44382be24e42acca56c3992dd816334c77acd2dba000144523e95e67c264240823115bbd4c2265e1803981b7cac369b918cae883a31ff5c3f86de9dab5105cec
+  metadata.gz: 31075326ab8bb69b9e4f5b33426336cfa97a16fc683bf9a620007eff42aa640ae1526629c6076bd3c9e8e0e283dfe4c19d27ca5dd043733a32fc3c308826c2fe
+  data.tar.gz: 65d1a0424696cdfd87e8deeea3952791d8387f4cdd9e4a4358e79bc56e0a722c15f5d436964527af1f3a779cc042f2375cba1cbbc806d18a991c96560fec5c2a

data/CHANGES.md

@@ -1,5 +1,13 @@
 # Changes
 
+## 2025-08-18 v1.41.0
+
+- Added new `named_placeholders_interpolate` method for template substitution
+- Method supports both static and dynamic default values via Proc
+- Maintains backward compatibility with existing `named_placeholders_assign` method
+- Includes comprehensive tests for all functionality and error handling
+- Uses `named_placeholders_assign` internally for consistent implementation
+
 ## 2025-08-18 v1.40.0
 
 - Added `Tins::StringNamedPlaceholders` module with `named_placeholders` and

data/lib/tins/string_named_placeholders.rb

@@ -49,5 +49,22 @@ module Tins
           (default.is_a?(Proc) ? default.(placeholder) : default)
       end
     end
+
+    # Interpolate named placeholders in the string with values from a hash.
+    #
+    # This method takes a hash of placeholder values and substitutes the named
+    # placeholders found in the string with their corresponding values.
+    # Placeholders that are not present in the input hash will be replaced with
+    # the provided default value.
+    #
+    # @param hash [Hash] A hash mapping placeholder names to their corresponding values
+    # @param default [Object, Proc] The default value to use for placeholders not present in the hash
+    #                              If a proc is provided, it will be called with the placeholder symbol
+    #
+    # @return [String] A new string with named placeholders replaced by their values
+    def named_placeholders_interpolate(hash, default: nil)
+      values = named_placeholders_assign(hash, default:)
+      self % values
+    end
   end
 end

data/lib/tins/version.rb

@@ -1,6 +1,6 @@
 module Tins
   # Tins version
-  VERSION         = '1.40.0'
+  VERSION         = '1.41.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/tests/string_named_placeholders.rb

@@ -65,5 +65,45 @@ module Tins
       result = template % values
       assert_equal "Hello Charlie, you are 30 years old and live in NYC", result
     end
+
+    def test_named_placeholders_interpolate
+      # Basic interpolation with defaults
+      result = "Hello %{name}, you are %{age} years old".named_placeholders_interpolate({name: 'Alice'}, default: '[n/a]')
+      assert_equal "Hello Alice, you are [n/a] years old", result
+
+      # All values provided - should work without defaults
+      result = "Hello %{name}, you are %{age} years old".named_placeholders_interpolate({name: 'Bob', age: 30})
+      assert_equal "Hello Bob, you are 30 years old", result
+
+      # Dynamic defaults via Proc
+      result = "Hello %{name}, you are %{age} years old".named_placeholders_interpolate(
+        {name: 'Charlie'},
+        default: ->(key) { "[missing_#{key}]" }
+      )
+      assert_equal "Hello Charlie, you are [missing_age] years old", result
+
+      # Key conversion from string keys
+      result = "Hello %{name}, you are %{age} years old".named_placeholders_interpolate(
+        {'name' => 'David'},
+        default: '[n/a]'
+      )
+      assert_equal "Hello David, you are [n/a] years old", result
+
+      # No placeholders in template
+      result = "Hello World".named_placeholders_interpolate({some_key: 'value'})
+      assert_equal "Hello World", result
+
+      # Empty string values
+      result = "Hello %{name}".named_placeholders_interpolate({name: ''}, default: '[n/a]')
+      assert_equal "Hello ", result
+
+      # Raise custom expcetion if missing
+      template = "Hello %{name}, you are %{age} years old and live in %{city}"
+      assert_raise(ArgumentError, "Required placeholder age not provided") do
+        template.named_placeholders_interpolate(
+          {name: 'Alice'},
+          default: ->(key) { raise ArgumentError, "Required placeholder #{key} not provided" })
+      end
+    end
   end
 end

data/tins.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: tins 1.40.0 ruby lib
+# stub: tins 1.41.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "tins".freeze
-  s.version = "1.40.0".freeze
+  s.version = "1.41.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tins
 version: !ruby/object:Gem::Version
-  version: 1.40.0
+  version: 1.41.0
 platform: ruby
 authors:
 - Florian Frank