chef

https://github.com/opscode/chef

Ruby

A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.

Chef::ResourceCollection::ResourceSet#find

Find existing resources by searching the list of existing resources.  Possible
forms are:

find(:file => "foobar")
find(:file => [ "foobar", "baz" ])
find("file[foobar]", "file[baz]")
find("file[foobar,baz]")

Returns the matching resource, or an Array of matching resources.

Raises an ArgumentError if you feed it bad lookup information
Raises a Runtime Error if it can't find the resources you are looking for.

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git

cd chef

open lib/chef/resource_collection/resource_set.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--ResourceCollection--ResourceSet-find-for-pr

# Commit to git

git add lib/chef/resource_collection/resource_set.rbgit commit -m "better docs for Chef::ResourceCollection::ResourceSet#find"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Chef--ResourceCollection--ResourceSet-find-for-pr

hub pull-request

# Celebrate!