ccy_convertor 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTYwZTU1NWIzNTZkOTE3N2EwMjdiYjllOTQ3ZjQzM2IzZWE1NmQxZA==
+  data.tar.gz: !binary |-
+    ZWYyN2JmMjU3M2QxMTM4ZTRmZWU3OTNkMDBlNDg0OTkxMTM0MTVhMw==
+SHA512:
+  metadata.gz: !binary |-
+    NGJhMjAzYWJiMWQzYTcxM2ZlZDA4NDI0MjZkZDVmOTRmNzYxN2U3N2EzMTM4
+    ODdiOTEzMTUzZTdiYjk1NWZhNTRhNTEyYTk0ZjI5ZTg3OWQ4ZmM0MmYyNDc0
+    NDY0YTBkYjBjZmE1ZTkzOTBhMjEwODM1Y2FkOTU4NGE4Y2M0MmI=
+  data.tar.gz: !binary |-
+    MjRkODRkN2Q0NjFiMDYxNDRmMDE3MDZiNzg0ZTQwZmQ4MDY4ZTA3ZDY5NGEx
+    OWYyYWIxN2JkYWFiNzNjNThkZTVmNTk0OGQ2OGEzZWNjOGM3MGYwYWJmNjMz
+    NTgzMmFmMDNmNzk4NGI5ODEzYjljODczZjBmMzY4M2I2ZWI4Mzc=

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Rohan Pujari
+
+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,166 @@
+# CcyConvertor
+
+CcyConvertor provides live currency rate for various currencies and allows to convert money from one currency to other. Currently it supports 3 rate provider. New rate provider can be easily plugged in
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ccy_convertor'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ccy_convertor
+
+## Usage
+
+Once gem is installed you can find out exchange rate between currency as follows
+```ruby
+CcyConvertor.rate(from_ccy: 'USD', to_ccy: 'NZD') # will use default rate provider to get rate
+```
+Note:  Default rate provider is CcyConvertor::YahooFinance. You can change default rate provider. Check [configuration section](#configuration)
+
+Rate provider can also be provided as a parameter. Rate provider is a class which provides rate by using rest_api
+```ruby
+CcyConvertor.rate(from_ccy: 'USD', to_ccy: 'NZD', rate_provider: CcyConvertor::OpenExchangeRate)
+CcyConvertor.rate(from_ccy: 'USD', to_ccy: 'NZD', rate_provider: CcyConvertor::JSONRates)
+```
+You can also directly use rate provider class as follows.
+```ruby
+CcyConvertor::OpenExchangeRate.rate('USD', 'INR') # will return USD/INR rate
+```
+Note: CcyConvertor::OpenExchangeRate and CcyConvertor::JSONRate requires api_key. You can register at respective websites to get a api key
+
+#### Rate Providers
+| Rate provider class name  | rest api source  | Api key required   |
+|---|---|---|
+|  CcyConvertor::YahooFinance | 'yahoo.finance.xchange' table yql  | no  |
+| CcyConvertor::OpenExchangeRate  | www.openexchangerates.org  | yes  |
+| CcyConvertor::JSONRate  | www.jsonrates.com  | yes  |
+
+Api key can be provided individually to this classes as
+
+```ruby
+CcyConvertor::OpenExchangeRate.api_key = 'XXXXXXXXX'
+CcyConvertor::OpenExchangeRate.api_key = 'XXXXXXXXX'
+```
+
+Also check [configuration section](#configuration) to know other ways to provide api_key to rate provider classes
+
+You can convert money from one currency to another in following ways
+Below code will use rate provided from www.openexchangerates.org
+```ruby
+CcyConvertor::OpenExchangeRate.convert(from_ccy: 'USD', to_ccy: 'NZD', amount: 10)
+10.usd.to_nzd(rate_provider: Ccyconvertor::OpenExchangeRate)
+```
+
+Below code will use default rate provider. Default rate provider is configurable . Check [configuration section](#configuration)
+```ruby
+CcyConvertor.convert(from_ccy: 'USD', to_ccy: 'NZD', amount: 10)
+10.usd.to_nzd
+```
+You can also get all the rates of currency with respect to particular base currency
+```ruby
+Ccyconvertor::OpenExchangeRate.rate_matrix
+```
+Above method will return hash with currency code as key and rate as value. All rates would be with respect to USD. OpenExchangeRate do not allow us to specify other base currency and USD is always the base currency.
+
+For Ccyconvertor::JSONRate we can specify the base currency
+```ruby
+Ccyconvertor::OpenExchangeRate.rate_matrix('NZD')
+```
+ All rates returned would be with respect to NZD. If no parameter is given then base currency is USD by default
+ Note: Ccyconvertor::YahooFinance do not support rate_matrix method
+
+## Configuration
+
+You can configure following parameters
+
+1. default_rate-provider: Default rate provider is the rate provider which is used when no rate provider is species. Rate provider is a api service that this gem uses to provide rate. By default default rate provider is CcyConvertor::YahooFinance. Check rate providers details [here](#rate-providers)
+
+2. api_keys: CcyConvertor::OpenExchangeRate and CcyConvertor::JSONRate provider requires api_key. You can register at there respective sites to get the api_key
+
+3. cache_duration: specifies the time for which the response would be cached. By default this time is zero seconds i.e no caching is done by default. If cache_duration is 60 seconds and if you want a exchange rate of USD/INR multiple times in your application, request to rate provider would be made only once in 60 seconds and after 60 seconds next request would be made.
+ActiveSupport::Cache is used for caching
+
+4. roud_up_rate: This takes fixnum which tells number of decimal places to which the rate would be rounded to.
+
+5. roud_up_amount: This takes fixnum which tells number of decimal places to which the rate would be rounded to.
+
+Sample configuration:
+```ruby
+CcyConvertor.configure do |config|
+  config.round_up_rate = 4
+  config.round_up_amount = 4
+  config.default_rate_provider = CcyConvertor::JSONRate
+  config.api_keys = {
+    open_exchange_rate: 'XXXXXXXXX',
+    json_rate: 'XXXXXX'
+  }
+  config.cache_duration = {
+    open_exchange_rate: 20,
+    yahoo_finance: 30,
+    json_rate: 20
+  }
+end
+```
+If you are using rails, above code can be pasted in config/initializers/ccy_convertor.rb
+
+Note: api_keys and cache_duration expects hash. Hash key is name of the class without module name in a underscore format
+
+## Adding new rate provider
+
+Its simple to add a new rate provider. You can plug in any rate provider which provides rest api.
+
+##### Steps for adding rate provider that support api call to get all rate in single api call:
+
+1. Make a class with appropriate name inherit it from CccyConvertor::RateProvider
+2. Add following class methods
+```ruby
+  rest_url_for_rate_matrix(base_ccy=nil)
+```
+Above method should return rest api url to get rates of alll currencies.
+```ruby
+rate_matrix(base_ccy=nil)
+```
+Above method should return rates in hash format as
+```ruby
+{
+    'currency_code1' => rate with respect to base_ccy,
+    'currency_code2' => rate with respect to base_ccy
+}
+```
+Note: currency_code should be in upper case
+You can call ``` rate_matrix_response(base_ccy) ``` method inside ```rate_matrix(base_ccy)``` method to get response from url returned by ```rest_url_for_rate_matrix(base_ccy=nil)``` method
+Once you get response from rate_matrix_response method you can convert it to response format as mentioned above
+
+##### Steps for adding rate provider that does not support api call to get all rate in single api call:
+
+1. Make a class with appropriate name inherit it from CccyConvertor::RateProvider
+2. Add following class methods
+```ruby
+rest_url_for_rate(from_ccy, to_ccy)
+```
+Above method should return url for geting exchange rate between from_ccy and to_ccy
+```ruby
+rate(from_ccy, to_ccy)
+```
+Above method should return exchange rate(Numeric type) between from_ccy and to_ccy. You can call ```rate_response(from_ccy, to_ccy)``` inside ```rate(from_ccy, to_ccy)``` to get response from url returned by ```rest_url_for_rate(from_ccy, to_ccy)``` 
+
+Now you can directly use new rate provider added by you as an existing rate provider present in the gem. You can also use all the cofiguration present for th rate provider. If rate provider added by you require api_key, you can provide it as metioned in configurtion section.
+If you want to use api_key inside you rate provider class, you can use class method api_key to access it.
+Check rate providers inside lib/rate_providers for more information
+
+## Contributing
+
+1. Fork it ( https://github.com/rohanpujaris/ccy_convertor/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/ccy_convertor.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ccy_convertor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ccy_convertor"
+  spec.version       = CcyConvertor::VERSION
+  spec.authors       = ["Rohan Pujari"]
+  spec.email         = ["rohanpujaris@gmail.com"]
+  spec.summary       = %q{CcyConvertor provides live currency rate for various currencies and allows to convert money from one currency to other}
+  spec.description   = %q{CcyConvertor provides live currency rate for various currencies and allows to convert money from one currency to other. Currently it supports 3 rate provider. New rate provider can be easily plugged in}
+  spec.homepage      = "https://github.com/rohanpujaris/ccy_convertor"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+
+  spec.add_runtime_dependency "activesupport", ">= 3.0"
+  spec.add_runtime_dependency "httparty"
+end

data/lib/ccy_convertor.rb

@@ -0,0 +1,39 @@
+require 'active_support/core_ext/string/inflections'
+require 'active_support/cache.rb'
+require 'httparty'
+require 'digest/sha1'
+
+require 'ccy_convertor/version'
+require 'ccy_convertor/configuration'
+require 'ccy_convertor/constant'
+require 'ccy_convertor/extension'
+require 'ccy_convertor/money'
+require 'ccy_convertor/exception'
+require 'ccy_convertor/rate_cache'
+require 'ccy_convertor/process_and_validate_option'
+require 'ccy_convertor/rate_providers/rate_provider'
+require 'ccy_convertor/rate_providers/yahoo_finance'
+require 'ccy_convertor/rate_providers/open_exchange_rate'
+require 'ccy_convertor/rate_providers/json_rate'
+
+module CcyConvertor
+  class << self
+    def rate(options)
+      RateProvider.process_options!(options)
+      RateProvider.validate_presence_of_hash_keys!(options, [:from_ccy, :to_ccy])
+      rate = rate_provider(options).rate(options[:to_ccy], options[:from_ccy])
+      return rate if CcyConvertor.configuration.round_up_rate.nil?
+      rate.to_f.round(CcyConvertor.configuration.round_up_rate)
+    end
+
+    def convert(options)
+      amount = rate_provider(options).convert(options)
+      return amount if CcyConvertor.configuration.round_up_amount.nil?
+      amount.to_f.round(CcyConvertor.configuration.round_up_amount)
+    end
+
+    def rate_provider(options)
+      options[:rate_provider] || CcyConvertor.configuration.default_rate_provider
+    end
+  end
+end

data/lib/ccy_convertor/configuration.rb

@@ -0,0 +1,21 @@
+module CcyConvertor
+  class << self
+    attr_accessor :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration) if block_given?
+    end
+  end
+
+  class Configuration
+    attr_accessor :round_up_rate, :round_up_amount, :api_keys, :default_rate_provider, :cache_duration
+
+    def default_rate_provider
+      @default_rate_provider || CcyConvertor::YahooFinance
+    end
+  end
+end

data/lib/ccy_convertor/constant.rb

@@ -0,0 +1,187 @@
+module CcyConvertor
+  module Constant
+    CCY_CODE_AND_NAME = {
+      'AED' => 'United Arab Emirates dirham',
+      'AFN' => 'Afghani',
+      'ALL' => 'Lek',
+      'AMD' => 'Armenian Dram',
+      'ANG' => 'Netherlands Antillian Guilder',
+      'AOA' => 'Kwanza',
+      'ARS' => 'Argentine Peso',
+      'AUD' => 'Australian Dollar',
+      'AWG' => 'Aruban Guilder',
+      'AZN' => 'Azerbaijanian Manat',
+      'BAM' => 'Convertible Marks',
+      'BBD' => 'Barbados Dollar',
+      'BDT' => 'Bangladeshi Taka',
+      'BGN' => 'Bulgarian Lev',
+      'BHD' => 'Bahraini Dinar',
+      'BIF' => 'Burundian Franc',
+      'BMD' => 'Bermudian Dollar (customarily known as Bermuda Dollar)',
+      'BND' => 'Brunei Dollar',
+      'BOB' => 'Boliviano',
+      'BOV' => 'Bolivian Mvdol (Funds code)',
+      'BRL' => 'Brazilian Real',
+      'BSD' => 'Bahamian Dollar',
+      'BTN' => 'Ngultrum',
+      'BWP' => 'Pula',
+      'BYR' => 'Belarussian Ruble',
+      'BZD' => 'Belize Dollar',
+      'CAD' => 'Canadian Dollar',
+      'CDF' => 'Franc Congolais',
+      'CHE' => 'WIR Euro (complementary currency)',
+      'CHF' => 'Swiss Franc',
+      'CHW' => 'WIR Franc (complementary currency)',
+      'CLF' => 'Unidades de formento (Funds code)',
+      'CLP' => 'Chilean Peso',
+      'CNY' => 'Yuan Renminbi',
+      'COP' => 'Colombian Peso',
+      'COU' => 'Unidad de Valor Real',
+      'CRC' => 'Costa Rican Colon',
+      'CUP' => 'Cuban Peso',
+      'CVE' => 'Cape Verde Escudo',
+      'CYP' => 'Cyprus Pound',
+      'CZK' => 'Czech Koruna',
+      'DJF' => 'Djibouti Franc',
+      'DKK' => 'Danish Krone',
+      'DOP' => 'Dominican Peso',
+      'DZD' => 'Algerian Dinar',
+      'EEK' => 'Kroon',
+      'EGP' => 'Egyptian Pound',
+      'ERN' => 'Nakfa',
+      'ETB' => 'Ethiopian Birr',
+      'EUR' => 'Euro',
+      'FJD' => 'Fiji Dollar',
+      'FKP' => 'Falkland Islands Pound',
+      'GBP' => 'Pound Sterling',
+      'GEL' => 'Lari',
+      'GHS' => 'Cedi',
+      'GIP' => 'Gibraltar pound',
+      'GMD' => 'Dalasi',
+      'GNF' => 'Guinea Franc',
+      'GTQ' => 'Quetzal',
+      'GYD' => 'Guyana Dollar',
+      'HKD' => 'Hong Kong Dollar',
+      'HNL' => 'Lempira',
+      'HRK' => 'Croatian Kuna',
+      'HTG' => 'Haiti Gourde',
+      'HUF' => 'Forint',
+      'IDR' => 'Rupiah',
+      'ILS' => 'New Israeli Shekel',
+      'INR' => 'Indian Rupee',
+      'IQD' => 'Iraqi Dinar',
+      'IRR' => 'Iranian Rial',
+      'ISK' => 'Iceland Krona',
+      'JMD' => 'Jamaican Dollar',
+      'JOD' => 'Jordanian Dinar',
+      'JPY' => 'Japanese yen',
+      'KES' => 'Kenyan Shilling',
+      'KGS' => 'Som',
+      'KHR' => 'Riel',
+      'KMF' => 'Comoro Franc',
+      'KPW' => 'North Korean Won',
+      'KRW' => 'South Korean Won',
+      'KWD' => 'Kuwaiti Dinar',
+      'KYD' => 'Cayman Islands Dollar',
+      'KZT' => 'Tenge',
+      'LAK' => 'Kip',
+      'LBP' => 'Lebanese Pound',
+      'LKR' => 'Sri Lanka Rupee',
+      'LRD' => 'Liberian Dollar',
+      'LSL' => 'Loti',
+      'LTL' => 'Lithuanian Litas',
+      'LVL' => 'Latvian Lats',
+      'LYD' => 'Libyan Dinar',
+      'MAD' => 'Moroccan Dirham',
+      'MDL' => 'Moldovan Leu',
+      'MGA' => 'Malagasy Ariary',
+      'MKD' => 'Denar',
+      'MMK' => 'Kyat',
+      'MNT' => 'Tugrik',
+      'MOP' => 'Pataca',
+      'MRO' => 'Ouguiya',
+      'MTL' => 'Maltese Lira',
+      'MUR' => 'Mauritius Rupee',
+      'MVR' => 'Rufiyaa',
+      'MWK' => 'Kwacha',
+      'MXN' => 'Mexican Peso',
+      'MXV' => 'Mexican Unidad de Inversion (UDI) (Funds code)',
+      'MYR' => 'Malaysian Ringgit',
+      'MZN' => 'Metical',
+      'NAD' => 'Namibian Dollar',
+      'NGN' => 'Naira',
+      'NIO' => 'Cordoba Oro',
+      'NOK' => 'Norwegian Krone',
+      'NPR' => 'Nepalese Rupee',
+      'NZD' => 'New Zealand Dollar',
+      'OMR' => 'Rial Omani',
+      'PAB' => 'Balboa',
+      'PEN' => 'Nuevo Sol',
+      'PGK' => 'Kina',
+      'PHP' => 'Philippine Peso',
+      'PKR' => 'Pakistan Rupee',
+      'PLN' => 'Zloty',
+      'PYG' => 'Guarani',
+      'QAR' => 'Qatari Rial',
+      'RON' => 'Romanian New Leu',
+      'RSD' => 'Serbian Dinar',
+      'RUB' => 'Russian Ruble',
+      'RWF' => 'Rwanda Franc',
+      'SAR' => 'Saudi Riyal',
+      'SBD' => 'Solomon Islands Dollar',
+      'SCR' => 'Seychelles Rupee',
+      'SDG' => 'Sudanese Pound',
+      'SEK' => 'Swedish Krona',
+      'SGD' => 'Singapore Dollar',
+      'SHP' => 'Saint Helena Pound',
+      'SKK' => 'Slovak Koruna',
+      'SLL' => 'Leone',
+      'SOS' => 'Somali Shilling',
+      'SRD' => 'Surinam Dollar',
+      'STD' => 'Dobra',
+      'SYP' => 'Syrian Pound',
+      'SZL' => 'Lilangeni',
+      'THB' => 'Baht',
+      'TJS' => 'Somoni',
+      'TMM' => 'Manat',
+      'TND' => 'Tunisian Dinar',
+      'TOP' => 'Pa\'anga',
+      'TRY' => 'New Turkish Lira',
+      'TTD' => 'Trinidad and Tobago Dollar',
+      'TWD' => 'New Taiwan Dollar',
+      'TZS' => 'Tanzanian Shilling',
+      'UAH' => 'Hryvnia',
+      'UGX' => 'Uganda Shilling',
+      'USD' => 'US Dollar',
+      'USN' => '',
+      'USS' => '',
+      'UYU' => 'Peso Uruguayo',
+      'UZS' => 'Uzbekistan Som',
+      'VEB' => 'Venezuelan bolivar',
+      'VND' => 'Vietnamese dong',
+      'VUV' => 'Vatu',
+      'WST' => 'Samoan Tala',
+      'XAF' => 'CFA Franc BEAC',
+      'XAG' => 'Silver (one Troy ounce)',
+      'XAU' => 'Gold (one Troy ounce)',
+      'XBA' => 'European Composite Unit (EURCO) (Bonds market unit)',
+      'XBB' => 'European Monetary Unit (E.M.U.-6) (Bonds market unit)',
+      'XBC' => 'European Unit of Account 9 (E.U.A.-9) (Bonds market unit)',
+      'XBD' => 'European Unit of Account 17 (E.U.A.-17) (Bonds market unit)',
+      'XCD' => 'East Caribbean Dollar',
+      'XDR' => 'Special Drawing Rights',
+      'XFO' => 'Gold franc (special settlement currency)',
+      'XFU' => 'UIC franc (special settlement currency)',
+      'XOF' => 'CFA Franc BCEAO',
+      'XPD' => 'Palladium (one Troy ounce)',
+      'XPF' => 'CFP franc',
+      'XPT' => 'Platinum (one Troy ounce)',
+      'XTS' => 'Code reserved for testing purposes',
+      'XXX' => 'No currency',
+      'YER' => 'Yemeni Rial',
+      'ZAR' => 'South African Rand',
+      'ZMK' => 'Kwacha',
+      'ZWD' => 'Zimbabwe Dollar'
+    }
+  end
+end

data/lib/ccy_convertor/exception.rb

@@ -0,0 +1,9 @@
+module CcyConvertor
+  class NoApiKeyPresent < StandardError; end
+
+  class InvalidAmount < StandardError; end
+
+  class InvalidCurrencyCode < StandardError; end
+
+  class CurrencyNotSupported < StandardError; end
+end

data/lib/ccy_convertor/extension.rb

@@ -0,0 +1,5 @@
+class Numeric
+  CcyConvertor::Constant::CCY_CODE_AND_NAME.each do |code, name|
+    define_method(code.downcase) { CcyConvertor::Money.new(code, self) }
+  end
+end

data/lib/ccy_convertor/money.rb

@@ -0,0 +1,21 @@
+module CcyConvertor
+  class Money
+    attr_accessor :code, :name, :amount
+
+    def initialize(code, amount)
+      @code = code
+      @amount = amount
+    end
+
+    def name
+      CcyConvertor::Constant::CCY_CODE_AND_NAME[code]
+    end
+
+    CcyConvertor::Constant::CCY_CODE_AND_NAME.each do |code, name|
+      define_method("to_#{code.downcase}") do |options = {}|
+        options.merge!(money: self, to_ccy: code)
+        CcyConvertor.convert(options)
+      end
+    end
+  end
+end

data/lib/ccy_convertor/process_and_validate_option.rb

@@ -0,0 +1,45 @@
+module CcyConvertor
+  module ProcessAndValidateOption
+    def process_options!(options)
+      unless options[:money].nil?
+        options.merge!(from_ccy: options[:money].code, amount: options[:money].amount)
+      end
+    end
+
+    def validate_options!(options)
+      validate_presence_of_hash_keys!(options, [:from_ccy, :to_ccy, :amount])
+      validate_amount!(options[:amount])
+      validate_currency_codes!([options[:from_ccy], options[:to_ccy]])
+    end
+
+    def validate_presence_of_hash_keys!(options, keys)
+      options_not_provided = keys - options.keys
+      if options_not_provided.count != 0
+        raise ArgumentError,
+          "argument hash should have #{options_not_provided.join(', ')} #{options_not_provided.count > 1 ? 'keys' : 'key'}"
+      end
+    end
+
+    def validate_amount!(amount)
+      unless amount.is_a?(Numeric)
+        raise CcyConvertor::InvalidAmount, 'options[:amount] must be a number'
+      end
+    end
+
+    def validate_currency_codes!(currency_codes)
+      currency_codes.each do |code|
+        unless CcyConvertor::Constant::CCY_CODE_AND_NAME[code]
+          raise CcyConvertor::InvalidCurrencyCode, "Currency code '#{code}' doesn't exists"
+        end
+      end
+    end
+
+    def validate_currency_support!(currencies, rate_matrix)
+      currencies.each do |ccy|
+        if rate_matrix[ccy].nil?
+          raise CcyConvertor::CurrencyNotSupported, "Currency '#{ccy}' is not supported by OpenExchangeRate"
+        end
+      end
+    end
+  end
+end

data/lib/ccy_convertor/rate_cache.rb

@@ -0,0 +1,28 @@
+module CcyConvertor
+  module RateCache
+    attr_writer :cache_duration
+
+    def cache
+      @cache ||= {}
+      @cache[rate_provider_name] ||= ActiveSupport::Cache::MemoryStore.new(expires_in: cache_duration)
+    end
+
+    def cache_duration
+      @cache_duration ||= if cache_duration_nil?
+        0
+      else
+        CcyConvertor.configuration.cache_duration[rate_provider_name]
+      end
+    end
+
+    def cache_duration_nil?
+      @cache_duration.nil? &&
+      (CcyConvertor.configuration.cache_duration.nil? ||
+      CcyConvertor.configuration.cache_duration[rate_provider_name].nil?)
+    end
+
+    def cache_key(request_url)
+      Digest::SHA2.hexdigest request_url
+    end
+  end
+end

data/lib/ccy_convertor/rate_providers/json_rate.rb

@@ -0,0 +1,13 @@
+module CcyConvertor
+  class JSONRate < CcyConvertor::RateProvider
+    class << self
+      def rest_url_for_rate_matrix(base_ccy)
+        "http://jsonrates.com/get/?apiKey=#{api_key}&base=#{base_ccy || 'USD'}"
+      end
+
+      def rate_matrix(base_ccy = nil)
+        JSON.parse(rate_matrix_response(base_ccy))['rates']
+      end
+    end
+  end
+end

data/lib/ccy_convertor/rate_providers/open_exchange_rate.rb

@@ -0,0 +1,13 @@
+module CcyConvertor
+  class OpenExchangeRate < CcyConvertor::RateProvider
+    class << self
+      def rest_url_for_rate_matrix(base_ccy = nil)
+        "https://openexchangerates.org/api/latest.json?app_id=#{api_key}"
+      end
+
+      def rate_matrix
+        rate_matrix_response['rates']
+      end
+    end
+  end
+end

data/lib/ccy_convertor/rate_providers/rate_provider.rb

@@ -0,0 +1,58 @@
+module CcyConvertor
+  class RateProvider
+    extend CcyConvertor::RateCache
+    extend CcyConvertor::ProcessAndValidateOption
+
+    class << self
+      attr_writer :api_key
+
+      def api_key
+        if api_key_nil?
+          raise CcyConvertor::NoApiKeyPresent, "api_key not set for #{name}"
+        end
+        @api_key ||= CcyConvertor.configuration.api_keys[rate_provider_name]
+      end
+
+      def api_key_nil?
+        @api_key.nil? &&
+        (CcyConvertor.configuration.api_keys.nil? ||
+        CcyConvertor.configuration.api_keys[rate_provider_name].nil?)
+      end
+
+      def rate_provider_name
+        self.name.demodulize.underscore.to_sym
+      end
+
+      def response_hash(request_url)
+        cache_key = cache_key(request_url)
+        return cache.read(cache_key) if cache.exist?(cache_key)
+        response = HTTParty.get(request_url).parsed_response
+        puts cache.write(cache_key, response, expires_in: cache_duration)
+        response
+      end
+
+      def rate_matrix_response(base_ccy = nil)
+        response_hash(rest_url_for_rate_matrix(base_ccy))
+      end
+
+      def rate_response(from_ccy, to_ccy)
+        response_hash(rest_url_for_rate(from_ccy, to_ccy))
+      end
+
+      def rate_from_rate_matrix(from_ccy, to_ccy)
+        rate_matrix = rate_matrix()
+        validate_currency_support!([from_ccy, to_ccy], rate_matrix)
+        rate_matrix[from_ccy].to_f / rate_matrix[to_ccy].to_f
+      end
+      alias :rate :rate_from_rate_matrix
+
+      def convert(options)
+        process_options!(options)
+        validate_options!(options)
+        converted_rate = options[:amount] * rate(options[:to_ccy], options[:from_ccy])
+        return converted_rate if CcyConvertor.configuration.round_up_amount.nil?
+        converted_rate.round(CcyConvertor.configuration.round_up_amount)
+      end
+    end
+  end
+end

data/lib/ccy_convertor/rate_providers/yahoo_finance.rb

@@ -0,0 +1,19 @@
+module CcyConvertor
+  class YahooFinance < CcyConvertor::RateProvider
+    class << self
+      def rest_url_for_rate(from_ccy, to_ccy)
+        'https://query.yahooapis.com/v1/public/yql?q='\
+        "select%20%20Rate%20from%20yahoo.finance.xchange%20where%20pair%20in%20(%22#{to_ccy}#{from_ccy}%22)"\
+        '&format=json&env=store%3A%2F%2Fdatatables.org%2Falltableswithkeys'
+      end
+
+      def rate(from_ccy, to_ccy)
+        rate = rate_response(from_ccy, to_ccy)['query']['results']['rate']['Rate']
+        if rate.nil? || rate == 'N/A'
+          raise CcyConvertor::CurrencyNotSupported, "No rates available for #{from_ccy}/#{to_ccy}"
+        end
+        rate.to_f
+      end
+    end
+  end
+end

data/lib/ccy_convertor/version.rb

@@ -0,0 +1,3 @@
+module CcyConvertor
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: ccy_convertor
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Rohan Pujari
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: CcyConvertor provides live currency rate for various currencies and allows
+  to convert money from one currency to other. Currently it supports 3 rate provider.
+  New rate provider can be easily plugged in
+email:
+- rohanpujaris@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ccy_convertor.gemspec
+- lib/ccy_convertor.rb
+- lib/ccy_convertor/configuration.rb
+- lib/ccy_convertor/constant.rb
+- lib/ccy_convertor/exception.rb
+- lib/ccy_convertor/extension.rb
+- lib/ccy_convertor/money.rb
+- lib/ccy_convertor/process_and_validate_option.rb
+- lib/ccy_convertor/rate_cache.rb
+- lib/ccy_convertor/rate_providers/json_rate.rb
+- lib/ccy_convertor/rate_providers/open_exchange_rate.rb
+- lib/ccy_convertor/rate_providers/rate_provider.rb
+- lib/ccy_convertor/rate_providers/yahoo_finance.rb
+- lib/ccy_convertor/version.rb
+homepage: https://github.com/rohanpujaris/ccy_convertor
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: CcyConvertor provides live currency rate for various currencies and allows
+  to convert money from one currency to other
+test_files: []