parameter_substitution 3.0.0.pre.1 → 3.0.0.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffc3265d1621830cdaed145097ef5b3d5f1b565112e761428128e60a41ec5ea2
-  data.tar.gz: 84a25b5cdb7be43c5cb1e8391bdfa00fbfdd7802470c26d013b56363620c0a8b
+  metadata.gz: 470d5abf687490b1aa41c54794478f9c0ffa4fd904b360cab55b60351eb2e9f7
+  data.tar.gz: acda768f6ff4e072b6769cb4cbb3d82cf81951ce0cc9a210a5fc541f04e006a9
 SHA512:
-  metadata.gz: cfcc848d6aa17e0508123d4ec52b516ce02e971a4111fbf56be893168487612a8ef3179b798dcca80ee7d961f5f89f50a188ddfa82156f5ec36cc27440e81a77
-  data.tar.gz: 7dfda5d74dc1863861fd451a20e80d1f4d73f9d28e98e2b16c8dac2688840506c0eec5c86c79cbd2eca10b95f9bd4230bbd37932004380d033c83e28e45ab0a1
+  metadata.gz: 360e3825227457357b8c4a244862f889171d2f4c369e82b3a2907f2d8114297da9094fb4914c20f8885b42f544daf6563e0075f8fc9f02a4071ac2fc0ebb0d79
+  data.tar.gz: c339269735f7ba01a811c068a06ac5bb8a4100848eca49cc01f5e8903854c8cca570def8233a6cc0ee464b9525724d3c580a9f10fe5ff8b360d32e2457356508

data/lib/parameter_substitution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class ParameterSubstitution
-  VERSION = "3.0.0-1"
+  VERSION = "3.0.0-2"
 end

data/lib/parameter_substitution.rb

@@ -3,6 +3,7 @@
 # See lib/parameter_substitution/readme.md
 
 require 'active_support/all'
+require 'set'
 require "parameter_substitution/context"
 require "parameter_substitution/parse_error"
 require "parameter_substitution/parser"
@@ -63,17 +64,17 @@ class ParameterSubstitution
       ParameterSubstitution.config = config
     end
 
-    def find_tokens(string_with_tokens, mapping: {}, context_overrides: nil)
+    def find_tokens(string_with_tokens, mapping: {}, context_overrides: {})
       context = build_context(string_with_tokens, mapping, context_overrides)
       parse_expression(context).substitution_parameter_names
     end
 
-    def find_formatters(string_with_tokens, mapping: {}, context_overrides: nil)
+    def find_formatters(string_with_tokens, mapping: {}, context_overrides: {})
       context = build_context(string_with_tokens, mapping, context_overrides)
       parse_expression(context).method_names
     end
 
-    def find_warnings(string_with_tokens, mapping: {}, context_overrides: nil)
+    def find_warnings(string_with_tokens, mapping: {}, context_overrides: {})
       context = build_context(string_with_tokens, mapping, context_overrides)
       parse_expression(context).parameter_and_method_warnings || []
     end
@@ -83,18 +84,43 @@ class ParameterSubstitution
     # Build context with optional overrides
     # @param [String] string_with_tokens The input string containing tokens
     # @param [Hash] mapping The mapping of parameters to values
-    # @param [Hash, nil] context_overrides Optional overrides for context attributes
+    # @param [Hash] context_overrides Optional overrides for context attributes
     # @return [ParameterSubstitution::Context] The constructed context
+    # @raise [ArgumentError] if context_overrides contains invalid keys
     def build_context(string_with_tokens, mapping, context_overrides)
-      override_options = context_overrides || {}
+      validate_context_overrides!(context_overrides)
+
       base_options = {
         input: string_with_tokens,
         mapping: mapping
       }
 
-      ParameterSubstitution::Context.new(**override_options.merge(base_options))
+      ParameterSubstitution::Context.new(**context_overrides.merge(base_options))
     end
 
+    # @param [Hash] context_overrides The overrides to validate
+    # @raise [ArgumentError] if context_overrides contains invalid keys
+    def validate_context_overrides!(context_overrides)
+      return if context_overrides.empty?
+
+      valid_keys = %i[
+        required_parameters
+        parameter_start
+        parameter_end
+        destination_encoding
+        allow_unknown_replacement_parameters
+        allow_nil
+        allow_unmatched_parameter_end
+      ].to_set
+
+      invalid_keys = context_overrides.keys.reject { |key| valid_keys.include?(key.to_sym) }
+
+      if invalid_keys.any?
+        invalid_keys_list = invalid_keys.join(", ")
+        valid_keys_list = valid_keys.sort.join(", ")
+        raise ArgumentError, "Invalid context_overrides keys: #{invalid_keys_list}. Valid keys are: #{valid_keys_list}"
+      end
+    end
 
     def parse_expression(context)
       cst = ParameterSubstitution::Parser.new(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parameter_substitution
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre.1
+  version: 3.0.0.pre.2
 platform: ruby
 authors:
 - Invoca Development
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2025-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport