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