Class: Hash

Inherits:
Object show all
Defined in:
lib/active_object/hash.rb

Instance Method Summary collapse

Instance Method Details

#assert_valid_keys(*valid_keys) ⇒ Object 



4
5
6
7
8
9
10
11
12
 
# File 'lib/active_object/hash.rb', line 4

def assert_valid_keys(*valid_keys)
  valid_keys.flatten!
  each_key do |k|
    unless valid_keys.include?(k)
      raise ArgumentError,
        "Unknown key: #{k.inspect}. Valid keys are: #{valid_keys.map(&:inspect).join(', ')}"
    end
  end
end

#compact ⇒ Object 



16
17
18
 
# File 'lib/active_object/hash.rb', line 16

def compact
  select { |k, v| !v.nil? }
end

#compact! ⇒ Object 



22
23
24
 
# File 'lib/active_object/hash.rb', line 22

def compact!
  reject! { |k, v| v.nil? }
end

#deep_merge(other_hash, &block) ⇒ Object 



28
29
30
 
# File 'lib/active_object/hash.rb', line 28

def deep_merge(other_hash, &block)
  dup.deep_merge!(other_hash, &block)
end

#deep_merge!(other_hash, &block) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
45
 
# File 'lib/active_object/hash.rb', line 34

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

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

#except(*keys) ⇒ Object 



49
50
51
 
# File 'lib/active_object/hash.rb', line 49

def except(*keys)
  dup.except!(*keys)
end

#except!(*keys) ⇒ Object 



55
56
57
58
 
# File 'lib/active_object/hash.rb', line 55

def except!(*keys)
  keys.flatten.each { |k| delete(k) }
  self
end

#nillify ⇒ Object 



61
62
63
 
# File 'lib/active_object/hash.rb', line 61

def nillify
  dup.nillify!
end

#nillify! ⇒ Object 



65
66
67
68
69
70
71
 
# File 'lib/active_object/hash.rb', line 65

def nillify!
  each do |k, v|
    if !v.nil? && ((v.respond_to?(:blank?) && v.blank?) || (v.respond_to?(:to_s) && v.to_s.blank?))
      self[k] = nil
    end
  end
end

#only(*keys) ⇒ Object 



73
74
75
 
# File 'lib/active_object/hash.rb', line 73

def only(*keys)
  dup.only!(*keys)
end

#only!(*keys) ⇒ Object 



77
78
79
80
81
 
# File 'lib/active_object/hash.rb', line 77

def only!(*keys)
  hash = {}
  keys.flatten.each { |k| hash[k] = self[k] if self.has_key?(k) }
  replace(hash)
end

#rename_keys(*keys) ⇒ Object 



83
84
85
 
# File 'lib/active_object/hash.rb', line 83

def rename_keys(*keys)
  dup.rename_keys!(*keys)
end

#rename_keys!(*keys) ⇒ Object 



87
88
89
90
91
 
# File 'lib/active_object/hash.rb', line 87

def rename_keys!(*keys)
  keys = Hash[*keys.flatten]
  keys.each { |k, v| self[v] = delete(k) if self[k] }
  self
end

#reverse_merge(other_hash) ⇒ Object 



94
95
96
 
# File 'lib/active_object/hash.rb', line 94

def reverse_merge(other_hash)
  other_hash.merge(self)
end

#reverse_merge!(other_hash) ⇒ Object 



100
101
102
 
# File 'lib/active_object/hash.rb', line 100

def reverse_merge!(other_hash)
  replace(reverse_merge(other_hash))
end

#sample ⇒ Object 



105
106
107
108
 
# File 'lib/active_object/hash.rb', line 105

def sample
  key = sample_key
  [key, fetch(key)]
end

#sample! ⇒ Object 



110
111
112
113
114
 
# File 'lib/active_object/hash.rb', line 110

def sample!
  key, value = sample
  delete(key)
  [key, value]
end

#sample_key ⇒ Object 



116
117
118
119
 
# File 'lib/active_object/hash.rb', line 116

def sample_key
  hash_keys = keys
  hash_keys.at(Random.rand(hash_keys.size - 1))
end

#sample_key! ⇒ Object 



121
122
123
124
125
 
# File 'lib/active_object/hash.rb', line 121

def sample_key!
  key, value = sample
  delete(key)
  key
end

#sample_value ⇒ Object 



127
128
129
 
# File 'lib/active_object/hash.rb', line 127

def sample_value
  fetch(sample_key)
end

#sample_value! ⇒ Object 



131
132
133
134
135
 
# File 'lib/active_object/hash.rb', line 131

def sample_value!
  key, value = sample
  delete(key)
  value
end

#shuffle ⇒ Object 



137
138
139
 
# File 'lib/active_object/hash.rb', line 137

def shuffle
  Hash[to_a.sample(size)]
end

#shuffle! ⇒ Object 



141
142
143
 
# File 'lib/active_object/hash.rb', line 141

def shuffle!
  replace(shuffle)
end

#slice(*keys) ⇒ Object 



146
147
148
 
# File 'lib/active_object/hash.rb', line 146

def slice(*keys)
  keys.flatten.each_with_object(self.class.new) { |k, h| h[k] = self[k] if has_key?(k) }
end

#slice!(*keys) ⇒ Object 



152
153
154
155
156
157
158
159
160
161
 
# File 'lib/active_object/hash.rb', line 152

def slice!(*keys)
  omit = slice(*self.keys - keys)
  hash = slice(*keys)

  hash.default      = default
  hash.default_proc = default_proc if default_proc

  replace(hash)
  omit
end

#stringify_keys ⇒ Object 



165
166
167
 
# File 'lib/active_object/hash.rb', line 165

def stringify_keys
  dup.stringify_keys!
end

#stringify_keys! ⇒ Object 



171
172
173
174
175
176
 
# File 'lib/active_object/hash.rb', line 171

def stringify_keys!
  inject({}) do |options,(k, v)|
    options[k.to_s] = v
    options
  end
end

#strip ⇒ Object 



179
180
181
 
# File 'lib/active_object/hash.rb', line 179

def strip
  select { |k, v| !v.blank? }
end

#strip! ⇒ Object 



183
184
185
 
# File 'lib/active_object/hash.rb', line 183

def strip!
  reject! { |k, v| v.blank? }
end

#symbolize_and_underscore_keys ⇒ Object 



202
203
204
 
# File 'lib/active_object/hash.rb', line 202

def symbolize_and_underscore_keys
  dup.symbolize_and_underscore_keys!
end

#symbolize_and_underscore_keys! ⇒ Object 



206
207
208
209
210
211
 
# File 'lib/active_object/hash.rb', line 206

def symbolize_and_underscore_keys!
  inject({}) do |options, (k, v)|
    options[(k.to_s.gsub(" ", "_").underscore.to_sym rescue k) || k] = v
    options
  end
end

#symbolize_keys ⇒ Object 



188
189
190
 
# File 'lib/active_object/hash.rb', line 188

def symbolize_keys
  dup.symbolize_keys!
end

#symbolize_keys! ⇒ Object 



194
195
196
197
198
199
 
# File 'lib/active_object/hash.rb', line 194

def symbolize_keys!
  inject({}) do |options, (k, v)|
    options[(k.to_sym rescue k) || k] = v
    options
  end
end

#transform_keys(&block) ⇒ Object 



214
215
216
 
# File 'lib/active_object/hash.rb', line 214

def transform_keys(&block)
  dup.transform_keys!(&block)
end

#transform_keys!(&block) ⇒ Object 



220
221
222
223
224
 
# File 'lib/active_object/hash.rb', line 220

def transform_keys!(&block)
  return(enum_for(:transform_keys!)) unless block_given?
  keys.each { |k| self[yield(k)] = delete(k) }
  self
end

#transform_values(&block) ⇒ Object 



228
229
230
 
# File 'lib/active_object/hash.rb', line 228

def transform_values(&block)
  dup.transform_values!(&block)
end

#transform_values!(&block) ⇒ Object 



234
235
236
237
 
# File 'lib/active_object/hash.rb', line 234

def transform_values!(&block)
  return(enum_for(:transform_values!)) unless block_given?
  each { |k, v| self[k] = yield(v) }
end