Sha256: 6190167a0a0b09eb3666b1ab8dac21da44aff7b3f8ddb417b7d755d5c5613040

Contents?: true

Size: 1.41 KB

Versions: 1

Compression:

Stored size: 1.41 KB

Contents

# Money Open Exchange Rates

A gem that calculates the exchange rate using published rates from
[open-exchange-rates](http://josscrowcroft.github.com/open-exchange-rates/)

## Usage

```ruby
require 'money/bank/open_exchange_rates_bank'
moe = Money::Bank::OpenExchangeRatesBank.new
moe.cache = 'path/to/file/cache'
moe.app_id = 'your app id from https://openexchangerates.org/signup'
moe.update_rates

Money.default_bank = moe
```

You can also provide a Proc as a cache to provide your own caching mechanism
perhaps with Redis or just a thread safe `Hash` (global). For example:

```ruby
moe.cache = Proc.new do |v|
  key = 'money:exchange_rates']
  if v
    Thread.current[key] = v
  else
    Thread.current[key]
  end
end
```

## Tests

As of the end of August 2012 all requests to the Open Exchange Rates API must
have a valid app_id. You can place your own key on a file named TEST_APP_ID and
then run:

  ```bundle exec ruby test/open_exchange_rates_bank_test.rb```

## Refs

* https://github.com/currencybot/open-exchange-rates
* https://github.com/RubyMoney/money
* https://github.com/RubyMoney/eu_central_bank
* https://github.com/RubyMoney/google_currency

## Contributors

* [Wayne See](https://github.com/weynsee)
* [Julien Boyer](https://github.com/chatgris)
* [Kevin Ball](https://github.com/kball)
* [Michael Morris](https://github.com/mtcmorris)


## License
The MIT License

Copyright © 2012 Laurent Arnoud <laurent@spkdev.net>

Version data entries

1 entries across 1 versions & 1 rubygems

Version Path
money-open-exchange-rates-0.1.1 README.markdown