Installing the gem is fairly easy. In your Gemfile:

gem "mi_hermano"

To use Mi Hermano, you’ll have to create an empty Google Spreadsheet and use its key (found in its URL) when calling setup:

MiHermano.setup({
  :username => "me@gmail.com",
  :password => "my_secret_password",
  :spreadsheet_key => "nxBFQGKpnzObbVyyIkGtajktMFAhDRGFiEdM66Vacmjz",
})

After that, you can use translate to translate strings:

MiHermano.translate("Hello, my friends!", :en, :fr) # => "Bonjour, mes amis!"

You can define a default source language and a default target language when initializing Mi Hermano. These settings will be used if you do not specify a source or a target when calling translate.

MiHermano.setup({
  :username => "me@gmail.com",
  :password => "my_secret_password",
  :spreadsheet_key => "nxBFQGKpnzObbVyyIkGtajktMFAhDRGFiEdM66Vacmjz",
  :default_source => :en,
  :default_target => :es
})

MiHermano.translate("Hello, my friends!") # => "Hola, mis amigos!"

Since we rely on a Google Spreadsheet function, translating a string is slow. It’s recommended that you use it background jobs.

Mi Hermano is © 2012 Rémi Prévost and may be freely distributed under the MIT license. See the LICENSE file.

Original demo code by Mahmoud Khaled.