Module: Dnsimple::Extra

Defined in:
lib/dnsimple/extra.rb

Class Method Summary collapse

Class Method Details

.deep_merge(this, other, &block) ⇒ Object

Returns a new hash with self and other merged recursively.

h1 = { a: true, b: { c: [1, 2, 3] } }
h2 = { a: false, b: { x: [3, 4, 5] } }

h1.deep_merge(h2) #=> { a: false, b: { c: [1, 2, 3], x: [3, 4, 5] } }

Like with Hash#merge in the standard library, a block can be provided to merge values:

h1 = { a: 100, b: 200, c: { c1: 100 } }
h2 = { b: 250, c: { c1: 200 } }
h1.deep_merge(h2) { |key, this_val, other_val| this_val + other_val }
# => { a: 100, b: 450, c: { c1: 300 } }

18
19
20
# File 'lib/dnsimple/extra.rb', line 18

def self.deep_merge(this, other, &block)
  deep_merge!(this.dup, other, &block)
end

.deep_merge!(this, other, &block) ⇒ Object

Same as deep_merge, but modifies self.


23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# File 'lib/dnsimple/extra.rb', line 23

def self.deep_merge!(this, other, &block)
  other.each_pair do |current_key, other_value|
    this_value = this[current_key]

    this[current_key] = if this_value.is_a?(Hash) && other_value.is_a?(Hash)
      deep_merge(this_value, other_value, &block)
    else
      if block_given? && key?(current_key)
        block.call(current_key, this_value, other_value)
      else
        other_value
      end
    end
  end

  this
end

.validate_mandatory_attributes(attributes, required) ⇒ void

This method returns an undefined value.

Validates the presence of mandatory attributes.

Parameters:

  • attributes (Hash)
  • required (Array<Symbol>)

Raises:

  • (ArgumentError)

47
48
49
50
51
# File 'lib/dnsimple/extra.rb', line 47

def self.validate_mandatory_attributes(attributes, required)
  required.each do |name|
    attributes.key?(name) or raise(ArgumentError, ":#{name} is required")
  end
end