module StateMachine::Assertions
Provides a set of helper methods for making assertions about the content of various objects
Public Instance Methods
assert_exclusive_keys(hash, *exclusive_keys)
click to toggle source
Validates that the given hash only includes at most one of a set of exclusive keys. If more than one key is found, an ArgumentError will be raised.
Examples¶ ↑
options = {:only => :on, :except => :off} assert_exclusive_keys(options, :only) # => nil assert_exclusive_keys(options, :except) # => nil assert_exclusive_keys(options, :only, :except) # => ArgumentError: Conflicting keys: only, except assert_exclusive_keys(options, :only, :except, :with) # => ArgumentError: Conflicting keys: only, except
# File lib/state_machine/assertions.rb 31 def assert_exclusive_keys(hash, *exclusive_keys) 32 conflicting_keys = exclusive_keys & hash.keys 33 raise ArgumentError, "Conflicting keys: #{conflicting_keys.join(', ')}" unless conflicting_keys.length <= 1 34 end
assert_valid_keys(hash, *valid_keys)
click to toggle source
Validates that the given hash only includes the specified valid keys. If any invalid keys are found, an ArgumentError will be raised.
Examples¶ ↑
options = {:name => 'John Smith', :age => 30} assert_valid_keys(options, :name) # => ArgumentError: Invalid key(s): age assert_valid_keys(options, 'name', 'age') # => ArgumentError: Invalid key(s): age, name assert_valid_keys(options, :name, :age) # => nil
# File lib/state_machine/assertions.rb 15 def assert_valid_keys(hash, *valid_keys) 16 invalid_keys = hash.keys - valid_keys 17 raise ArgumentError, "Invalid key(s): #{invalid_keys.join(', ')}" unless invalid_keys.empty? 18 end