parameter_substitution 3.0.0.pre.1 → 3.0.0.pre.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffc3265d1621830cdaed145097ef5b3d5f1b565112e761428128e60a41ec5ea2
-  data.tar.gz: 84a25b5cdb7be43c5cb1e8391bdfa00fbfdd7802470c26d013b56363620c0a8b
+  metadata.gz: d4094f66f84b7cc0e556405a534d71614017c7d0a0ae5dd81d9684fb795062a3
+  data.tar.gz: f6156ebd337691d09ae23c287f4433121b83f1d1d624b9341629770f665ad48f
 SHA512:
-  metadata.gz: cfcc848d6aa17e0508123d4ec52b516ce02e971a4111fbf56be893168487612a8ef3179b798dcca80ee7d961f5f89f50a188ddfa82156f5ec36cc27440e81a77
-  data.tar.gz: 7dfda5d74dc1863861fd451a20e80d1f4d73f9d28e98e2b16c8dac2688840506c0eec5c86c79cbd2eca10b95f9bd4230bbd37932004380d033c83e28e45ab0a1
+  metadata.gz: 07e273978a485f05fe241fc1e999f40f8ae0310f71001a9803a86bbd0e6e1fc6641d9f8db8d593038ac9b6a0db8a978987fd7aa65aac189183340b39ade3ad09
+  data.tar.gz: ea5f719ad4adeb892c2dc5b0ea02521983e5eebef22d200b47c2d528fc29225520cc1417f0be8d4ce3dec6b488dec47158ebc07d09026ffbce1855c1d217d8ff

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-3"
 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,38 +64,64 @@ 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
 
     private
 
+    VALID_CONTEXT_OVERRIDE_KEYS = %i[
+        required_parameters
+        parameter_start
+        parameter_end
+        destination_encoding
+        allow_unknown_replacement_parameters
+        allow_nil
+        allow_unmatched_parameter_end
+      ].to_set
+    private_constant :VALID_CONTEXT_OVERRIDE_KEYS
+
     # 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?
+
+      invalid_keys = context_overrides.keys.reject { |key| VALID_CONTEXT_OVERRIDE_KEYS.include?(key.to_sym) }
+
+      if invalid_keys.any?
+        invalid_keys_list = invalid_keys.join(", ")
+        valid_keys_list = VALID_CONTEXT_OVERRIDE_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.3
 platform: ruby
 authors:
 - Invoca Development
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2025-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport