currencies 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 hexorx
+
+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.markdown

@@ -0,0 +1,105 @@
+Currencies
+==========
+
+If you are tracking any kind of assets the currencies gem is for you. It contains every currency in the ISO 4217 standard and allows you to add your own as well. So if you decide to take sparkly buttons as a form of payment you can use currencies to display the shiny button unicode symbol ☼ (disclaimer: ☼ may not look like a shiny button to everyone.) when used with something like the money gem. Speaking of the money gem, currencies gives you an ExchangeBank that the money gem can use to convert from one currency to another. There are plans to have ExchangeRate provider plugin system. Right now the rates are either set manually or pulled from Yahoo Finance.
+
+Installation
+------------
+
+Countries is hosted on GemCutter, so simply run the following:
+
+    gem sources -a http://gemcutter.org
+    sudo gem install currencies
+    
+Basic Usage
+-----------
+
+There are two ways to get a currency object. The first is to simply make it.
+
+    Currency.new('USD', :name => 'Dollars', :symbol => '$', :exchange_rate => 1)
+    
+Or you can lookup a currency by its ISO 4217 code using the *from_code* method.
+
+    Currency.from_code('USD')
+    
+Once you have a Currency instance you can get basic information about it.
+
+    currency = Currency.from_code('USD')
+    currency.code #=> "USD"
+    currency.name #=> "Dollars"
+    currency.symbol #=> "$"
+    currency.exchange_rate #=> 1.0
+    currency.exchange_currency #=> "USD"
+    
+Adding Currencies
+-----------------
+
+Currencies keeps an internal list of currencies for use in the ExchangeBank and to be looked up with the *from_code* method. By default this list contains all the currencies in the ISO 4217 standard. A custom currency can be added using the *add* class method.
+    
+    shiny_button = Currency.new('SBTTN', :name => 'Buttons', :symbol => '☼', :exchange_rate => 1000)
+    Currency.add(shiny_button)
+    
+To do a massive addition of currencies you can load a yaml file using the *load_file* class method.
+
+    Currency.load_file('custom_currency.yaml')
+    
+And the yaml file should look like ...
+
+    SBTTN:
+      name: Buttons
+      symbol: ☼
+        
+Defaults
+--------
+
+You can set the base currency by using the *base_currency* class method. This defaults to 'USD'.
+
+    Currency.base_currency => 'GBP'
+
+The exchange rate is either set manually or if nil looked up on Yahoo Finance and cached. If you want to disable looking up the currency set the *import_exchange_rates* class method to false.
+
+    Currency.import_exchange_rates = false
+
+
+Money Gem
+---------
+
+To use with the money gem you just set the default bank to the currencies bank.
+
+    Money.default_bank = Currency::ExchangeBank.new
+    
+The Currencies ExchangeBank works the same as the one in the money gem except that if an exchange rate isn't set by default it uses what is set in the currencies gem.
+
+ToDo
+----
+
+* Plugin exchange rate things
+* Add some to_currency methods
+* Add more ways to find a currency
+* Make the ExchangeBank accept Currency objects
+
+Sponsored By
+------------
+
+This gem is sponsored by [Teliax][]. [Teliax][] makes business class Voice, [Centrex][](Including Hosted: IVRs, Ring Groups, Extensions and Day Night Mode) and Data services accessible to anyone. You don't have to be a fortune 500 to sound big!
+
+Note on Patches/Pull Requests
+-----------------------------
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+Copyright
+---------
+
+Copyright (c) 2010 hexorx. See LICENSE for details.
+
+
+[Teliax]: http://teliax.com
+[Centrex]: http://en.wikipedia.org/wiki/Centrex

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "currencies"
+    gem.summary = %Q{Simple gem for working with currencies. It is extracted from the countries gem and contains all the currency information in the ISO 4217 standard.}
+    gem.description = %Q{If you are tracking any kind of assets the currencies gem is for you. It contains every currency in the ISO 4217 standard and allows you to add your own as well. So if you decide to take sparkly buttons as a form of payment you can use currencies to display the shiny button unicode symbol ☼ (disclaimer: ☼ may not look like a shiny button to everyone.) when used with something like the money gem. Speaking of the money gem, currencies gives you an ExchangeBank that the money gem can use to convert from one currency to another. There are plans to have ExchangeRate provider plugin system. Right now the rates are either set manually or pulled from Yahoo Finance.}
+    gem.email = "hexorx@gmail.com"
+    gem.homepage = "http://github.com/hexorx/currencies"
+    gem.authors = ["hexorx"]
+    gem.add_development_dependency "rspec"
+    gem.add_development_dependency "yard"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/currencies.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__))
+
+require 'YAML' unless defined?(YAML)
+require 'net/http' unless defined?(Net::HTTP)
+
+require 'currencies/extentions'
+require 'currencies/currency'
+require 'currencies/exchange_bank'

data/lib/currencies/currency.rb

@@ -0,0 +1,54 @@
+class Currency
+  class << self
+    attr_accessor :currencies
+    attr_accessor :base_currency
+    attr_accessor :import_exchange_rates
+  end
+  
+  attr_reader :code, :symbol, :name, :exchange_currency
+  
+  def initialize(iso_code,opts={})
+    @code = iso_code.to_s.upcase
+    @name = opts['name']
+    @symbol = opts['symbol']
+    @exchange_currency = opts['exchange_currency'] || Currency.base_currency
+    @exchange_rate = opts['exchange_rate'].to_f
+  end
+  
+  def exchange_rate
+    @exchange_rate = nil unless @exchange_currency == Currency.base_currency
+    @exchange_rate ||= load_exchange_rate
+  end
+  
+  def load_exchange_rate
+    @exchange_currency = Currency.base_currency
+    return 1.0 if @code == @exchange_currency
+    if Currency.import_exchange_rates
+      http = Net::HTTP.new('download.finance.yahoo.com', 80)
+      response = http.get("/d/quotes.csv?e=.csv&f=sl1d1t1&s=#{@code}#{@exchange_currency}=X")
+      rate = response.body.split(',')[1]
+      rate == '0.0' ? nil : rate.to_f
+    else
+      nil
+    end
+  end  
+    
+  def self.load_file(file)
+    YAML.load_file(file).each do |code,options|
+      self.add(self.new(code,options))
+    end
+  end
+
+  def self.from_code(code)
+    self.currencies[code.to_s.upcase]
+  end
+  
+  def self.add(new_currency)
+    self.currencies ||= {}
+    self.currencies[new_currency.code] = new_currency
+  end
+  
+  load_file(File.join(File.dirname(__FILE__), '..', 'data', 'iso4217.yaml'))
+  self.base_currency = 'USD'
+  self.import_exchange_rates = true
+end

data/lib/currencies/exchange_bank.rb

@@ -0,0 +1,46 @@
+class Currency
+  class ExchangeBank
+    def self.instance
+      @@singleton
+    end
+
+    def initialize
+      @rates = {}
+      @mutex = Mutex.new
+    end
+
+    def add_rate(from, to, rate)
+      @mutex.synchronize do
+        @rates["#{from}_TO_#{to}".upcase] = rate
+      end
+    end
+
+    def get_rate(from, to)
+      @mutex.synchronize do
+        @rates["#{from}_TO_#{to}".upcase] 
+      end
+    end
+
+    def same_currency?(currency1, currency2)
+      currency1.upcase == currency2.upcase
+    end
+
+    def exchange(cents, from_currency, to_currency)
+      rate = get_rate(from_currency, to_currency)
+      if rate
+        (cents * rate).floor
+      else
+        from_currency = Currency.from_code(from_currency)
+        to_currency = Currency.from_code(to_currency)
+                
+        if from_currency && to_currency && from_currency.exchange_rate && to_currency.exchange_rate && (from_currency.exchange_currency == to_currency.exchange_currency)
+          ((cents * from_currency.exchange_rate) / to_currency.exchange_rate).floor
+        else
+          raise Money::UnknownRate, "No conversion rate known for '#{from_currency}' -> '#{to_currency}'"
+        end
+      end
+    end
+
+    @@singleton = ExchangeBank.new
+  end
+end

data/lib/currencies/extentions.rb

@@ -0,0 +1,4 @@
+class Money
+  class UnknownRate < StandardError
+  end
+end 

data/lib/data/iso4217.yaml

@@ -0,0 +1,779 @@
+--- 
+AED: 
+  code: AED
+  name: Dirhams
+AFN: 
+  code: AFN
+  name: Afghanis
+  symbol: ؋
+  unicode_hex: 1547
+ALL: 
+  code: ALL
+  name: Leke
+  symbol: LEK
+  unicode_hex: 
+    - 76
+    - 101
+    - 107
+AMD: 
+  code: AMD
+  name: Drams
+ANG: 
+  code: ANG
+  name: Guilders
+  symbol: ƒ
+  unicode_hex: 402
+AOA: 
+  code: AOA
+  name: Kwanza
+ARS: 
+  code: ARS
+  name: Pesos
+  symbol: $
+  unicode_hex: 36
+AUD: 
+  code: AUD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+AWG: 
+  alt_name: Florins
+  code: AWG
+  name: Guilders
+  symbol: ƒ
+  unicode_hex: 402
+AZN: 
+  code: AZN
+  name: "New Manats"
+  symbol: ман
+  unicode_hex: 
+    - 1084
+    - 1072
+    - 1085
+BAM: 
+  code: BAM
+  name: "Convertible Marka"
+  symbol: KM
+  unicode_hex: 
+    - 75
+    - 77
+BBD: 
+  code: BBD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+BGN: 
+  code: BGN
+  name: Leva
+  symbol: лв
+  unicode_hex: 
+    - 82
+    - 1074
+BHD: 
+  code: BHD
+  name: Dinars
+BIF: 
+  code: BIF
+  name: Francs
+BMD: 
+  code: BMD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+BND: 
+  code: BND
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+BOB: 
+  code: BOB
+  name: Bolivianos
+  symbol: $b
+  unicode_hex: 
+    - 36
+    - 98
+BRL: 
+  code: BRL
+  name: Real
+  symbol: R$
+  unicode_hex: 
+    - 82
+    - 36
+BSD: 
+  code: BSD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+BTD: 
+  code: BTD
+  name: Taka
+BTN: 
+  code: BTN
+  name: Ngultrum
+BWP: 
+  code: BWP
+  name: Pulas
+  symbol: P
+  unicode_hex: 80
+BYR: 
+  code: BYR
+  name: Rubles
+  symbol: p.
+  unicode_hex: 
+    - 112
+    - 46
+BZD: 
+  code: BZD
+  name: Dollars
+  symbol: BZ$
+  unicode_hex: 
+    - 66
+    - 90
+    - 36
+CAD: 
+  code: CAD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+CHF: 
+  code: CHF
+  name: "Switzerland Francs"
+  symbol: CHF
+  unicode_hex: 
+    - 67
+    - 72
+    - 70
+CLP: 
+  code: CLP
+  name: Pesos
+  symbol: $
+  unicode_hex: 36
+CNY: 
+  code: CNY
+  name: "Yuan Renminbi"
+  symbol: ¥
+  unicode_hex: 165
+COP: 
+  code: COP
+  name: Pesos
+  symbol: $
+  unicode_hex: 36
+CRC: 
+  code: CRC
+  name: Colones
+  symbol: ₡
+  unicode_hex: 8353
+CUP: 
+  code: CUP
+  name: Pesos
+  symbol: ₱
+  unicode_hex: 8369
+CVE: 
+  code: CVE
+  name: Escudos
+CZK: 
+  code: CZK
+  name: Koruny
+  symbol: Kč
+  unicode_hex: 
+    - 75
+    - 269
+DJF: 
+  code: DJF
+  name: Francs
+DKK: 
+  code: DKK
+  name: Kroner
+  symbol: kr
+  unicode_hex: 
+    - 107
+    - 114
+DOP: 
+  code: DOP
+  name: Pesos
+  symbol: RD$
+  unicode_hex: 
+    - 82
+    - 68
+    - 36
+DZD: 
+  code: DZD
+  name: Dinars
+EEK: 
+  code: EEK
+  name: Krooni
+  symbol: kr
+  unicode_hex: 
+    - 107
+    - 114
+EGP: 
+  code: EGP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+ETB: 
+  code: ETB
+  name: "Ethopia Birr"
+EUR: 
+  code: EUR
+  name: Euro
+  symbol: €
+  unicode_hex: 8364
+FKP: 
+  code: FKP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+GBP: 
+  code: GBP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+GEL: 
+  code: GEL
+  name: Lari
+GGP: 
+  code: GGP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+GHS: 
+  code: GHS
+  name: Cedis
+  symbol: ¢
+  unicode_hex: 162
+GIP: 
+  code: GIP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+GMD: 
+  code: GMD
+  name: Lari
+GNF: 
+  code: GNF
+  name: Francs
+GTQ: 
+  code: GTQ
+  name: Quetzales
+  symbol: Q
+  unicode_hex: 81
+GYD: 
+  code: GYD
+  name: Dollars
+HKD: 
+  code: HKD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+HNL: 
+  code: HNL
+  name: Lempiras
+  symbol: L
+  unicode_hex: 76
+HRK: 
+  code: HRK
+  name: Kuna
+  symbol: kn
+  unicode_hex: 
+    - 107
+    - 110
+HUF: 
+  code: HUF
+  name: Forint
+  symbol: Ft
+  unicode_hex: 
+    - 70
+    - 116
+IDR: 
+  code: IDR
+  name: "Indonesian Rupiahs"
+  symbol: Rp
+  unicode_hex: 
+    - 82
+    - 112
+ILS: 
+  code: ILS
+  name: "New Shekels"
+  symbol: ₪
+  unicode_hex: 8362
+IMP: 
+  code: IMP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+INR: 
+  code: INR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+IQD: 
+  code: IQD
+  name: Dinars
+IRR: 
+  code: IRR
+  name: Riais
+  symbol: ﷼
+  unicode_hex: 65020
+ISK: 
+  code: ISK
+  name: Kronur
+  symbol: kr
+  unicode_hex: 
+    - 107
+    - 114
+JEP: 
+  code: JEP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+JMD: 
+  code: JMD
+  name: Dollars
+JOD: 
+  code: JOD
+  name: Dinars
+JPY: 
+  code: JPY
+  name: Yen
+  symbol: ¥
+  unicode_hex: 165
+KES: 
+  code: KES
+  name: Shillings
+KGS: 
+  code: KGS
+  name: Soms
+  symbol: лв
+  unicode_hex: 
+    - 1083
+    - 1074
+KHR: 
+  code: KHR
+  name: Rieis
+KMF: 
+  code: KMF
+  name: Francs
+KPW: 
+  code: KPW
+  name: Won
+  symbol: ₩
+  unicode_hex: 8361
+KRW: 
+  code: KRW
+  name: Won
+  symbol: ₩
+  unicode_hex: 8361
+KWD: 
+  code: KWD
+  name: Dinars
+KYD: 
+  code: KYD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+KZT: 
+  code: KZT
+  name: Tenege
+  symbol: лв
+  unicode_hex: 
+    - 1083
+    - 1074
+LAK: 
+  code: LAK
+  name: Kips
+  symbol: ₭
+  unicode_hex: 8365
+LBP: 
+  code: LBP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+LKR: 
+  code: LKR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+LRD: 
+  code: LRD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+LSL: 
+  alt_currency: 
+    code: ZAR
+    name: Rand
+    symbol: R
+    unicode_hex: 82
+  code: LSL
+  name: Maloti
+LTL: 
+  code: LTL
+  name: Litai
+  symbol: Lt
+  unicode_hex: 
+    - 76
+    - 116
+LVL: 
+  code: LVL
+  name: Lati
+  symbol: Ls
+  unicode_hex: 
+    - 76
+    - 115
+LYD: 
+  code: LYD
+  name: Dinars
+MAD: 
+  code: MAD
+  name: Dirhams
+MDL: 
+  code: MDL
+  name: Lei
+MNK: 
+  code: MNK
+  name: Kyats
+MNT: 
+  code: MNT
+  name: Tugriks
+  symbol: ₮
+  unicode_hex: 8366
+MRO: 
+  code: MRO
+  name: Ouguiyas
+MUR: 
+  code: MUR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+MVR: 
+  code: MVR
+  name: Rufiyaa
+MWK: 
+  code: MWK
+  name: Kwachas
+MXN: 
+  code: MXN
+  name: Pesos
+  symbol: $
+  unicode_hex: 36
+MYR: 
+  code: MYR
+  name: Ringgits
+  symbol: RM
+  unicode_hex: 
+    - 82
+    - 77
+MZN: 
+  code: MZN
+  name: Meticals
+  symbol: MT
+  unicode_hex: 
+    - 77
+    - 84
+NAD: 
+  alt_currency: 
+    code: ZAR
+    name: Rand
+    symbol: R
+    unicode_hex: 82
+  code: NAD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+NGN: 
+  code: NGN
+  name: Nairas
+  symbol: ₦
+  unicode_hex: 8358
+NIO: 
+  code: NIO
+  name: Cordobas
+  symbol: C$
+  unicode_hex: 
+    - 67
+    - 36
+NOK: 
+  code: NOK
+  name: Kroner
+  symbol: kr
+  unicode_hex: 
+    - 123
+    - 114
+NPR: 
+  code: NPR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+NZD: 
+  code: NZD
+  name: "New Zealand Dollars"
+  symbol: $
+  unicode_hex: 36
+OMR: 
+  code: OMR
+  name: Riais
+  symbol: ﷼
+  unicode_hex: 65020
+PAB: 
+  alt_currency: 
+    code: USD
+    name: Dollars
+    symbol: $
+    unicode_hex: 36
+  code: PAB
+  name: Balboa
+  symbol: B/.
+  unicode_hex: 
+    - 66
+    - 47
+    - 46
+PEN: 
+  code: PEN
+  name: "Nuevos Soles"
+  symbol: S/.
+  unicode_hex: 
+    - "0x50,0x2f,0x2e"
+PGK: 
+  code: PGK
+  name: Kina
+PHP: 
+  code: PHP
+  name: Pesos
+  symbol: Php
+  unicode_hex: 
+    - 80
+    - 104
+    - 112
+PKR: 
+  code: PKR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+PLN: 
+  code: PLN
+  name: Zlotych
+  symbol: zł
+  unicode_hex: 
+    - 122
+    - 322
+PYG: 
+  code: PYG
+  name: Guarani
+  symbol: Gs
+  unicode_hex: 
+    - 71
+    - 115
+QAR: 
+  code: QAR
+  name: Rials
+  symbol: ﷼
+  unicode_hex: 65020
+RON: 
+  code: RON
+  name: "New Lei"
+  symbol: lei
+  unicode_hex: 
+    - 108
+    - 101
+    - 105
+RSD: 
+  code: RSD
+  name: Dinars
+  symbol: Дин.
+  unicode_hex: 
+    - 1044
+    - 1080
+    - 1085
+    - 46
+RUB: 
+  code: RUB
+  name: Rubles
+  symbol: руб
+  unicode_hex: 
+    - 1088
+    - 1091
+    - 1073
+RWF: 
+  code: RWF
+  name: Francs
+SAR: 
+  code: SAR
+  name: Riyals
+  symbol: ﷼
+  unicode_hex: 65020
+SBD: 
+  code: SBD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+SCR: 
+  code: SCR
+  name: Rupees
+  symbol: ₨
+  unicode_hex: 8360
+SDG: 
+  code: SDG
+  name: Pounds
+SEK: 
+  code: SEK
+  name: Kronor
+  symbol: kr
+  unicode_hex: 
+    - 107
+    - 114
+SGD: 
+  code: SGD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+SHP: 
+  code: SHP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+SLL: 
+  code: SLL
+  name: Leones
+SOS: 
+  code: SOS
+  name: Shillings
+  symbol: S
+  unicode_hex: 83
+SRD: 
+  code: SRD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+STD: 
+  code: STD
+  name: Dobras
+SYP: 
+  code: SYP
+  name: Pounds
+  symbol: £
+  unicode_hex: 163
+SZL: 
+  code: SZL
+  name: Emalangeni
+THB: 
+  code: THB
+  name: Baht
+  symbol: ฿
+  unicode_hex: 3647
+TJS: 
+  alt_currency: 
+    code: RUB
+    name: Rubles
+    symbol: руб
+    unicode_hex: 
+      - 1088
+      - 1091
+      - 1073
+  code: TJS
+  name: Somoni
+TND: 
+  code: TND
+  name: Dollars
+TOP: 
+  code: TOP
+  name: Pa'anga
+TRY: 
+  code: TRY
+  name: Lira
+  symbol: TL
+  unicode_hex: 
+    - 84
+    - 76
+TTD: 
+  code: TTD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+TVD: 
+  code: TVD
+  name: "Tuvalu Dollars"
+TWD: 
+  code: TWD
+  name: "New Dollars"
+  symbol: NT$
+  unicode_hex: 
+    - 78
+    - 84
+    - 36
+TZS: 
+  code: TZS
+  name: Shillings
+UAH: 
+  code: UAH
+  name: Hryvnia
+  symbol: ₴
+  unicode_hex: 8372
+UGX: 
+  code: UGX
+  name: Shillings
+USD: 
+  code: USD
+  name: Dollars
+  symbol: $
+  unicode_hex: 36
+UYU: 
+  code: UYU
+  name: Pesos
+  symbol: $U
+  unicode_hex: 
+    - 36
+    - 85
+UZS: 
+  code: UZS
+  name: Sums
+  symbol: лв
+  unicode_hex: 
+    - 1083
+    - 1074
+VEF: 
+  code: VEF
+  name: "Bolivares Fuertes"
+  symbol: Bs
+  unicode_hex: 
+    - 1083
+    - 1074
+VND: 
+  code: VND
+  name: Dong
+  symbol: ₫
+  unicode_hex: 8363
+XAF: 
+  code: XAF
+  name: "Communauté Financière Africaine Francs"
+XCD: 
+  code: XCD
+  name: "East Caribbean Dollars"
+  symbol: $
+  unicode_hex: 36
+XOF: 
+  code: XOF
+  name: "Communauté Financière Africaine Francs"
+XPF: 
+  code: XPF
+  name: "Comptoirs Français du Pacifique Francs"
+YER: 
+  code: YER
+  name: Rials
+  symbol: ﷼
+  unicode_hex: 65020
+ZAR: 
+  code: ZAR
+  name: Rand
+  symbol: R
+  unicode_hex: 82
+ZMK: 
+  code: ZMK
+  name: Kwacha
+ZWD: 
+  code: ZWD
+  name: "Zimbabwe Dollars"
+  symbol: Z$
+  unicode_hex: 
+    - 90
+    - 36

data/spec/currency_spec.rb

@@ -0,0 +1,55 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Currency do
+  before(:all) do
+    @usd = Currency.from_code(:USD)
+    @gbp = Currency.from_code(:GBP)
+  end
+  
+  it 'should return code' do
+    @usd.code.should == 'USD'
+    @gbp.code.should == 'GBP'
+  end
+  
+  it 'should return symbol' do
+    @usd.symbol.should == '$'
+    @gbp.symbol.should == '£'
+  end
+  
+  it 'should return name' do
+    @usd.name.should == 'Dollars'
+    @gbp.name.should == 'Pounds'
+  end
+  
+  describe 'from_code' do
+    it 'should return new Currency instance when passed iso4217 currency code' do
+      Currency.from_code('USD').should be_a(Currency)
+    end
+    
+    it 'should return a currency with the same code' do
+      Currency.from_code('USD').code.should == 'USD'
+      Currency.from_code('GBP').code.should == 'GBP'
+    end
+    
+    it 'should accept symbol' do
+      Currency.from_code(:USD).code.should == 'USD'
+      Currency.from_code(:GBP).code.should == 'GBP'
+    end
+    
+    it 'should work with lower case' do
+      Currency.from_code('usd').code.should == 'USD'
+      Currency.from_code('gbp').code.should == 'GBP'
+    end
+  end
+  
+  describe 'exchange_rate' do
+    it 'should return a float' do
+      Currency.from_code('GBP').exchange_rate.should be_a(Float)
+      puts Currency.from_code('GBP').exchange_rate
+    end
+    
+    it 'should have an exchange rate of 1.0 for the base currency' do
+      Currency.from_code(Currency.base_currency).exchange_rate.should == 1.0
+    end
+  end
+end

data/spec/exchange_bank_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Currency::ExchangeBank do
+  before :each do
+    @bank = Currency::ExchangeBank.new
+  end
+  
+  it "returns the previously specified conversion rate" do
+    @bank.add_rate("USD", "EUR", 0.788332676)
+    @bank.add_rate("EUR", "YEN", 122.631477)
+    @bank.get_rate("USD", "EUR").should == 0.788332676
+    @bank.get_rate("EUR", "YEN").should == 122.631477
+  end
+  
+  it "treats currency names case-insensitively" do
+    @bank.add_rate("usd", "eur", 1)
+    @bank.get_rate("USD", "EUR").should == 1
+    @bank.same_currency?("USD", "usd").should be_true
+    @bank.same_currency?("EUR", "usd").should be_false
+  end
+  
+  it "returns nil if the conversion rate is unknown" do
+    @bank.get_rate("American Pesos", "EUR").should be_nil
+  end
+  
+  it "exchanges money from one currency to another according to the specified conversion rates" do
+    @bank.add_rate("USD", "EUR", 0.5)
+    @bank.add_rate("EUR", "YEN", 10)
+    @bank.exchange(10_00, "USD", "EUR").should == 5_00
+    @bank.exchange(500_00, "EUR", "YEN").should == 5000_00
+  end
+  
+  it "rounds the exchanged result down" do
+    @bank.add_rate("USD", "EUR", 0.788332676)
+    @bank.add_rate("EUR", "YEN", 122.631477)
+    @bank.exchange(10_00, "USD", "EUR").should == 788
+    @bank.exchange(500_00, "EUR", "YEN").should == 6131573
+  end
+  
+  it "should lookup exchange rate if one isn't set" do
+    block = lambda { @bank.exchange(10, "USD", "EUR") }
+    block.should_not raise_error
+  end
+  
+  it "raises Money::UnknownRate upon conversion if the conversion rate is unknown" do
+    block = lambda { @bank.exchange(10, "USD", "BUTTON") }
+    block.should raise_error(Money::UnknownRate)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'currencies'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: currencies
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- hexorx
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-18 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: "If you are tracking any kind of assets the currencies gem is for you. It contains every currency in the ISO 4217 standard and allows you to add your own as well. So if you decide to take sparkly buttons as a form of payment you can use currencies to display the shiny button unicode symbol \xE2\x98\xBC (disclaimer: \xE2\x98\xBC may not look like a shiny button to everyone.) when used with something like the money gem. Speaking of the money gem, currencies gives you an ExchangeBank that the money gem can use to convert from one currency to another. There are plans to have ExchangeRate provider plugin system. Right now the rates are either set manually or pulled from Yahoo Finance."
+email: hexorx@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/currencies.rb
+- lib/currencies/currency.rb
+- lib/currencies/exchange_bank.rb
+- lib/currencies/extentions.rb
+- lib/data/iso4217.yaml
+- spec/currency_spec.rb
+- spec/exchange_bank_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/hexorx/currencies
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Simple gem for working with currencies. It is extracted from the countries gem and contains all the currency information in the ISO 4217 standard.
+test_files: 
+- spec/currency_spec.rb
+- spec/exchange_bank_spec.rb
+- spec/spec_helper.rb