Contents

Google Currency with Rails Cache
================================

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](https://github.com/intridea/multi_json) (`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.

This fork of the original GoogleCurrency library uses the Rails.cache for exchange rate
storage instead of a Mutex. It is designed for multiple application server environments.

Usage
-----

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

    # 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
---------

Original Google Currency work is Copyright (c) 2011 Shane Emmons. See {file:LICENSE} for details.

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
google_currency_rails_cache-1.2	README.md
google_currency_rails_cache-1.1.1	README.md
google_currency_rails_cache-1.1.0	README.md
google_currency_rails_cache-1.0.0	README.md