state_machine

https://github.com/pluginaweek/state_machine

Ruby

Adds support for creating state machines for attributes on any Ruby class

StateMachine::NodeCollection#fetch

Gets the node indexed by the given key.  By default, this will look up the
key in the first index configured for the collection.  A custom index can
be specified like so:

  collection['parked', :value]

The above will look up the "parked" key in a hash indexed by each node's
+value+ attribute.

If the key cannot be found, then an IndexError exception will be raised:

  collection['invalid', :value]   # => IndexError: "invalid" is an invalid value

Source | Google | Stack overflow

Edit

git clone [email protected]:pluginaweek/state_machine.git

cd state_machine

open lib/state_machine/node_collection.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-StateMachine--NodeCollection-fetch-for-pr

# Commit to git

git add lib/state_machine/node_collection.rbgit commit -m "better docs for StateMachine::NodeCollection#fetch"

# Open pull request

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

hub fork

git push <your name> -your-name--update-docs-StateMachine--NodeCollection-fetch-for-pr

hub pull-request

# Celebrate!