Module: Settingable::DeepMerge

Defined in:
lib/settingable/deep_merge.rb

Overview

A module to handle the merging of a hash.

Class Method Summary collapse

Class Method Details

.deep_merge(destination, source) {|key, destination_value, source_value| ... } ⇒ Hash

Merges the source into the destination. This is non-destructive to the destination. If a block is given, it's called if both the source and destination have a non-mergable value. Both the values must be a hash for it to be merged. If it is a non-mergable, and the either the destination doesn't have the key, or no block was given, the default is to overwrite the destination with the new value.

Parameters:

  • destination (Hash) —

    The destination hash.

  • source (Hash) —

    The source hash.

Yields:

  • (key, destination_value, source_value) —

    Yields to determine the action that should be taken to merge the two.

Returns:

  • (Hash) —

    The destination.



19
20
21
 
# File 'lib/settingable/deep_merge.rb', line 19

def deep_merge(destination, source, &block)
  deep_merge!(destination.dup, source, &block)
end

.deep_merge!(destination, source) {|key, destination_value, source_value| ... } ⇒ Hash

Merges the source into the destination. This is destructive to the destination. If a block is given, it's called if both the source and destination have a non-mergable value. Both the values must be a hash in order for it to be merged. If it is a non-mergable value, and either the destination doesn't have the key, or no block was given, the default is to overwrite the destination with the new value.

Parameters:

  • destination (Hash) —

    The destination hash.

  • source (Hash) —

    The source hash.

Yields:

  • (key, destination_value, source_value) —

    Yields to determine the action that should be taken to merge the two.

Returns:

  • (Hash) —

    The destination.



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/settingable/deep_merge.rb', line 36

def deep_merge!(destination, source, &block)
  source.each do |key, value|
    dvalue = destination[key]
    destination[key] = case
                       when value.is_a?(Hash) && dvalue.is_a?(Hash)
                         deep_merge(dvalue, value, &block)
                       when block && destination.key?(key)
                         block.call(key, dvalue, value)
                       else
                         value
                       end
  end

  destination
end