currency_switcher 0.0.1

data.tar.gz.sig

@@ -0,0 +1,2 @@
+{7�O�ǬӕI��)�"�8���w�<@j5��Tdq�������j�Q
+Eq��׼eE�^q`�P��O�"�n���f�c򐥻��c��_i
��G�6�$�U=I� !��)����XNHWb��L�
P�(��\�4�h��	KB��r�?ԙ}��MX�w8k�-�ǣ�+a�DY}f�r��в��;�HxH[�7��s�
�an}H�uv��P�:6g�{4B������hW�7���E�U;�?E

data/Manifest

@@ -0,0 +1,10 @@
+README.md
+Rakefile
+lib/currency_switcher.rb
+lib/currency_switcher/currencies.rb
+lib/currency_switcher/ext/fixnum.rb
+test/helper.rb
+test/html/eur_to_usd.html
+test/html/usd_to_gbp.html
+test/test_currency_switcher.rb
+Manifest

data/README.md

@@ -0,0 +1,143 @@
+# Currency Switcher
+
+## Description
+
+This is a small library that converts currencies using exchange rates from http://exchange-rates.org web site.
+
+## Installation
+
+$ gem install currency_switcher
+
+## Usage
+
+From the available list of currencies you can create methods in a format specified below and call them on Fixnums:
+
+	'from_currency'_to_'to_currency'
+
+For example:
+
+	require 'currency_switcher'
+	3.usd_to_gbp # => converts 3 USD to GBP and returns 1.94
+	15.eur_to_aud # => converts 15 EURO to Australian Dollar and returns 19.61
+	
+## Available Currencies
+
+	aed => United Arab Emirates Dirham
+	amd => Armenian Dram
+	ang => Netherlands Antillian Guilder
+	ars => Argentine Peso
+	aud => Australian Dollar
+	bbd => Barbados Dollar
+	bdt => Bangladeshi Taka
+	bgn => Bulgarian Lev
+	bhd => Bahraini Dinar
+	bif => Burundi Franc
+	bmd => Bermudian Dollar
+	bnd => Brunei Dollar
+	bob => Bolivian Boliviano
+	brl => Brazilian Real
+	bsd => Bahamian Dollar
+	bwp => Botswana Pula
+	byr => Belarusian Ruble
+	bzd => Belize Dollar
+	cad => Canadian Dollar
+	chf => Swiss Franc
+	clp => Chilean Peso
+	cny => Chinese Yuan Renminbi
+	cop => Colombian Peso
+	crc => Costa Rican Colon
+	cup => Cuban Peso
+	cve => Cape Verde Escudo
+	czk => Czech Koruna
+	djf => Djibouti Franc
+	dkk => Danish Krone
+	dop => Dominican Peso
+	dzd => Algerian Dinar
+	eek => Estonian Kroon
+	egp => Egyptian Pound
+	etb => Ethiopian Birr
+	eur => Euro
+	fjd => Fiji Dollar
+	gbp => British Pound
+	ghs => Ghanaian Cedi
+	gmd => Gambian Dalasi
+	gtq => Guatemalan Quetzal
+	hkd => Hong Kong Dollar
+	hnl => Honduran Lempira
+	hrk => Croatian Kuna
+	htg => Haitian Gourde
+	huf => Hungarian Forint
+	idr => Indonesian Rupiah
+	ils => Israeli New 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
+	khr => Cambodian Riel
+	krw => Korean Won
+	kwd => Kuwaiti Dinar
+	kyd => Cayman Islands Dollar
+	kzt => Kazakhstan Tenge
+	lak => Lao Kip
+	lbp => Lebanese Pound
+	lkr => Sri Lanka Rupee
+	lsl => Lesotho Loti
+	ltl => Lithuanian Litas
+	lvl => Latvian Lats
+	lyd => Libyan Dinar
+	mad => Moroccan Dirham
+	mdl => Moldovan Leu
+	mmk => Myanmar Kyat
+	mop => Macau Pataca
+	mur => Mauritius Rupee
+	mwk => Malawi Kwacha
+	mxn => Mexican Peso
+	myr => Malaysian Ringgit
+	ngn => Nigerian Naira
+	nio => Nicaraguan Cordoba Oro
+	nok => Norwegian Krone
+	npr => Nepalese Rupee
+	nzd => New Zealand Dollar
+	omr => Omani Rial
+	pab => Panamanian Balboa
+	pen => Peruvian Nuevo Sol
+	php => Philippine Peso
+	pkr => Pakistan Rupee
+	pln => Polish Zloty
+	pyg => Paraguay Guarani
+	qar => Qatari Rial
+	ron => Romanian Leu
+	rsd => Serbian Dinar
+	rub => Russian Ruble
+	rwf => Rwanda Franc
+	sar => Saudi Riyal
+	scr => Seychelles Rupee
+	sdd => Sudanese Dinar
+	sek => Swedish Krona
+	sgd => Singapore Dollar
+	sos => Somali Shilling
+	syp => Syrian Pound
+	szl => Swaziland Lilangeni
+	thb => Thai Baht
+	tnd => Tunisian Dinar
+	try => Turkish Lira
+	ttd => Trinidad and Tobago Dollar
+	twd => Taiwan Dollar
+	tzs => Tanzanian Shilling
+	uah => Ukraine Hryvnia
+	ugx => Uganda Shilling
+	usd => US Dollar
+	uyu => Uruguay Peso
+	vef => Venezuelan Bolivar
+	vnd => Vietnamese Dong
+	xaf => CFA BEAC Franc
+	xcd => East Caribbean Dollar
+	xof => CFA BCEAO Franc
+	xpf => CFP Franc
+	zar => South African Rand
+	zmk => Zambian Kwacha
+	zwd => Zimbabwe Dollar

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('currency_switcher', '0.0.1') do |p|
+  p.description    = "Convert currencies using exchange rates from http://exchange-rates.org"
+  p.url            = "http://github.com/staskie/currency_switcher"
+  p.author         = "Dominik Staskiewicz"
+  p.email          = "stadominik@gmail.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+end

data/currency_switcher.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{currency_switcher}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dominik Staskiewicz"]
+  s.cert_chain = ["/Users/dominik/Documents/keys/gem-public_cert.pem"]
+  s.date = %q{2011-01-07}
+  s.description = %q{Convert currencies using exchange rates from http://exchange-rates.org}
+  s.email = %q{stadominik@gmail.com}
+  s.extra_rdoc_files = ["README.md", "lib/currency_switcher.rb", "lib/currency_switcher/currencies.rb", "lib/currency_switcher/ext/fixnum.rb"]
+  s.files = ["README.md", "Rakefile", "lib/currency_switcher.rb", "lib/currency_switcher/currencies.rb", "lib/currency_switcher/ext/fixnum.rb", "test/helper.rb", "test/html/eur_to_usd.html", "test/html/usd_to_gbp.html", "test/test_currency_switcher.rb", "Manifest", "currency_switcher.gemspec"]
+  s.homepage = %q{http://github.com/staskie/currency_switcher}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Currency_switcher", "--main", "README.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{currency_switcher}
+  s.rubygems_version = %q{1.3.7}
+  s.signing_key = %q{/Users/dominik/Documents/keys/gem-private_key.pem}
+  s.summary = %q{Convert currencies using exchange rates from http://exchange-rates.org}
+  s.test_files = ["test/test_currency_switcher.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/currency_switcher.rb

@@ -0,0 +1,101 @@
+require 'nokogiri'
+require 'open-uri'
+
+$:.unshift(File.join(File.dirname(__FILE__), 'currency_switcher'))
+
+require 'currencies'
+require 'ext/fixnum'
+
+module CurrencySwitcher
+
+  # URL for working out the exchange rate
+  URL = "http://exchange-rates.org/converter"
+  
+  class << self
+    # Get 'from' currency
+    #
+    # Returns the Symbol of 'from' currency
+    attr_reader :from_currency
+    
+    # Get 'to' currency
+    #
+    # Returns the Symbol of 'to' currency
+    attr_reader :to_currency
+  end
+  
+  # Validates if a method called on Fixnum is a currency
+  # exchange method
+  #
+  # method - The String representing the method's name
+  #
+  # Examples
+  #
+  #   CurrencySwitcher.valid_exchange_method?(usd_to_eur)
+  #   # => true
+  #
+  #   CurrencySwitcher.valid_exchange_method?(usd_to_fakecurrency)
+  #   # => false
+  #
+  # Returns true if a method is valid or false if the method is invalid
+  def self.valid_exchange_method?(method)
+    if method =~ /(.+)_to_(.+)/
+      @from_currency = $1.to_sym
+      @to_currency   = $2.to_sym
+      @method        = method
+      
+      both_currencies_valid? ? true : false
+    end
+  end
+
+  # Check if 'from' and 'to' currencies are valid. They have to be defined
+  # in CURRENCIES hash
+  #
+  # Returns true if botch currencies are valid or false if one of them is invalid
+  def self.both_currencies_valid?
+    CURRENCIES.has_key?(from_currency) && CURRENCIES.has_key?(to_currency)
+  end
+  
+  
+  # Calculate the value from fixnum and exchange rate
+  #
+  # fixnum - The Fixnum representing how much should be converted
+  #
+  # Examples
+  #
+  #   CurrencySwitcher.calculate_value(3)
+  #   # => 5.23
+  #
+  # Returns float value of fixnum multiplied by exchange rate
+  # Raises StandardError if exchange rate is nil
+  def self.calculate_value(fixnum)
+    ex_rate = exchange_rate
+    raise StandardError, "Could not work out the result" if ex_rate.nil?
+    
+    value = "%.2f" % (ex_rate * fixnum)
+    value.to_f
+  end
+  
+  # Work out the exchange rate for a given URL. 
+  # Parse the response and extract the value
+  #
+  # Returns the Float value of exchange rate or nil
+  def self.exchange_rate
+    doc = Nokogiri::HTML(open(self.link), nil, 'UTF-8')
+    doc.css('#ctl00_M_lblToAmount').text.to_f
+  rescue 
+  end
+  
+  # Create a customized URL for 'from' and 'to' currencies
+  #
+  # Returns the String representing a valid URL
+  def self.link
+    "#{URL}/#{from_currency.to_s.upcase}/#{to_currency.to_s.upcase}/1"
+  end
+  
+  # Print the available list of currencies
+  #
+  # Returns the String with all the currencies
+  def self.currencies
+    CURRENCIES.keys.sort.each { |symbol| puts "#{symbol} => #{CURRENCIES[symbol]}"}
+  end
+end

data/lib/currency_switcher/currencies.rb

@@ -0,0 +1,124 @@
+module CurrencySwitcher
+  # Available currencies with descriptions
+  CURRENCIES  = { 
+                  :dzd => "Algerian Dinar",
+                  :ars => "Argentine Peso",
+                  :amd => "Armenian Dram",
+                  :aud => "Australian Dollar",
+                  :bsd => "Bahamian Dollar",
+                  :bhd => "Bahraini Dinar",
+                  :bdt => "Bangladeshi Taka",
+                  :bbd => "Barbados Dollar",
+                  :byr => "Belarusian Ruble",
+                  :bzd => "Belize Dollar",
+                  :bmd => "Bermudian Dollar",
+                  :bob => "Bolivian Boliviano",
+                  :bwp => "Botswana Pula",
+                  :brl => "Brazilian Real",
+                  :gbp => "British Pound",
+                  :bnd => "Brunei Dollar",
+                  :bgn => "Bulgarian Lev",
+                  :bif => "Burundi Franc",
+                  :khr => "Cambodian Riel",
+                  :cad => "Canadian Dollar",
+                  :cve => "Cape Verde Escudo",
+                  :kyd => "Cayman Islands Dollar",
+                  :xof => "CFA BCEAO Franc",
+                  :xaf => "CFA BEAC Franc",
+                  :xpf => "CFP Franc",
+                  :clp => "Chilean Peso",
+                  :cny => "Chinese Yuan Renminbi",
+                  :cop => "Colombian Peso",
+                  :crc => "Costa Rican Colon",
+                  :hrk => "Croatian Kuna",
+                  :cup => "Cuban Peso",
+                  :czk => "Czech Koruna",
+                  :dkk => "Danish Krone",
+                  :djf => "Djibouti Franc",
+                  :dop => "Dominican Peso",
+                  :xcd => "East Caribbean Dollar",
+                  :egp => "Egyptian Pound",
+                  :eek => "Estonian Kroon",
+                  :etb => "Ethiopian Birr",
+                  :eur => "Euro",
+                  :fjd => "Fiji Dollar",
+                  :gmd => "Gambian Dalasi",
+                  :ghs => "Ghanaian Cedi",
+                  :gtq => "Guatemalan Quetzal",
+                  :htg => "Haitian Gourde",
+                  :hnl => "Honduran Lempira",
+                  :hkd => "Hong Kong Dollar",
+                  :huf => "Hungarian Forint",
+                  :isk => "Iceland Krona",
+                  :inr => "Indian Rupee",
+                  :idr => "Indonesian Rupiah",
+                  :irr => "Iranian Rial",
+                  :iqd => "Iraqi Dinar",
+                  :ils => "Israeli New Shekel",
+                  :jmd => "Jamaican Dollar",
+                  :jpy => "Japanese Yen",
+                  :jod => "Jordanian Dinar",
+                  :kzt => "Kazakhstan Tenge",
+                  :kes => "Kenyan Shilling",
+                  :krw => "Korean Won",
+                  :kwd => "Kuwaiti Dinar",
+                  :lak => "Lao Kip",
+                  :lvl => "Latvian Lats",
+                  :lbp => "Lebanese Pound",
+                  :lsl => "Lesotho Loti",
+                  :lyd => "Libyan Dinar",
+                  :ltl => "Lithuanian Litas",
+                  :mop => "Macau Pataca",
+                  :mwk => "Malawi Kwacha",
+                  :myr => "Malaysian Ringgit",
+                  :mur => "Mauritius Rupee",
+                  :mxn => "Mexican Peso",
+                  :mdl => "Moldovan Leu",
+                  :mad => "Moroccan Dirham",
+                  :mmk => "Myanmar Kyat",
+                  :npr => "Nepalese Rupee",
+                  :ang => "Netherlands Antillian Guilder",
+                  :nzd => "New Zealand Dollar",
+                  :nio => "Nicaraguan Cordoba Oro",
+                  :ngn => "Nigerian Naira",
+                  :nok => "Norwegian Krone",
+                  :omr => "Omani Rial",
+                  :pkr => "Pakistan Rupee",
+                  :pab => "Panamanian Balboa",
+                  :pyg => "Paraguay Guarani",
+                  :pen => "Peruvian Nuevo Sol",
+                  :php => "Philippine Peso",
+                  :pln => "Polish Zloty",
+                  :qar => "Qatari Rial",
+                  :ron => "Romanian Leu",
+                  :rub => "Russian Ruble",
+                  :rwf => "Rwanda Franc",
+                  :sar => "Saudi Riyal",
+                  :rsd => "Serbian Dinar",
+                  :scr => "Seychelles Rupee",
+                  :sgd => "Singapore Dollar",
+                  :sos => "Somali Shilling",
+                  :zar => "South African Rand",
+                  :lkr => "Sri Lanka Rupee",
+                  :sdd => "Sudanese Dinar",
+                  :szl => "Swaziland Lilangeni",
+                  :sek => "Swedish Krona",
+                  :chf => "Swiss Franc",
+                  :syp => "Syrian Pound",
+                  :twd => "Taiwan Dollar",
+                  :tzs => "Tanzanian Shilling",
+                  :thb => "Thai Baht",
+                  :ttd => "Trinidad and Tobago Dollar",
+                  :tnd => "Tunisian Dinar",
+                  :try => "Turkish Lira",
+                  :ugx => "Uganda Shilling",
+                  :uah => "Ukraine Hryvnia",
+                  :aed => "United Arab Emirates Dirham",
+                  :uyu => "Uruguay Peso",
+                  :usd => "US Dollar",
+                  :vef => "Venezuelan Bolivar",
+                  :vnd => "Vietnamese Dong",
+                  :zmk => "Zambian Kwacha",
+                  :zwd => "Zimbabwe Dollar"
+                  }
+end

data/lib/currency_switcher/ext/fixnum.rb

@@ -0,0 +1,23 @@
+class Numeric
+  # Overriding method_missing to add CurrencySwitcher methods
+  #
+  # sym - standard method_missing argument
+  # *args - standard method_missing argument
+  # &block - standard method_missing argument
+  #
+  # Examples
+  #
+  #   3.usd_to_eur
+  #   1200.gbp_to_pln
+  #
+  # Returns Float value of currency exchange result
+  # Raises NoMethodError if couldn't find a method
+  def method_missing(sym, *args, &block)
+    # Check if the missing method applies to CurrencySwitcher module
+    if CurrencySwitcher.valid_exchange_method?(sym)
+      return CurrencySwitcher.calculate_value(self)
+    else
+      super.method_missing(sym, *args, &block)
+    end
+  end
+end