Module: Hashie::Extensions::DeepLocate

Defined in:
lib/hashie/extensions/deep_locate.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.deep_locate(comparator, object) ⇒ Object

The module level implementation of #deep_locate, incase you do not want to include/extend the base datastructure. For further examples please see #deep_locate.

Examples:

books = [
  {
    title: "Ruby for beginners",
    pages: 120
  },
  ...
]

Hashie::Extensions::DeepLocate.deep_locate -> (key, value, object) { key == :title }, books
# => [{:title=>"Ruby for beginners", :pages=>120}, ...]


19
20
21
22
23
24
25
26
27
28
 
# File 'lib/hashie/extensions/deep_locate.rb', line 19

def self.deep_locate(comparator, object)
  # ensure comparator is a callable
  unless comparator.respond_to?(:call)
    comparator = lambda do |non_callable_object|
      ->(key, _, _) { key == non_callable_object }
    end.call(comparator)
  end

  _deep_locate(comparator, object)
end

Instance Method Details

#deep_locate(comparator) ⇒ Object

Performs a depth-first search on deeply nested data structures for a given comparator callable and returns each Enumerable, for which the callable returns true for at least one the its elements.

Examples:

books = [
  {
    title: "Ruby for beginners",
    pages: 120
  },
  {
    title: "CSS for intermediates",
    pages: 80
  },
  {
    title: "Collection of ruby books",
    books: [
      {
        title: "Ruby for the rest of us",
        pages: 576
      }
    ]
  }
]

books.extend(Hashie::Extensions::DeepLocate)

# for ruby 1.9 leave *no* space between the lambda rocket and the braces
# http://ruby-journal.com/becareful-with-space-in-lambda-hash-rocket-syntax-between-ruby-1-dot-9-and-2-dot-0/

books.deep_locate -> (key, value, object) { key == :title && value.include?("Ruby") }
# => [{:title=>"Ruby for beginners", :pages=>120}, {:title=>"Ruby for the rest of us", :pages=>576}]

books.deep_locate -> (key, value, object) { key == :pages && value <= 120 }
# => [{:title=>"Ruby for beginners", :pages=>120}, {:title=>"CSS for intermediates", :pages=>80}]


65
66
67
 
# File 'lib/hashie/extensions/deep_locate.rb', line 65

def deep_locate(comparator)
  Hashie::Extensions::DeepLocate.deep_locate(comparator, self)
end