Module: Lazier::Hash

Extended by:
ActiveSupport::Concern
Defined in:
lib/lazier/hash.rb

Overview

Extensions for Hash objects.

Constant Summary

VALID_ACCESSES =

The supported accesses for #ensure_access

{
  strings: :stringify_keys,
  symbols: :symbolize_keys,
  indifferent: :with_indifferent_access,
  dotted: :enable_dotted_access
}

Instance Method Summary (collapse)

Instance Method Details

- (Hash) compact(&validator)

Returns a new hash, removing all keys which values are blank.

Parameters:

  • validator (Proc)

    , if present all the keys which evaluates to true will be removed. Otherwise all blank values will be removed.

Returns:

  • (Hash)

    The hash with all blank values removed.



23
24
25
# File 'lib/lazier/hash.rb', line 23

def compact(&validator)
  dup.compact!(&validator)
end

- (Object) compact!(&validator)

Compacts the current hash, removing all keys which values are blank.

Parameters:

  • validator (Proc)

    , if present all the keys which evaluates to true will be removed. Otherwise all blank values will be removed.



30
31
32
33
# File 'lib/lazier/hash.rb', line 30

def compact!(&validator)
  validator ||= ->(_, v) { v.blank? }
  reject!(&validator)
end

- (Hash) enable_dotted_access(readonly = true)

Makes sure that the hash is accessible using dotted notation. This is also applied to every embedded hash.

Parameters:

  • readonly (Boolean) (defaults to: true)

    If the dotted notation is only enable for reading. true by default.

Returns:

  • (Hash)

    The current hash with keys enabled for dotted access.



48
49
50
51
52
53
54
55
56
# File 'lib/lazier/hash.rb', line 48

def enable_dotted_access(readonly = true)
  extend(Hashie::Extensions::MethodReader)
  extend(Hashie::Extensions::MethodQuery)
  extend(Hashie::Extensions::MethodWriter) unless readonly

  each { |_, value| enable_dotted_access_for_value(value, readonly) }

  self
end

- (Hash) ensure_access(*accesses)

Makes sure that the keys of the hash are accessible in the desired way.

Parameters:

  • accesses (Array)

    The requested access for the keys. Can be :strings, :symbols or :indifferent. If nil the keys are not modified.

Returns:

  • (Hash)

    The current hash with keys modified.



39
40
41
42
# File 'lib/lazier/hash.rb', line 39

def ensure_access(*accesses)
  methods = accesses.ensure_array(compact: true, no_duplicates: true, flatten: true) { |m| VALID_ACCESSES[m.ensure_string.to_sym] }.compact
  methods.reduce(self) { |a, e| a.send(e) }
end