money-ecb 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+*.swp
+.bundle

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+rvm:
+- 1.9.3
+- 2.0.0
+- 2.1.0
+install: bundle install --without development
+script: bundle exec rake test
+notifications:
+  email: false
+cache: bundler

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+gem 'money'
+gem 'rubyzip'
+
+group :test do
+  gem 'rspec'
+  gem 'rake'
+end
+
+group :development do
+  gem 'pry'
+end

data/README.rst

@@ -0,0 +1,85 @@
+money-ecb
+==========
+
+.. image:: https://travis-ci.org/ct-clearhaus/money-ecb.png?branch=master
+    :target: https://travis-ci.org/ct-clearhaus/money-ecb
+
+
+Introduction
+------------
+
+This gem is a RubyMoney bank that can exchange ``Money`` using rates from the
+ECB (European Central Bank).
+
+
+Installation
+------------
+
+.. code-block:: sh
+
+    gem install money-ecb
+
+Dependencies
+............
+
+- RubyMoney's ``money`` gem
+- ``rubyzip`` gem
+
+
+Example
+-------
+
+Using ``money`` and ``monetize``:
+
+.. code-block:: ruby
+
+    require 'money'
+    require 'money/bank/ecb'
+    require 'monetize/core_extensions'
+
+    Money.default_bank = Money::Bank::ECB.new('/tmp/ecb-fxr.cache')
+
+    puts '1 EUR'.to_money.exchange_to(:USD)
+
+If ``/tmp/ecb-fxr.cache`` is a valid CSV file with exchange rates, the rates
+will be used for conversion. If the file does not exist, new rates will be
+downloaded from the European Central Bank and stored in the file. To update the
+cache,
+
+.. code-block:: ruby
+
+    Money.default_bank.update
+
+
+Rounding
+--------
+
+By default, ``Money::Bank``'s will truncate. If you prefer to round, exchange
+methods will accept a block that will be yielded; that block is intended for
+rounding when exchanging (continuing from above):
+
+.. code-block:: ruby
+
+    puts '1 EUR'.to_money.exchange_to(:USD) {|x| x.round}
+
+
+Auto-update rates
+-----------------
+
+The European Central Bank publishes daily foreign exchange rates every day, and
+they should be available at 14:00 CET. To automatically update the cache, set
+``Money::Bank::ECB#auto_update = true``.
+
+
+Contribute
+----------
+
+* `Fork <https://github.com/ct-clearhaus/money-ecb/fork>`_
+* Clone
+* ``bundle install``
+* ``bundle exec rake test``
+* Make your changes
+* Test your changes
+* Create a Pull Request and check `Travis
+  <https://travis-ci.org/ct-clearhaus/money-ecb/pull_requests>`_
+* Enjoy!

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rspec/core/rake_task'
+
+task :default => :test
+
+desc 'Run all specs'
+RSpec::Core::RakeTask.new(:test) do |task|
+  task.pattern = './spec/**/*_spec.rb'
+  task.rspec_opts = '-fs --color'.split
+end

data/lib/money/bank/ecb.rb

@@ -0,0 +1,84 @@
+require 'rubygems'
+require 'money'
+require 'open-uri'
+require 'bigdecimal'
+require 'zip'
+require 'csv'
+
+class Money
+  module Bank
+    class ECBInvalidCache < StandardError; end
+
+    class ECB < Money::Bank::VariableExchange
+      RATES_URL = 'http://www.ecb.europa.eu/stats/eurofxref/eurofxref.zip'
+
+      def initialize(cache_filename, &rounding_method)
+        @cache_filename = cache_filename
+        setup
+      end
+
+      attr_accessor :auto_update
+
+      def setup
+        super
+        load_from_cachefile rescue update
+      end
+
+      def exchange_with(from, to, &rounding_method)
+        update if @auto_update and Time.now.utc > (@rates_date + 60*60*24)
+        super(from, to, &rounding_method)
+      end
+
+      def update
+        update_cachefile
+        load_from_cachefile
+      end
+
+      attr_reader :currencies
+      attr_reader :rates_date
+
+      protected
+
+      def update_cachefile
+        File.open(@cache_filename, 'w') do |cache_file|
+          Zip::InputStream.open(open(RATES_URL)) do |io|
+            io.get_next_entry
+            cache_file.puts(io.read)
+          end
+        end
+      end
+
+      # Load date and rates from the cache file.
+      #
+      # Be "loose" to accommodate for future changes in list of currencies etc.
+      def load_from_cachefile
+        csv = CSV.parse(File.open(@cache_filename).read, :headers => true)
+
+        pairs = Hash[csv.first.map{|x,y| [x.strip, y.strip]}]
+        pairs.delete('')
+        date_s = pairs.delete('Date')
+
+        @mutex.synchronize do
+          @rates_date = Time.parse(date_s + ' 14:00:00 UTC')
+
+          quotations = Hash[pairs.map{|cur,rate| [cur, BigDecimal.new(rate)]}]
+          quotations.delete('')
+
+          @currencies = quotations.keys
+
+          quotations.each do |currency, rate|
+            set_rate('EUR', currency, rate, :without_mutex => true)
+            set_rate(currency, 'EUR', 1/rate, :without_mutex => true)
+
+            quotations.each do |other_currency, other_rate|
+              next if currency == other_currency
+              set_rate(currency, other_currency, rate/other_rate, :without_mutex => true)
+            end
+          end
+        end
+
+        true
+      end
+    end
+  end
+end

data/money-ecb.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name        = 'money-ecb'
+  s.version     = '0.0.1'
+  s.summary     = 'Foreign exchange rates from the EU Central Bank (ECB).'
+  s.description = 'A Money::Bank that will fetch foreign exchange rates from the EU Central Bank (ECB).'
+  s.authors     = ['Casper Thomsen']
+  s.email       = 'ct@clearhaus.com'
+  s.homepage    = 'https://github.com/ct-clearhaus/money-ecb'
+  s.files       = `git ls-files`.split($/)
+
+  s.add_runtime_dependency('money', '~> 6.0.0')
+  s.add_runtime_dependency('rubyzip', '>= 1.0.0')
+end

data/spec/assets/good_rates.csv

@@ -0,0 +1,2 @@
+Date, USD, JPY, BGN, CZK, DKK, GBP, HUF, LTL, PLN, RON, SEK, CHF, NOK, HRK, RUB, TRY, AUD, BRL, CAD, CNY, HKD, IDR, INR, KRW, MXN, MYR, NZD, PHP, SGD, THB, ZAR, ILS, 
+30 January 2014, 1.3574, 139.28, 1.9558, 27.594, 7.4622, 0.82380, 310.97, 3.4528, 4.2312, 4.5110, 8.8347, 1.2233, 8.4680, 7.6605, 47.8025, 3.0808, 1.5459, 3.2955, 1.5176, 8.2302, 10.5421, 16551.39, 85.0840, 1469.53, 18.1111, 4.5417, 1.6624, 61.527, 1.7323, 44.745, 15.2700, 4.7416, 

data/spec/ecb_spec.rb

@@ -0,0 +1,112 @@
+require 'money/bank/ecb'
+
+describe 'ECB' do
+  before do
+    @assetsdir = File.dirname(__FILE__) + '/assets'
+    @tmpdir = File.dirname(__FILE__) + '/tmp'
+    %x{cp -r #{@assetsdir} #{@tmpdir}}
+  end
+
+  let(:bank) { Money::Bank::ECB.new(@tmpdir + '/good_rates.csv') }
+
+  after do
+    %x{rm -rf #{@tmpdir}}
+  end
+
+  describe '#currencies' do
+    subject(:currencies) { bank.currencies }
+
+    it 'should have 32 currencies' do
+      expect(currencies.length).to eq(32)
+    end
+  end
+
+  describe '#exchange_with' do
+    let(:good_rates) do
+      {
+        'USD' => 1.3574,  'JPY' => 139.28,   'BGN' => 1.9558,  'CZK' => 27.594,
+        'DKK' => 7.4622,  'GBP' => 0.82380,  'HUF' => 310.97,  'LTL' => 3.4528,
+        'PLN' => 4.2312,  'RON' => 4.5110,   'SEK' => 8.8347,  'CHF' => 1.2233,
+        'NOK' => 8.4680,  'HRK' => 7.6605,   'RUB' => 47.8025, 'TRY' => 3.0808,
+        'AUD' => 1.5459,  'BRL' => 3.2955,   'CAD' => 1.5176,  'CNY' => 8.2302,
+        'HKD' => 10.5421, 'IDR' => 16551.39, 'INR' => 85.0840, 'KRW' => 1469.53,
+        'MXN' => 18.1111, 'MYR' => 4.5417,   'NZD' => 1.6624,  'PHP' => 61.527,
+        'SGD' => 1.7323,  'THB' => 44.745,   'ZAR' => 15.2700, 'ILS' => 4.7416,
+      }
+    end
+
+    def fx(cents, from, to)
+      bank.exchange_with(Money.new(cents, from), to) {|x| x.floor}
+    end
+
+    it 'should exchange correctly from EUR' do
+      bank.currencies.each do |cur|
+        sub2u = Money::Currency.wrap(cur).subunit_to_unit
+
+        expect(fx(100, 'EUR', cur).cents).to eq((good_rates[cur]*sub2u).floor)
+      end
+    end
+
+    it 'should exchange correctly to EUR' do
+      bank.currencies.each do |cur|
+        sub2u = Money::Currency.wrap(cur).subunit_to_unit
+
+        factor = 1000 # To ensure non-zero values.
+        expect(fx(factor*sub2u, cur, 'EUR').cents).to eq((factor*1/good_rates[cur]*100).floor)
+      end
+    end
+
+    it 'should exchange correctly between non-EUR currencies'
+  end
+
+  describe '#update' do
+    it 'should update rates from ECB' do
+      expect(bank).to receive(:open).with(Money::Bank::ECB::RATES_URL).and_return(
+        File.expand_path(@tmpdir + '/eurofxref.zip'))
+
+      expect(bank.rates_date).to eq(Time.utc(2014, 01, 30, 14))
+      bank.update
+      expect(bank.rates_date).to eq(Time.utc(2014, 01, 31, 14))
+    end
+  end
+
+  describe '#new' do
+    context 'when cache file is good' do
+      it 'should fetch use rates from cache'
+    end
+
+    context 'when cache file is bogus' do
+      it 'should fetch rates from ECB'
+    end
+  end
+
+  describe '#auto_update' do
+    it 'should be off by default' do
+      expect(bank.auto_update).to be_nil
+    end
+  end
+
+  context 'when auto_update is on' do
+    before(:each) { bank.auto_update = true }
+
+    context 'and cache file is new enough' do
+      describe '#exchange_with' do
+        it 'should not update cache' do
+          expect(Time).to receive(:now).and_return(bank.rates_date + 60*60*23)
+          expect(bank).not_to receive(:update)
+          bank.exchange_with(Money.new(100, :EUR), :USD)
+        end
+      end
+    end
+
+    context 'and cache file is old' do
+      describe '#exchange_with' do
+        it 'should update cache' do
+          expect(Time).to receive(:now).and_return(bank.rates_date + 60*60*25)
+          expect(bank).to receive(:update)
+          bank.exchange_with(Money.new(100, :EUR), :USD)
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: money-ecb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Casper Thomsen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: A Money::Bank that will fetch foreign exchange rates from the EU Central
+  Bank (ECB).
+email: ct@clearhaus.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.rst
+- Rakefile
+- lib/money/bank/ecb.rb
+- money-ecb.gemspec
+- spec/assets/eurofxref.zip
+- spec/assets/good_rates.csv
+- spec/ecb_spec.rb
+homepage: https://github.com/ct-clearhaus/money-ecb
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Foreign exchange rates from the EU Central Bank (ECB).
+test_files: []
+has_rdoc: