/google_currency

Ruby Money::Bank interface for the Google Currency exchange data

Primary LanguageRubyMIT LicenseMIT

Google Currency

Build Status

This gem extends Money::Bank::VariableExchange with Money::Bank::GoogleCurrency and gives you access to the current Google Currency exchange rates.

You have to load one of the JSON libraries supported by MultiJSON (json for example) if it's not already loaded by your application. In a Rails application, ActiveSupport provides a JSON implementation that is automatically recognized.

Usage

require 'money'
require 'money/bank/google_currency'
require 'json'
MultiJson.engine = :json_gem # or :yajl

# (optional)
# set the seconds after than the current rates are automatically expired
# by default, they never expire
Money::Bank::GoogleCurrency.ttl_in_seconds = 86400

# set default bank to instance of GoogleCurrency
Money.default_bank = Money::Bank::GoogleCurrency.new

# create a new money object, and use the standard #exchange_to method
n = 1.to_money(:USD)
n.exchange_to(:EUR)

An UnknownRate will be thrown if #exchange_to is called with a Currency that Money knows, but Google does not.

An UnknownCurrency will be thrown if #exchange_to is called with a Currency that Money does not know.

Copyright

Copyright (c) 2011 Shane Emmons. See {file:LICENSE} for details.