# google_currency

**Repository Path**: mirrors_dblock/google_currency

## Basic Information

- **Project Name**: google_currency
- **Description**: Ruby Money::Bank interface for the Google Currency exchange data
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Google Currency
===============

[![Build Status](https://secure.travis-ci.org/RubyMoney/google_currency.png)](http://travis-ci.org/RubyMoney/google_currency)

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.

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

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