parameter_substitution 3.0.0.pre.0 → 3.0.0.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7d5937f29714849ed0f6dcb964e0976a010cf106cf0c7a3abc8fc431d93b770
-  data.tar.gz: b5410f60e594f40f6becd805a050b0e385ad58f71e049a421b6a7c07f76d8542
+  metadata.gz: 470d5abf687490b1aa41c54794478f9c0ffa4fd904b360cab55b60351eb2e9f7
+  data.tar.gz: acda768f6ff4e072b6769cb4cbb3d82cf81951ce0cc9a210a5fc541f04e006a9
 SHA512:
-  metadata.gz: 385b533cc23ad5c51c9e3e8de2aa4898617b375d1692523cd4f1c34df0a20256cb074e73fb7d5c7303b18540797164c58e2fca212392b35a74d685439c31c014
-  data.tar.gz: 8b4f90595113426f82ca45c691056f0fcb602bdad90df6f0e15e7996edb0d2f60b3f09fc432a0defd023ef5a8f5ce048e6482b792340f29a1e0daa395c8afc46
+  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-0"
+  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,15 +84,42 @@ 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)
+      validate_context_overrides!(context_overrides)
+
       base_options = {
         input: string_with_tokens,
         mapping: mapping
       }
 
-      ParameterSubstitution::Context.new(**base_options.merge(context_overrides || {}))
+      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)

metadata

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