national_bank_of_romania 0.0.1

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/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.0.1
+
+* initial release

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Vlad Suciu
+
+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,77 @@
+# NationalBankOfRomania
+
+
+This gem provides the ability to download the exchange rates from the National Bank of Romania and it is compatible with the [money gem](https://github.com/RubyMoney/money/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'national_bank_of_romania'    
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install national_bank_of_romania
+
+## Dependencies
+
+* nokogiri
+* money
+
+## Usage
+
+You can use it together with the money gem. The money gem accepts an exchange bank object:
+
+	ro_bank = NationalBankOfRomania::Bank.new
+	
+	# scrapes bnr.ro for the current rates
+	ro_bank.update_rates
+	
+	# change the default bank
+	Money.default_bank = ro_bank
+	
+	# exchange API examples
+	Money.us_dollar(100).exchange_to("CAD")
+	# or
+	money1 = Money.new(100, "RON")
+	money1.exchange_to("RON")
+
+Calling ```update_rates``` will automatically populate the object with the rates from the National Bank of Romania's official website. 
+
+The gem is a wrapper around the money library therefore you can simply use it like so:
+
+	ro_bank = NationalBankOfRomania::Bank.new
+	
+	# scrapes bnr.ro for the current rates
+	ro_bank.update_rates
+	
+	# exchange 100 RON to USD
+	ro_bank.exchange(100, "RON", "USD")
+	
+### Performance Considerations
+
+The currency rates are updated once a day hence that it makes sense to save them in a file.
+
+	# saves the rates in a specified location
+	ro_bank = NationalBankOfRomania::Bank.new
+	ro_bank.save_rates("/path/to/rates.xml")
+	
+	# calling update_rates with a path to load the rates from
+	ro_bank.update_rates("/path/to/rates.xml")
+	
+
+## Contributing
+
+1. Fork it
+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 new Pull Request
+
+## Special Thanks
+
+NationalBankOfRomania was inspired by [eu_central_bank](https://github.com/RubyMoney/eu_central_bank) and they would both not be possible without the popular [money gem](https://github.com/RubyMoney/money/).

data/Rakefile

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

data/lib/bank.rb

@@ -0,0 +1,45 @@
+require "money"
+module NationalBankOfRomania
+
+  class Bank < ::Money::Bank::VariableExchange
+    attr_accessor :last_updated
+
+    RATES_URL = "http://www.bnro.ro/nbrfxrates.xml"
+    CURRENCIES = %w(AED AUD BGN BRL CAD CHF CNY CZK DKK EGP EUR GBP HUF INR JPY
+                    KRW MDL MXN NOK NZD PLN RSD RUB SEK TRY UAH USD ZAR)
+
+    def save_rates(path_to_file)
+      cache.save(path_to_file)
+    end
+
+    def update_rates(path_to_file = nil)
+      exchange_rates(path_to_file).each do |rate|
+        next unless CURRENCIES.include?(rate[:currency])
+        add_rate("RON", rate[:currency], rate[:value])
+      end
+
+      add_rate("RON", "RON", 1)
+      @last_updated = Time.now
+    end
+
+    def exchange(cents, from_currency, other_currency)
+      from_currency = Money.new(cents, from_currency)
+      other_currency = Money::Currency.wrap(other_currency)
+      exchange_with(from_currency, other_currency)
+    end
+
+    def parser
+      @parser ||= Parser.new(RATES_URL)
+    end
+
+    def cache
+      @cache ||= Cache.new(RATES_URL)
+    end
+
+    private
+      def exchange_rates(path_to_file = nil)
+        parser.records(path_to_file)
+      end
+  end
+end
+

data/lib/cache.rb

@@ -0,0 +1,21 @@
+require "open-uri"
+
+module NationalBankOfRomania
+  class InvalidCache < StandardError ; end
+  class Cache
+    attr_reader :url
+
+    def initialize(url)
+      @url = url
+    end
+
+    def save(path_to_file)
+      raise InvalidCache unless path_to_file
+
+      File.open(path_to_file, "w") do |file|
+        io = open(url) ;
+        io.each_line {|line| file.puts line}
+      end
+    end
+  end
+end

data/lib/national_bank_of_romania.rb

@@ -0,0 +1,5 @@
+require "national_bank_of_romania/version"
+
+require "bank"
+require "parser"
+require "cache"

data/lib/national_bank_of_romania/version.rb

@@ -0,0 +1,3 @@
+module NationalBankOfRomania
+  VERSION = "0.0.1"
+end

data/lib/parser.rb

@@ -0,0 +1,26 @@
+require "nokogiri"
+
+module NationalBankOfRomania
+  class Parser
+    attr_reader :url
+
+    def initialize(url)
+      @url = url
+      @records = nil
+    end
+
+    def records(cache)
+      source = !!cache ? cache : url
+      doc = Nokogiri::XML(open(source))
+      @records = doc.root.elements[1].elements[2].elements
+      formatted_records
+    end
+
+    private
+      def formatted_records
+        @records.map do |row|
+          { currency: row.attribute("currency").value, value: row.text.to_f }
+        end
+      end
+  end
+end

data/mvim

@@ -0,0 +1 @@
+/Users/vladsuciu/.rbenv/versions/1.9.3-p362/lib/ruby/gems/1.9.1/gems/money-5.1.0

data/national_bank_of_romania.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'national_bank_of_romania/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "national_bank_of_romania"
+  gem.version       = NationalBankOfRomania::VERSION
+  gem.authors       = ["Vlad Suciu"]
+  gem.email         = ["suciu.vlad@gmail.com"]
+  gem.description   = %q{This gem provides the ability to download the exchange rates from the National Bank of Romania and it is compatible with the money gem.}
+  gem.summary       = %q{This gem provides the ability to download the exchange rates from the National Bank of Romania and it is compatible with the money gem.}
+  gem.homepage      = ""
+
+  gem.add_dependency "nokogiri", "~> 1.5.6"
+  gem.add_dependency "money", "~> 5.1.0"
+
+  gem.add_development_dependency "rspec", ">= 2.12.0"
+  gem.add_development_dependency "rake"
+
+  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.require_paths = ["lib"]
+end

data/spec/bank_spec.rb

@@ -0,0 +1,63 @@
+require "spec_helper"
+require "national_bank_of_romania"
+
+describe "Bank" do
+
+  before(:each) do
+    @bank = NationalBankOfRomania::Bank.new
+    @feed = File.expand_path(File.dirname(__FILE__) + '/fixtures/nbrfxrates.xml')
+    @tmp = File.expand_path(File.dirname(__FILE__) + '/fixtures/tmp_nbrfxrates.xml')
+
+    @yml = File.expand_path(File.dirname(__FILE__) + '/fixtures/exchange_rates.yml')
+    @exchange_rates = YAML.load_file(@yml)
+
+    @bank.stub(:open).and_return(File.read(@feed))
+  end
+
+  it "calls 'save' on the Cache" do
+    @bank.cache.should_receive(:save).with(@tmp)
+    @bank.save_rates(@tmp)
+  end
+
+  context "#update_rates" do
+    it "from BNR unless a local feed is given" do
+      @bank.update_rates
+
+      NationalBankOfRomania::Bank::CURRENCIES.each do |currency|
+        @bank.get_rate("RON", currency).should > 0
+      end
+    end
+
+    it "from cache if a local feed is given" do
+      @bank.update_rates(@feed)
+
+      NationalBankOfRomania::Bank::CURRENCIES.each do |currency|
+        @bank.get_rate("RON", currency).should > 0
+      end
+    end
+  end
+
+  it "should set last_updated when the rates are updated" do
+    bank1 = @bank.last_updated
+    @bank.update_rates(@feed)
+
+    bank2 = @bank.last_updated
+    @bank.update_rates(@feed)
+
+    bank3 = @bank.last_updated
+
+    bank1.should_not eq(bank2)
+    bank2.should_not eq(bank3)
+  end
+
+  it "should return the correct exchange rates using exchange" do
+    @bank.update_rates(@feed)
+
+    NationalBankOfRomania::Bank::CURRENCIES.each do |currency|
+      subunit = Money::Currency.wrap(currency).subunit_to_unit.to_s.scan(/0/).count
+      value = BigDecimal.new(@exchange_rates["currencies"][currency].to_s).truncate(subunit.to_i).to_f
+      @bank.exchange(100, "RON", currency).to_f.should == value
+    end
+  end
+
+end

data/spec/cache_spec.rb

@@ -0,0 +1,32 @@
+require "spec_helper"
+require "cache"
+
+describe "cache" do
+
+  before(:each) do
+    @bank = NationalBankOfRomania::Bank.new
+    @feed = File.expand_path(File.dirname(__FILE__) + '/fixtures/nbrfxrates.xml')
+    @tmp = File.expand_path(File.dirname(__FILE__) + '/fixtures/tmp_nbrfxrates.xml')
+
+    @bank.stub(:open).and_return(File.read(@feed))
+  end
+
+  after(:each) do
+    if File.exists? @tmp
+      File.delete @tmp
+    end
+  end
+
+  context "#save" do
+    it "the xml file given a file path" do
+      @bank.save_rates(@tmp)
+      File.exists?(@tmp).should === true
+    end
+
+    it "raise an error if an invalid path is given" do
+      lambda { @bank.save_rates(nil) }.should raise_exception
+    end
+  end
+
+
+end

data/spec/fixtures/exchange_rates.yml

@@ -0,0 +1,31 @@
+currencies:
+  AED: 0.8830
+  AUD: 3.4109
+  BGN: 2.2165
+  BRL: 1.5876
+  CAD: 3.2824
+  CHF: 3.4827
+  CNY: 0.5217
+  CZK: 0.1696
+  DKK: 0.5809
+  EGP: 0.4912
+  EUR: 4.3351
+  GBP: 5.1961
+  HUF: 1.4812
+  INR: 0.0597
+  JPY: 3.6283
+  KRW: 0.3065
+  MDL: 0.2672
+  MXN: 0.2575
+  NOK: 0.5843
+  NZD: 2.7223
+  PLN: 1.0517
+  RSD: 0.0386
+  RUB: 0.1073
+  SEK: 0.5007
+  TRY: 1.8461
+  UAH: 0.3991
+  USD: 3.2431
+  XAU: 175.6294
+  XDR: 4.9900
+  ZAR: 0.3697

data/spec/fixtures/nbrfxrates.xml

@@ -0,0 +1,45 @@
+
+<?xml version="1.0" encoding="utf-8"?>
+<DataSet xmlns="http://www.bnr.ro/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.bnr.ro/xsd nbrfxrates.xsd">
+	<Header>
+		<Publisher>National Bank of Romania</Publisher>
+		<PublishingDate>2013-01-17</PublishingDate>
+		<MessageType>DR</MessageType>
+	</Header>
+	<Body>
+		<Subject>Reference rates</Subject>
+		<OrigCurrency>RON</OrigCurrency>
+		<Cube date="2013-01-17">
+			<Rate currency="AED">0.8830</Rate>
+			<Rate currency="AUD">3.4109</Rate>
+			<Rate currency="BGN">2.2165</Rate>
+			<Rate currency="BRL">1.5876</Rate>
+			<Rate currency="CAD">3.2824</Rate>
+			<Rate currency="CHF">3.4827</Rate>
+			<Rate currency="CNY">0.5217</Rate>
+			<Rate currency="CZK">0.1696</Rate>
+			<Rate currency="DKK">0.5809</Rate>
+			<Rate currency="EGP">0.4912</Rate>
+			<Rate currency="EUR">4.3351</Rate>
+			<Rate currency="GBP">5.1961</Rate>
+			<Rate currency="HUF" multiplier="100">1.4812</Rate>
+			<Rate currency="INR">0.0597</Rate>
+			<Rate currency="JPY" multiplier="100">3.6283</Rate>
+			<Rate currency="KRW" multiplier="100">0.3065</Rate>
+			<Rate currency="MDL">0.2672</Rate>
+			<Rate currency="MXN">0.2575</Rate>
+			<Rate currency="NOK">0.5843</Rate>
+			<Rate currency="NZD">2.7223</Rate>
+			<Rate currency="PLN">1.0517</Rate>
+			<Rate currency="RSD">0.0386</Rate>
+			<Rate currency="RUB">0.1073</Rate>
+			<Rate currency="SEK">0.5007</Rate>
+			<Rate currency="TRY">1.8461</Rate>
+			<Rate currency="UAH">0.3991</Rate>
+			<Rate currency="USD">3.2431</Rate>
+			<Rate currency="XAU">175.6294</Rate>
+			<Rate currency="XDR">4.9900</Rate>
+			<Rate currency="ZAR">0.3697</Rate>
+		</Cube>
+	</Body>
+</DataSet>

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: national_bank_of_romania
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Vlad Suciu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.6
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem provides the ability to download the exchange rates from the
+  National Bank of Romania and it is compatible with the money gem.
+email:
+- suciu.vlad@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/bank.rb
+- lib/cache.rb
+- lib/national_bank_of_romania.rb
+- lib/national_bank_of_romania/version.rb
+- lib/parser.rb
+- mvim
+- national_bank_of_romania.gemspec
+- spec/bank_spec.rb
+- spec/cache_spec.rb
+- spec/fixtures/exchange_rates.yml
+- spec/fixtures/nbrfxrates.xml
+- spec/spec_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
+      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.23
+signing_key: 
+specification_version: 3
+summary: This gem provides the ability to download the exchange rates from the National
+  Bank of Romania and it is compatible with the money gem.
+test_files:
+- spec/bank_spec.rb
+- spec/cache_spec.rb
+- spec/fixtures/exchange_rates.yml
+- spec/fixtures/nbrfxrates.xml
+- spec/spec_helper.rb