dejan-kurs 0.0.1 → 0.0.2

data/README.rdoc

@@ -13,15 +13,25 @@ http://www.nbs.yu/internet/latinica/scripts/ondate.html
 
 == Instalacija
 
-	sudo gem install dejan-kurs --source http://gems.github.com
+  sudo gem install dejan-kurs --source http://gems.github.com
 
 == Korišćenje
 
-	require "rubygems"
-	require "kurs"
-
-	Kurs.convert(2500, :usd => :eur)
+  require "rubygems"
+  require "kurs"
+  
+  >> Kurs.currency_codes
+  => ["RSD", "EUR", "AUD", "CAD", "HRK", "CZK", "DKK", "HUF", "JPY", "KWD", "NOK", "SEK", "CHF", "GBP", "USD", "BAM", "PLN", "ATS", "BEF", "FIM", "FRF", "DEM", "GRD", "IEP", "ITL", "LUF", "PTE", "ESP"]
+  
+  >> Kurs.rate_for(:eur) # moze i "EUR" ili :EUR
+  => 93.8022
+  
+  >> Kurs.rate_for(:usd)
+  => 73.6802
+  
+  >> Kurs.convert(2500, :usd => :eur)
+  => 1963.71193852596
 
 == Autor
 
-Dejan Simic ~ http://rors.org
+{Dejan Simic}[http://rors.org]

data/README_en.rdoc

@@ -11,15 +11,25 @@ http://www.nbs.yu/internet/english/scripts/ondate.html
 
 == Install
 
-	sudo gem install dejan-kurs --source http://gems.github.com
+  sudo gem install dejan-kurs --source http://gems.github.com
 
 == Example usage
 
-	require "rubygems"
-	require "kurs"
-
-	Kurs.convert(2500, :usd => :eur)
+  require "rubygems"
+  require "kurs"
+  
+  >> Kurs.currency_codes
+  => ["RSD", "EUR", "AUD", "CAD", "HRK", "CZK", "DKK", "HUF", "JPY", "KWD", "NOK", "SEK", "CHF", "GBP", "USD", "BAM", "PLN", "ATS", "BEF", "FIM", "FRF", "DEM", "GRD", "IEP", "ITL", "LUF", "PTE", "ESP"]
+  
+  >> Kurs.rate_for(:eur) # will work with "EUR" or :EUR
+  => 93.8022
+  
+  >> Kurs.rate_for(:usd)
+  => 73.6802
+  
+  >> Kurs.convert(2500, :usd => :eur)
+  => 1963.71193852596
 
 == Author
 
-Dejan Simic ~ http://rors.org
+{Dejan Simic}[http://rors.org]

data/VERSION.yml

@@ -1,5 +1,5 @@
 --- 
 :major: 0
 :minor: 0
-:patch: 1
+:patch: 2
 

data/lib/kurs.rb

@@ -1,23 +1,49 @@
 require 'httparty'
 
 class Kurs
+
   include HTTParty
   base_uri "www.nbs.yu"
-  headers("User-Agent" => "kurs 0.0.1")
   format :xml
 
-  def self.rate_for(val)
-    kurs = Kurs.rate_list["kursna_lista"]["valuta"]
-    eur = kurs.detect { |v| v["sifra_alfa3"] == val.to_s.upcase }
-    eur["kupovni"].sub(',', '.').to_f
+  #
+  # This is important! 
+  # Without defined User-Agent nbs.yu returns status 404
+  #
+  headers("User-Agent" => "kurs")
+
+  #
+  # Value of provided currency in national currency (rsd)
+  #
+  # Example:
+  #
+  #   => Kurs.rate_for(:usd)
+  #   >> 75.2658
+  #
+  def self.rate_for(currency_code)
+    currency_code = currency_code.to_s.upcase
+    currency_code == 'RSD' ? 
+      1 : currency_value_in_rsd(currency(currency_code))
   end
 
+  #
+  # Converts money value from one currency to another
+  #
+  # Example:
+  #
+  #   => Kurs.convert(2500, :usd => :eur)
+  #   >> 1985.86099938682
+  #
   def self.convert(value, source_target_hash)
     source = source_target_hash.keys.first
     target = source_target_hash.values.first
     value * (rate_for(source) / rate_for(target))
   end
 
+  def self.currency_codes
+    ['RSD'] + currencies.map { |rate| rate['sifra_alfa3'] }
+  end
+
 private
 
   def self.rate_list
@@ -26,10 +52,23 @@ private
         :datum => self.strf_today,
         :eksport => "xml", 
         :lang => "sr",
-        :vrsta => "1"})
+        :vrsta => "3"})
+  end
+
+  def self.currency(currency_code)
+    currencies.detect { |v| v["sifra_alfa3"] == currency_code }
+  end
+
+  def self.currencies
+    rate_list["kursna_lista"]["valuta"]
+  end
+
+  def self.currency_value_in_rsd(currency)
+    currency["srednji"].sub(',', '.').to_f
   end
 
   def self.strf_today
     Time.now.strftime("%d.%m.%Y") # "21.03.2009"
   end
-end
+
+end

data/spec/fixtures/rate_list.rb

@@ -0,0 +1,11 @@
+module Fixtures
+
+  #
+  # Result is the hash that httparty returns
+  # after posting and parsing (format :xml)
+  #
+  def example_rate_list
+    {"kursna_lista"=>{"valuta"=>[{"sifra_alfa3"=>"EUR", "srednji"=>"94,7521", "sifra_num"=>"978", "naziv_zemlje"=>"Evropska unija", "paritet"=>"1"}, {"sifra_alfa3"=>"AUD", "srednji"=>"47,9636", "sifra_num"=>"36", "naziv_zemlje"=>"Australija", "paritet"=>"1"}, {"sifra_alfa3"=>"CAD", "srednji"=>"59,6150", "sifra_num"=>"124", "naziv_zemlje"=>"Kanada", "paritet"=>"1"}, {"sifra_alfa3"=>"HRK", "srednji"=>"12,6655", "sifra_num"=>"191", "naziv_zemlje"=>"Hrvatska", "paritet"=>"1"}, {"sifra_alfa3"=>"CZK", "srednji"=>"3,2805", "sifra_num"=>"203", "naziv_zemlje"=>"Češka Republika", "paritet"=>"1"}, {"sifra_alfa3"=>"DKK", "srednji"=>"12,7126", "sifra_num"=>"208", "naziv_zemlje"=>"Danska", "paritet"=>"1"}, {"sifra_alfa3"=>"HUF", "srednji"=>"31,1306", "sifra_num"=>"348", "naziv_zemlje"=>"Mađarska", "paritet"=>"100"}, {"sifra_alfa3"=>"JPY", "srednji"=>"79,9461", "sifra_num"=>"392", "naziv_zemlje"=>"Japan", "paritet"=>"100"}, {"sifra_alfa3"=>"KWD", "srednji"=>"256,3639", "sifra_num"=>"414", "naziv_zemlje"=>"Kuvajt", "paritet"=>"1"}, {"sifra_alfa3"=>"NOK", "srednji"=>"10,8519", "sifra_num"=>"578", "naziv_zemlje"=>"Norveška", "paritet"=>"1"}, {"sifra_alfa3"=>"SEK", "srednji"=>"8,5527", "sifra_num"=>"752", "naziv_zemlje"=>"Švedska", "paritet"=>"1"}, {"sifra_alfa3"=>"CHF", "srednji"=>"63,7332", "sifra_num"=>"756", "naziv_zemlje"=>"Švajcarska", "paritet"=>"1"}, {"sifra_alfa3"=>"GBP", "srednji"=>"107,0887", "sifra_num"=>"826", "naziv_zemlje"=>"Velika Britanija", "paritet"=>"1"}, {"sifra_alfa3"=>"USD", "srednji"=>"75,2658", "sifra_num"=>"840", "naziv_zemlje"=>"SAD", "paritet"=>"1"}, {"sifra_alfa3"=>"BAM", "srednji"=>"48,4460", "sifra_num"=>"977", "naziv_zemlje"=>"Bosna i Hercegovina", "paritet"=>"1"}, {"sifra_alfa3"=>"PLN", "srednji"=>"19,8230", "sifra_num"=>"985", "naziv_zemlje"=>"Poljska", "paritet"=>"1"}, {"sifra_alfa3"=>"ATS", "srednji"=>"6,8859", "sifra_num"=>"40", "naziv_zemlje"=>"Austrija", "paritet"=>"1"}, {"sifra_alfa3"=>"BEF", "srednji"=>"234,8843", "sifra_num"=>"56", "naziv_zemlje"=>"Belgija", "paritet"=>"100"}, {"sifra_alfa3"=>"FIM", "srednji"=>"15,9362", "sifra_num"=>"246", "naziv_zemlje"=>"Finska", "paritet"=>"1"}, {"sifra_alfa3"=>"FRF", "srednji"=>"14,4449", "sifra_num"=>"250", "naziv_zemlje"=>"Francuska", "paritet"=>"1"}, {"sifra_alfa3"=>"DEM", "srednji"=>"48,4460", "sifra_num"=>"280", "naziv_zemlje"=>"Nemačka", "paritet"=>"1"}, {"sifra_alfa3"=>"GRD", "srednji"=>"27,8069", "sifra_num"=>"300", "naziv_zemlje"=>"Grčka", "paritet"=>"100"}, {"sifra_alfa3"=>"IEP", "srednji"=>"120,3103", "sifra_num"=>"372", "naziv_zemlje"=>"Irska", "paritet"=>"1"}, {"sifra_alfa3"=>"ITL", "srednji"=>"4,8935", "sifra_num"=>"380", "naziv_zemlje"=>"Italija", "paritet"=>"100"}, {"sifra_alfa3"=>"LUF", "srednji"=>"234,8843", "sifra_num"=>"442", "naziv_zemlje"=>"Luksemburg", "paritet"=>"100"}, {"sifra_alfa3"=>"PTE", "srednji"=>"47,2621", "sifra_num"=>"620", "naziv_zemlje"=>"Portugalija", "paritet"=>"100"}, {"sifra_alfa3"=>"ESP", "srednji"=>"56,9472", "sifra_num"=>"724", "naziv_zemlje"=>"Španija", "paritet"=>"100"}], "zaglavlje"=>{"Copyright"=>"\n          S obzirom na tehničke mogućnosti mreže - Narodna banka Srbije ne može da tvrdi da su prezentovani podaci i informacije kompletni i pouzdani. Samo oni podaci i informacije koje se štampaju direktno sa računara Narodne banke Srbije (bez posredstva mreže) - pouzdani su, tačni i kompletni. Narodna banka Srbije ne odgovara za eventualnu štetu nastalu korišćenjem podataka sa ovog sajta. Narodna banka Srbije dozvoljava da se fajlovi sa njenog sajta snimaju, reprodukuju i distribuiraju - pod uslovom da se njihova sadržina ne menja i da se izvor svaki put vidljivo navede. Narodna banka Srbije upozorava da je zabranjena i nezakonita svaka neovlašćena promena podataka sa njenog sajta, njihovo brisanje ili uništenje, činjenje nedostupnim ili namerno izazvana šteta. Narodna banka Srbije zadržava sva prava.\n        ", "broj"=>"33", "datum_formiranja"=>"20.02.2009", "vrsta"=>"za zvanični srednji kurs dinara"}}}
+  end
+
+end

data/spec/kurs_spec.rb

@@ -0,0 +1,35 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe Kurs do
+
+  include Fixtures
+
+  describe 'rate_for' do
+    it "should be 1 for RSD" do
+      Kurs.rate_for(:rsd).should  == 1
+      Kurs.rate_for(:RSD).should  == 1
+      Kurs.rate_for('RSD').should == 1
+      Kurs.rate_for('rsd').should == 1
+    end
+  end
+
+  describe 'convert' do
+    it "should be product of value and division of source and target rate" do
+      Kurs.should_receive(:rate_for).with(:eur).twice.and_return 90
+      Kurs.should_receive(:rate_for).with(:usd).twice.and_return 80
+      Kurs.convert(1000, :eur => :usd).should == 1000 * (90 / 80)
+      Kurs.convert(1000, :usd => :eur).should == 1000 * (80 / 90)
+    end
+  end
+
+  describe "currency_codes" do
+    it "should be array where first element is 'RSD' and the rest are sifra_alfa3 values of currencies" do
+      Kurs.should_receive(:currencies).and_return([
+        mock(Object, :[] => "EUR"),
+        mock(Object, :[] => "USD"),
+        ])
+      Kurs.currency_codes.should == ["RSD", "EUR", "USD"]
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+
+require File.dirname(__FILE__) + '/../lib/kurs'
+require File.dirname(__FILE__) + '/fixtures/rate_list'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dejan-kurs
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Dejan Simic
@@ -9,10 +9,19 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-22 00:00:00 -08:00
+date: 2009-02-28 00:00:00 -08:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
 description: Ruby API for converting currency using official exchange rate list of National Bank Of Serbia
 email: desimic@gmail.com
 executables: []
@@ -27,6 +36,7 @@ files:
 - VERSION.yml
 - lib/kurs.rb
 - spec/fixtures
+- spec/fixtures/rate_list.rb
 - spec/kurs_spec.rb
 - spec/spec_helper.rb
 has_rdoc: true