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] } }

Extra.deep_merge(h1, 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 } }
Extra.deep_merge(h1, h2) { |key, this_val, other_val| this_val + other_val }
# => { a: 100, b: 450, c: { c1: 300 } }



27
28
29
 
# File 'lib/dnsimple/extra.rb', line 27

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 this instead of returning a new hash.



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/dnsimple/extra.rb', line 32

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 && key?(current_key)
        block.call(current_key, this_value, other_value)
      else
        other_value
      end
    end
  end

  this
end

.join_uri(*parts) ⇒ String

Joins two pieces of URI with a /.

Returns:

  • (String) —

    The joined string.



9
10
11
 
# File 'lib/dnsimple/extra.rb', line 9

def self.join_uri(*parts)
  parts.map { |part| part.chomp("/") }.join("/")
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) 


56
57
58
59
60
 
# File 'lib/dnsimple/extra.rb', line 56

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