open_exchange_rates 0.2.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in open_exchange_rates.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Vlado Cingel
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,74 @@
+# OpenExchangeRates
+
+Ruby gem for currency conversion based on [Open Exchange Rates API](http://openexchangerates.org) - free / open source hourly-updated currency data for everybody
+
+## Accuracy
+
+Please see [https://github.com/currencybot/open-exchange-rates/#accuracy](https://github.com/currencybot/open-exchange-rates/#accuracy) and/or [http://openexchangerates.org/documentation/#specification](http://openexchangerates.org/documentation/#specification)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'open_exchange_rates'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install open_exchange_rates
+
+## Usage
+
+Start by creating OpenExchangeRates::Rates instance
+
+    fx = OpenExchangeRates::Rates.new
+
+Convert between currencies using current rates    
+
+    fx.convert(123.45, :from => "USD", :to => "EUR") # => 99.87
+    
+Convert between currencies on specific date   
+
+    fx.convert(123.45, :from => "USD", :to => "EUR", :on => "2012-05-10") # => 95.47
+    
+Get current exchange rate
+
+    fx.exchange_rate(:from => "USD", :to => "EUR") # => 0.808996
+    
+Get exchange rate on specific date
+
+    fx.exchange_rate(:from => "USD", :to => "EUR", :on => "2012-05-10") # => 0.773329
+    
+### Default currency
+
+If you omit **:from** or **:to** option conversion will be related to base currency. USD is set as base currency (plan is to add this as config option in the near future).
+
+    fx.convert(123.45, :to => "EUR") # => 99.87 EUR
+    fx.convert(123.45, :from => "EUR") # => 152.51 USD
+
+    fx.exchange_rate(:to => "EUR") # => 0.808996
+    fx.exchange_rate(:from => "EUR") # => 1.235414
+
+    
+## TODO
+
+- ability to set default currency (USD is currently always set as base currency)
+- ability to pass Date as :on option (only 'yyyy-mm-dd' works currently)
+- write some docs
+- write more test for specific situations (invalid date, ...)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Licence and Terms
+
+Licence - [http://openexchangerates.org/license](http://openexchangerates.org/license)
+Terms - [http://openexchangerates.org/terms](http://openexchangerates.org/terms)

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/lib/open_exchange_rates/parser.rb

@@ -0,0 +1,6 @@
+require "yajl"
+
+module OpenExchangeRates
+  class Parser < Yajl::Parser
+  end
+end

data/lib/open_exchange_rates/rates.rb

@@ -0,0 +1,56 @@
+require "open-uri"
+
+module OpenExchangeRates
+  class Rates
+
+    def exchange_rate(options = {})
+      from_curr = options[:from].to_s.upcase
+      to_curr = options[:to].to_s.upcase
+
+      response = options[:on] ? on(options[:on]) : latest
+      rates = response.rates
+
+      from_curr = response.base_currency if from_curr.empty?
+      to_curr = response.base_currency if to_curr.empty?
+
+      if from_curr == to_curr
+        rate = 1
+      elsif from_curr == response.base_currency
+        rate = rates[to_curr]
+      elsif to_curr == response.base_currency
+        rate = 1 / rates[from_curr]
+      else
+        rate = rates[to_curr] * (1 / rates[from_curr])
+      end
+      round(rate, 6)
+    end
+
+    def convert(amount, options = {})
+      round(amount*exchange_rate(options))
+    end
+
+    def latest(reload = false)
+      @latest_response = reload ? parse_latest : (@latest_response ||= parse_latest)
+      OpenExchangeRates::Response.new(@latest_response)
+    end
+
+    def on(date_string)
+      OpenExchangeRates::Response.new(parse_on(date_string))
+    end
+
+    def round(amount, decimals = 2)
+      (amount * 10**decimals).round.to_f / 10**decimals
+    end
+
+    def parse_latest
+      @latets_parser ||= OpenExchangeRates::Parser.new
+      @latets_parser.parse(open(OpenExchangeRates::LATEST_URL))
+    end
+
+    def parse_on(date_string)
+      @on_parser = OpenExchangeRates::Parser.new
+      @on_parser.parse(open("#{OpenExchangeRates::BASE_URL}/historical/#{date_string}.json"))
+    end
+
+  end
+end

data/lib/open_exchange_rates/response.rb

@@ -0,0 +1,20 @@
+module OpenExchangeRates
+  class Response
+
+    attr_reader :raw_data
+
+    def initialize(raw_data)
+      @raw_data = raw_data
+    end
+
+    def rates
+      raw_data["rates"]
+    end
+
+    def base_currency
+      raw_data["base"]
+    end
+    alias :base :base_currency
+
+  end
+end

data/lib/open_exchange_rates/version.rb

@@ -0,0 +1,3 @@
+module OpenExchangeRates
+  VERSION = "0.2.0"
+end

data/lib/open_exchange_rates.rb

@@ -0,0 +1,10 @@
+require "rubygems"
+require "open_exchange_rates/version"
+require "open_exchange_rates/parser"
+require "open_exchange_rates/response"
+require "open_exchange_rates/rates"
+
+module OpenExchangeRates
+  BASE_URL = "http://openexchangerates.org"
+  LATEST_URL = "#{BASE_URL}/latest.json"
+end

data/open_exchange_rates.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/open_exchange_rates/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Vlado Cingel"]
+  gem.email         = ["vladocingel@gmail.com"]
+  gem.description   = %q{Ruby library for Open Exchange Rates API - free / open source hourly-updated currency data for everybody}
+  gem.summary       = %q{Ruby library for Open Exchange Rates API}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "open_exchange_rates"
+  gem.require_paths = ["lib"]
+  gem.version       = OpenExchangeRates::VERSION
+
+  gem.add_dependency('yajl-ruby')
+
+  gem.add_development_dependency('rr')
+  gem.add_development_dependency('rake')
+end

data/test/2012-05-10.json

@@ -0,0 +1,167 @@
+{
+  "disclaimer": "This data is collected from various providers and provided free of charge for informational purposes only, with no guarantee whatsoever of accuracy, validity, availability, or fitness for any purpose; use at your own risk. Other than that, have fun! More info: http://openexchangerates.org/terms/",
+  "license": "Data collected from various providers with public-facing APIs; copyright may apply; not for resale; no warranties given. Full license info: http://openexchangerates.org/license/",
+  "timestamp": 1336690853,
+  "base": "USD",
+  "rates": {
+    "AED": 3.6732,
+    "AFN": 48.380001,
+    "ALL": 107.559998,
+    "AMD": 393.070007,
+    "ANG": 1.79,
+    "AOA": 94.949997,
+    "ARS": 4.439,
+    "AUD": 0.99458,
+    "AWG": 1.7901,
+    "AZN": 0.786,
+    "BAM": 1.51505,
+    "BBD": 2,
+    "BDT": 81.889999,
+    "BGN": 1.514,
+    "BHD": 0.37706,
+    "BIF": 1402.5,
+    "BMD": 1,
+    "BND": 1.25065,
+    "BOB": 6.91,
+    "BRL": 1.954,
+    "BSD": 1,
+    "BTN": 53.384998,
+    "BWP": 7.5188,
+    "BYR": 8135,
+    "BZD": 1.9135,
+    "CAD": 1.00305,
+    "CDF": 923.920715,
+    "CHF": 0.92865,
+    "CLF": 0.02154,
+    "CLP": 487.049988,
+    "CNH": 6.2995,
+    "CNY": 6.3152,
+    "COP": 1766.300049,
+    "CRC": 503.700012,
+    "CUP": 1,
+    "CVE": 85.379997,
+    "CZK": 19.51585,
+    "DJF": 179.710007,
+    "DKK": 5.7477,
+    "DOP": 39.075001,
+    "DZD": 74.379997,
+    "EGP": 6.0418,
+    "ETB": 17.609699,
+    "EUR": 0.773329,
+    "FJD": 1.8162,
+    "FKP": 0.6191,
+    "GBP": 0.619963,
+    "GEL": 1.62505,
+    "GHS": 1.8808,
+    "GIP": 0.61915,
+    "GMD": 29.690001,
+    "GNF": 6990,
+    "GTQ": 7.7745,
+    "GYD": 203.199997,
+    "HKD": 7.76345,
+    "HNL": 19.055,
+    "HRK": 5.80025,
+    "HTG": 41.849998,
+    "HUF": 223.854996,
+    "IDR": 9218,
+    "IEP": 0.608809,
+    "ILS": 3.8129,
+    "INR": 53.255001,
+    "IQD": 1165.5,
+    "IRR": 12278,
+    "ISK": 125.620003,
+    "JMD": 87.239998,
+    "JOD": 0.7095,
+    "JPY": 79.885002,
+    "KES": 83.599998,
+    "KGS": 46.9706,
+    "KHR": 4025.300049,
+    "KMF": 380.30899,
+    "KPW": 900,
+    "KRW": 1142.400024,
+    "KWD": 0.27867,
+    "KZT": 147.850006,
+    "LAK": 7980.299805,
+    "LBP": 1504,
+    "LKR": 127.849998,
+    "LRD": 74.400002,
+    "LSL": 8.035,
+    "LTL": 2.6704,
+    "LVL": 0.5397,
+    "LYD": 1.2521,
+    "MAD": 8.5844,
+    "MDL": 11.9,
+    "MGA": 2080,
+    "MKD": 47.465,
+    "MMK": 827.5,
+    "MNT": 1312.5,
+    "MOP": 7.9961,
+    "MRO": 292.079987,
+    "MUR": 29.23,
+    "MVR": 15.3,
+    "MWK": 250.5,
+    "MXN": 13.55145,
+    "MYR": 3.067,
+    "MZN": 27.424999,
+    "NAD": 8.002,
+    "NGN": 157.570007,
+    "NIO": 23.290001,
+    "NOK": 5.8685,
+    "NPR": 85.860001,
+    "NZD": 1.275998,
+    "OMR": 0.38505,
+    "PAB": 1,
+    "PEN": 2.649,
+    "PGK": 2.0362,
+    "PHP": 42.459999,
+    "PKR": 90.949997,
+    "PLN": 3.274,
+    "PYG": 4345,
+    "QAR": 3.6415,
+    "RON": 3.4164,
+    "RSD": 86.7705,
+    "RUB": 30.1635,
+    "RWF": 608.155273,
+    "SAR": 3.7503,
+    "SBD": 7.070963,
+    "SCR": 14.11295,
+    "SDG": 2.675,
+    "SEK": 6.9449,
+    "SGD": 1.2518,
+    "SHP": 0.61915,
+    "SLL": 4357.5,
+    "SOS": 1627.300049,
+    "SRD": 3.2875,
+    "STD": 18923.300781,
+    "SVC": 8.7475,
+    "SYP": 62.549999,
+    "SZL": 8.035,
+    "THB": 31.125,
+    "TJS": 4.7593,
+    "TMT": 2.8525,
+    "TND": 1.5597,
+    "TOP": 1.648917,
+    "TRY": 1.7868,
+    "TTD": 6.39355,
+    "TWD": 29.363001,
+    "TZS": 1572.5,
+    "UAH": 8.035,
+    "UGX": 2482.5,
+    "USD": 1,
+    "UYU": 19.91,
+    "UZS": 1856.150024,
+    "VEF": 4.2951,
+    "VND": 20881,
+    "VUV": 92.199997,
+    "WST": 2.265296,
+    "XAF": 507.078705,
+    "XCD": 2.7,
+    "XDR": 0.650166,
+    "XOF": 506.399994,
+    "XPF": 92.230003,
+    "YER": 214.714996,
+    "ZAR": 8.03925,
+    "ZMK": 5135,
+    "ZWL": 322.355011
+  }
+}

data/test/latest.json

@@ -0,0 +1,167 @@
+{
+  "disclaimer": "This data is collected from various providers and provided free of charge for informational purposes only, with no guarantee whatsoever of accuracy, validity, availability, or fitness for any purpose; use at your own risk. Other than that, have fun! More info: http://openexchangerates.org/terms/",
+  "license": "Data collected from various providers with public-facing APIs; copyright may apply; not for resale; no warranties given. Full license info: http://openexchangerates.org/license/",
+  "timestamp": 1338460116,
+  "base": "USD",
+  "rates": {
+    "AED": 3.6733,
+    "AFN": 48.419998,
+    "ALL": 112,
+    "AMD": 406.130005,
+    "ANG": 1.79,
+    "AOA": 95.610001,
+    "ARS": 4.47,
+    "AUD": 1.026057,
+    "AWG": 1.7899,
+    "AZN": 0.7857,
+    "BAM": 1.58,
+    "BBD": 2,
+    "BDT": 82.084999,
+    "BGN": 1.5787,
+    "BHD": 0.37698,
+    "BIF": 1416,
+    "BMD": 1,
+    "BND": 1.28465,
+    "BOB": 6.91,
+    "BRL": 2.0167,
+    "BSD": 1,
+    "BTN": 56.130001,
+    "BWP": 7.8431,
+    "BYR": 8400,
+    "BZD": 1.9135,
+    "CAD": 1.02753,
+    "CDF": 920.661682,
+    "CHF": 0.96804,
+    "CLF": 0.02288,
+    "CLP": 517.75,
+    "CNH": 6.2995,
+    "CNY": 6.3436,
+    "COP": 1824.5,
+    "CRC": 500.5,
+    "CUP": 1,
+    "CVE": 89.050003,
+    "CZK": 20.682949,
+    "DJF": 180.949997,
+    "DKK": 5.9872,
+    "DOP": 39.099998,
+    "DZD": 76.894997,
+    "EGP": 6.0459,
+    "ETB": 17.6849,
+    "EUR": 0.805737,
+    "FJD": 1.8664,
+    "FKP": 0.6449,
+    "GBP": 0.644683,
+    "GEL": 1.62485,
+    "GHS": 1.8827,
+    "GIP": 0.6449,
+    "GMD": 30.26,
+    "GNF": 7150,
+    "GTQ": 7.8045,
+    "GYD": 203.699997,
+    "HKD": 7.76355,
+    "HNL": 19.055,
+    "HRK": 6.0995,
+    "HTG": 41.970001,
+    "HUF": 242.395004,
+    "IDR": 9548,
+    "IEP": 0.634055,
+    "ILS": 3.88115,
+    "INR": 56.205002,
+    "IQD": 1165.5,
+    "IRR": 12275,
+    "ISK": 130.449997,
+    "JMD": 87.43,
+    "JOD": 0.7105,
+    "JPY": 78.839996,
+    "KES": 86.900002,
+    "KGS": 46.9352,
+    "KHR": 4050,
+    "KMF": 396.077393,
+    "KPW": 900,
+    "KRW": 1178.199951,
+    "KWD": 0.2808,
+    "KZT": 148.020004,
+    "LAK": 8032.5,
+    "LBP": 1503.5,
+    "LKR": 132.25,
+    "LRD": 74.25,
+    "LSL": 8.51,
+    "LTL": 2.78165,
+    "LVL": 0.5623,
+    "LYD": 1.2802,
+    "MAD": 8.8936,
+    "MDL": 12.02,
+    "MGA": 2122,
+    "MKD": 48.860001,
+    "MMK": 841.5,
+    "MNT": 1316,
+    "MOP": 7.99655,
+    "MRO": 290.25,
+    "MUR": 30,
+    "MVR": 15.4,
+    "MWK": 269.484985,
+    "MXN": 14.11515,
+    "MYR": 3.17175,
+    "MZN": 27.5,
+    "NAD": 8.515,
+    "NGN": 159.850006,
+    "NIO": 23.445,
+    "NOK": 6.0581,
+    "NPR": 89.809998,
+    "NZD": 1.322664,
+    "OMR": 0.38465,
+    "PAB": 1,
+    "PEN": 2.708,
+    "PGK": 2.0429,
+    "PHP": 43.43,
+    "PKR": 93.800003,
+    "PLN": 3.54265,
+    "PYG": 4535,
+    "QAR": 3.6413,
+    "RON": 3.6025,
+    "RSD": 94.440498,
+    "RUB": 33.050598,
+    "RWF": 609.275513,
+    "SAR": 3.7505,
+    "SBD": 7.048334,
+    "SCR": 14.336,
+    "SDG": 2.6769,
+    "SEK": 7.2326,
+    "SGD": 1.285105,
+    "SHP": 0.6449,
+    "SLL": 4350,
+    "SOS": 1620,
+    "SRD": 3.275,
+    "STD": 19545,
+    "SVC": 8.7475,
+    "SYP": 63.900002,
+    "SZL": 8.504,
+    "THB": 31.84,
+    "TJS": 4.7659,
+    "TMT": 2.8615,
+    "TND": 1.6138,
+    "TOP": 1.795477,
+    "TRY": 1.8478,
+    "TTD": 6.3963,
+    "TWD": 29.811001,
+    "TZS": 1588.5,
+    "UAH": 8.082,
+    "UGX": 2485,
+    "USD": 1,
+    "UYU": 20.299999,
+    "UZS": 1871.439941,
+    "VEF": 4.2927,
+    "VND": 20840,
+    "VUV": 95.25,
+    "WST": 2.398426,
+    "XAF": 528.103271,
+    "XCD": 2.7,
+    "XDR": 0.661611,
+    "XOF": 529,
+    "XPF": 95.650002,
+    "YER": 215.5,
+    "ZAR": 8.50305,
+    "ZMK": 5345,
+    "ZWL": 322.355011
+  }
+}

data/test/rates_test.rb

@@ -0,0 +1,156 @@
+require "test_helper"
+
+class TestOpenExchangeRates < Test::Unit::TestCase
+
+  def test_exchange_rate
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_latest { OpenExchangeRates::Parser.new.parse(File.open("latest.json")) }
+
+    # 1 USD = 6.0995 HRK
+    # 1 USD = 1.026057 AUD
+    assert_equal 1, fx.exchange_rate(:from => "USD", :to => "USD")
+    assert_equal 1, fx.exchange_rate(:from => "AUD", :to => "AUD")
+    assert_equal 1, fx.exchange_rate(:from => "HRK", :to => "HRK")
+
+    assert_equal 6.0995, fx.exchange_rate(:from => "USD", :to => "HRK")
+    assert_equal 1.026057, fx.exchange_rate(:from => "USD", :to => "AUD")
+
+    assert_equal 0.163948, fx.exchange_rate(:from => "HRK", :to => "USD")
+    assert_equal 0.974605, fx.exchange_rate(:from => "AUD", :to => "USD")
+
+    assert_equal 5.944602, fx.exchange_rate(:from => "AUD", :to => "HRK")
+    assert_equal 0.168220, fx.exchange_rate(:from => "HRK", :to => "AUD")
+  end
+
+  def test_exchange_rate_on_specific_date
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_on { OpenExchangeRates::Parser.new.parse(File.open("2012-05-10.json")) }
+
+    # 1 USD = 5.80025 HRK
+    # 1 USD = 0.99458 AUD
+    assert_equal 1, fx.exchange_rate(:from => "USD", :to => "USD", :on => "2012-05-10")
+    assert_equal 1, fx.exchange_rate(:from => "AUD", :to => "AUD", :on => "2012-05-10")
+    assert_equal 1, fx.exchange_rate(:from => "HRK", :to => "HRK", :on => "2012-05-10")
+
+    assert_equal 5.80025, fx.exchange_rate(:from => "USD", :to => "HRK", :on => "2012-05-10")
+    assert_equal 0.99458, fx.exchange_rate(:from => "USD", :to => "AUD", :on => "2012-05-10")
+
+    assert_equal 0.172406, fx.exchange_rate(:from => "HRK", :to => "USD", :on => "2012-05-10")
+    assert_equal 1.005450, fx.exchange_rate(:from => "AUD", :to => "USD", :on => "2012-05-10")
+
+    assert_equal 5.831859, fx.exchange_rate(:from => "AUD", :to => "HRK", :on => "2012-05-10")
+    assert_equal 0.171472, fx.exchange_rate(:from => "HRK", :to => "AUD", :on => "2012-05-10")
+  end
+
+  def test_convert
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_latest { OpenExchangeRates::Parser.new.parse(File.open("latest.json")) }
+
+    # 1 USD = 6.0995 HRK
+    # 1 USD = 1.026057 AUD
+    assert_equal 609.95, fx.convert(100, :from => "USD", :to => "HRK")
+    assert_equal 16.39, fx.convert(100, :from => "HRK", :to => "USD")
+    assert_equal 120.32, fx.convert(123.4567, :from => "AUD", :to => "USD")
+    assert_equal 733.90, fx.convert(123.4567, :from => "AUD", :to => "HRK")
+    assert_equal 20.77, fx.convert(123.4567, :from => "HRK", :to => "AUD")
+  end
+
+  def test_convert_on_specific_date
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_on { OpenExchangeRates::Parser.new.parse(File.open("2012-05-10.json")) }
+
+    # 1 USD = 5.80025 HRK
+    # 1 USD = 0.99458 AUD
+    assert_equal 580.03, fx.convert(100, :from => "USD", :to => "HRK", :on => "2012-10-05")
+    assert_equal 17.24, fx.convert(100, :from => "HRK", :to => "USD", :on => "2012-10-05")
+    assert_equal 124.13, fx.convert(123.4567, :from => "AUD", :to => "USD", :on => "2012-10-05")
+    assert_equal 719.98, fx.convert(123.4567, :from => "AUD", :to => "HRK", :on => "2012-10-05")
+    assert_equal 21.17, fx.convert(123.4567, :from => "HRK", :to => "AUD", :on => "2012-10-05")
+  end
+
+  def test_convert_if_from_option_is_missing
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_latest { OpenExchangeRates::Parser.new.parse(File.open("latest.json")) }
+
+    # from defaults to base currency (USD)
+    # 1 USD = 6.0995 HRK
+    # 1 USD = 1.026057 AUD
+    assert_equal 609.95, fx.convert(100, :to => "HRK")
+    assert_equal 102.61, fx.convert(100, :to => "AUD")
+  end
+
+  def test_convert_if_to_option_is_missing
+    fx = OpenExchangeRates::Rates.new
+    stub(fx).parse_latest { OpenExchangeRates::Parser.new.parse(File.open("latest.json")) }
+
+    # to defaults to base currency (USD)
+    # 1 USD = 6.0995 HRK
+    # 1 USD = 1.026057 AUD
+    assert_equal 16.39, fx.convert(100, :from => "HRK")
+    assert_equal 97.46, fx.convert(100, :from => "AUD")
+  end
+
+  def test_latest
+    fx = OpenExchangeRates::Rates.new
+    latest_rates = fx.latest
+
+    assert_equal "USD", latest_rates.base_currency
+    assert_equal "USD", latest_rates.base
+    assert latest_rates.rates.is_a?(Hash)
+
+    stub(fx).parse_latest { OpenExchangeRates::Parser.new.parse(File.open("latest.json")) }
+
+    # latest results are cached
+    cached_rates = fx.latest
+    assert_equal latest_rates.rates["USD"], cached_rates.rates["USD"]
+    assert_equal latest_rates.rates["AUD"], cached_rates.rates["AUD"]
+    assert_equal latest_rates.rates["HRK"], cached_rates.rates["HRK"]
+
+    # latest results are reloaded
+    stubbed_rates = fx.latest(:reload)
+    assert_equal latest_rates.rates["USD"], stubbed_rates.rates["USD"]
+    assert_not_equal latest_rates.rates["AUD"], stubbed_rates.rates["AUD"]
+    assert_not_equal latest_rates.rates["HRK"], stubbed_rates.rates["HRK"]
+
+    assert_equal 1, stubbed_rates.rates["USD"]
+    assert_equal 1.026057, stubbed_rates.rates["AUD"]
+    assert_equal 6.0995, stubbed_rates.rates["HRK"]
+  end
+
+  def test_on
+    fx = OpenExchangeRates::Rates.new
+    on_rates = fx.on("2012-05-10")
+
+    assert_equal "USD", on_rates.base_currency
+    assert_equal "USD", on_rates.base
+    assert on_rates.rates.is_a?(Hash)
+
+    assert_equal 1, on_rates.rates["USD"]
+    assert_equal 0.99458, on_rates.rates["AUD"]
+    assert_equal 5.80025, on_rates.rates["HRK"]
+  end
+
+  def test_round
+    fx = OpenExchangeRates::Rates.new
+
+    assert_equal 12.35, fx.round(12.345)
+    assert_equal 1.23, fx.round(1.2345)
+    assert_equal 1.2, fx.round(1.2345, 1)
+    assert_equal 12.3457, fx.round(12.345678, 4)
+  end
+
+  def test_multiple_calls
+    fx = OpenExchangeRates::Rates.new
+    assert_nothing_raised do
+      fx.convert(123, :from => "EUR", :to => "AUD", :on => "2012-03-10")
+      fx.convert(100, :from => "USD", :to => "EUR")
+      fx.convert(123.45, :from => "EUR", :to => "USD", :on => "2012-04-10")
+      fx.convert(12, :from => "USD", :to => "EUR")
+      fx.convert(123.4567, :from => "EUR", :to => "USD", :on => "2012-05-10")
+      fx.exchange_rate(:from => "USD", :to => "EUR")
+      fx.exchange_rate(:from => "USD", :to => "EUR", :on => "2012-04-10")
+      fx.exchange_rate(:from => "USD", :to => "AUD", :on => "2012-05-10")
+    end
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+require "rubygems"
+require "test/unit"
+require "rr"
+require "open_exchange_rates"
+
+class Test::Unit::TestCase
+  include RR::Adapters::TestUnit
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification 
+name: open_exchange_rates
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Vlado Cingel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-06-01 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rr
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Ruby library for Open Exchange Rates API - free / open source hourly-updated currency data for everybody
+email: 
+- vladocingel@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/open_exchange_rates.rb
+- lib/open_exchange_rates/parser.rb
+- lib/open_exchange_rates/rates.rb
+- lib/open_exchange_rates/response.rb
+- lib/open_exchange_rates/version.rb
+- open_exchange_rates.gemspec
+- test/2012-05-10.json
+- test/latest.json
+- test/rates_test.rb
+- test/test_helper.rb
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Ruby library for Open Exchange Rates API
+test_files: 
+- test/2012-05-10.json
+- test/latest.json
+- test/rates_test.rb
+- test/test_helper.rb
+has_rdoc: