papercavalier-money 3.7.1

data/money.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name        = "papercavalier-money"
+  s.version     = "3.7.1"
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Tobias Luetke", "Hongli Lai", "Jeremy McNevin",
+                   "Shane Emmons", "Simone Carletti", "Jean-Louis Giordano",
+                   "Joshua Clayton", "Bodaniel Jeanes", "Tobias Schmidt",
+                   "Chris Kampmeier", "Romain Gérard", "Eloy", "Josh Delsman",
+                   "Pelle Braendgaard", "Tom Lianza", "James Cotterill",
+                   "François Beausoleil", "Abhay Kumar", "pconnor",
+                   "Christian Billen", "Ilia Lobsanov", "Andrew White",
+                  ]
+  s.email       = ["hongli@phusion.nl", "semmons99+RubyMoney@gmail.com"]
+  s.homepage    = "http://money.rubyforge.org"
+  s.summary     = "Money and currency exchange support library."
+  s.description = "This library aids one in handling money and different currencies."
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "papercavalier-money"
+
+  s.add_dependency "i18n", "~> 0.4"
+
+  s.add_development_dependency "rspec", ">= 2.0.0"
+  s.add_development_dependency "yard"
+  s.add_development_dependency "json"
+
+  s.requirements << "json if you plan to import/export rates formatted as json"
+
+  s.files =  Dir.glob("{lib,spec}/**/*")
+  s.files += %w(CHANGELOG.md LICENSE README.md)
+  s.files += %w(Rakefile .gemtest money.gemspec)
+
+  s.require_path = "lib"
+end

data/spec/bank/base_spec.rb

@@ -0,0 +1,72 @@
+require "spec_helper"
+
+describe Money::Bank::Base do
+  before :each do
+    @bank = Money::Bank::Base.new
+  end
+
+  describe '#new with &block' do
+    it 'should store @rounding_method' do
+      proc = Proc.new{|n| n.ceil}
+      bank = Money::Bank::Base.new(&proc)
+      bank.rounding_method.should == proc
+    end
+  end
+
+  describe '#setup' do
+    it 'should call #setup after #initialize' do
+      class MyBank < Money::Bank::Base
+        attr_reader :setup_called
+
+        def setup
+          @setup_called = true
+        end
+      end
+
+      bank = MyBank.new
+      bank.setup_called.should == true
+    end
+  end
+
+  describe '#exchange_with' do
+    it 'should raise NotImplementedError' do
+      lambda { @bank.exchange_with(Money.new(100, 'USD'), 'EUR') }.should raise_exception(NotImplementedError)
+    end
+  end
+
+  describe '#same_currency?' do
+    it 'should accept str/str' do
+      lambda{@bank.send(:same_currency?, 'USD', 'EUR')}.should_not raise_exception
+    end
+
+    it 'should accept currency/str' do
+      lambda{@bank.send(:same_currency?, Money::Currency.wrap('USD'), 'EUR')}.should_not raise_exception
+    end
+
+    it 'should accept str/currency' do
+      lambda{@bank.send(:same_currency?, 'USD', Money::Currency.wrap('EUR'))}.should_not raise_exception
+    end
+
+    it 'should accept currency/currency' do
+      lambda{@bank.send(:same_currency?, Money::Currency.wrap('USD'), Money::Currency.wrap('EUR'))}.should_not raise_exception
+    end
+
+    it 'should return `true` when currencies match' do
+      @bank.send(:same_currency?, 'USD', 'USD').should == true
+      @bank.send(:same_currency?, Money::Currency.wrap('USD'), 'USD').should == true
+      @bank.send(:same_currency?, 'USD', Money::Currency.wrap('USD')).should == true
+      @bank.send(:same_currency?, Money::Currency.wrap('USD'), Money::Currency.wrap('USD')).should == true
+    end
+
+    it 'should return `false` when currencies do not match' do
+      @bank.send(:same_currency?, 'USD', 'EUR').should == false
+      @bank.send(:same_currency?, Money::Currency.wrap('USD'), 'EUR').should == false
+      @bank.send(:same_currency?, 'USD', Money::Currency.wrap('EUR')).should == false
+      @bank.send(:same_currency?, Money::Currency.wrap('USD'), Money::Currency.wrap('EUR')).should == false
+    end
+
+    it 'should raise an UnknownCurrency exception when an unknown currency is passed' do
+      lambda{@bank.send(:same_currency?, 'AAA', 'BBB')}.should raise_exception(Money::Currency::UnknownCurrency)
+    end
+  end
+end

data/spec/bank/variable_exchange_spec.rb

@@ -0,0 +1,238 @@
+require "spec_helper"
+require "json"
+require "yaml"
+
+describe Money::Bank::VariableExchange do
+
+  describe '#new without block' do
+    before :each do
+      @bank = Money::Bank::VariableExchange.new
+    end
+
+    describe '#exchange_with' do
+      before :each do
+        @bank.send(:set_rate, 'USD', 'EUR', 1.33)
+      end
+
+      it 'should accept str' do
+        lambda{@bank.exchange_with(Money.new(100, 'USD'), 'EUR')}.should_not raise_exception
+      end
+
+      it 'should accept currency' do
+        lambda{@bank.exchange_with(Money.new(100, 'USD'), Money::Currency.wrap('EUR'))}.should_not raise_exception
+      end
+
+      it 'should exchange one currency to another' do
+        @bank.exchange_with(Money.new(100, 'USD'), 'EUR').should == Money.new(133, 'EUR')
+      end
+
+      it 'should truncate extra digits' do
+        @bank.exchange_with(Money.new(10, 'USD'), 'EUR').should == Money.new(13, 'EUR')
+      end
+
+      it 'should raise an UnknownCurrency exception when an unknown currency is requested' do
+        lambda{@bank.exchange_with(Money.new(100, 'USD'), 'BBB')}.should raise_exception(Money::Currency::UnknownCurrency)
+      end
+
+      it 'should raise an UnknownRate exception when an unknown rate is requested' do
+        lambda{@bank.exchange_with(Money.new(100, 'USD'), 'JPY')}.should raise_exception(Money::Bank::UnknownRate)
+      end
+
+      #it 'should round the exchanged result down' do
+      #  @bank.add_rate("USD", "EUR", 0.788332676)
+      #  @bank.add_rate("EUR", "YEN", 122.631477)
+      #  @bank.exchange_with(Money.new(10_00,  "USD"), "EUR").should == Money.new(788, "EUR")
+      #  @bank.exchange_with(Money.new(500_00, "EUR"), "YEN").should == Money.new(6131573, "YEN")
+      #end
+
+      it 'should accept a custom truncation method' do
+        proc = Proc.new { |n| n.ceil }
+        @bank.exchange_with(Money.new(10, 'USD'), 'EUR', &proc).should == Money.new(14, 'EUR')
+      end
+    end
+
+    describe "#add_rate" do
+      it "should add rates correctly" do
+        @bank.add_rate("USD", "EUR", 0.788332676)
+        @bank.add_rate("EUR", "YEN", 122.631477)
+
+        @bank.instance_variable_get(:@rates)['USD_TO_EUR'].should == 0.788332676
+        @bank.instance_variable_get(:@rates)['EUR_TO_JPY'].should == 122.631477
+      end
+
+      it "should treat currency names case-insensitively" do
+        @bank.add_rate("usd", "eur", 1)
+        @bank.instance_variable_get(:@rates)['USD_TO_EUR'].should == 1
+      end
+    end
+
+    describe '#set_rate' do
+      it 'should set a rate' do
+        @bank.set_rate('USD', 'EUR', 1.25)
+        @bank.instance_variable_get(:@rates)['USD_TO_EUR'].should == 1.25
+      end
+
+      it 'should raise an UnknownCurrency exception when an unknown currency is passed' do
+        lambda{ @bank.set_rate('AAA', 'BBB', 1.25) }.should raise_exception(Money::Currency::UnknownCurrency)
+      end
+    end
+
+    describe '#get_rate' do
+      it 'should return a rate' do
+        @bank.set_rate('USD', 'EUR', 1.25)
+        @bank.get_rate('USD', 'EUR').should == 1.25
+      end
+
+      it 'should raise an UnknownCurrency exception when an unknown currency is requested' do
+        lambda{ @bank.get_rate('AAA', 'BBB') }.should raise_exception(Money::Currency::UnknownCurrency)
+      end
+    end
+
+    describe '#export_rates' do
+      before :each do
+        @bank.set_rate('USD', 'EUR', 1.25)
+        @bank.set_rate('USD', 'JPY', 2.55)
+
+        @rates = {"USD_TO_EUR"=>1.25,"USD_TO_JPY"=>2.55}
+      end
+
+      describe 'with format == :json' do
+        it 'should return rates formatted as json' do
+          json = @bank.export_rates(:json)
+          JSON.load(json).should == @rates
+        end
+      end
+
+      describe 'with format == :ruby' do
+        it 'should return rates formatted as ruby objects' do
+          Marshal.load(@bank.export_rates(:ruby)).should == @rates
+        end
+      end
+
+      describe 'with format == :yaml' do
+        it 'should return rates formatted as yaml' do
+          yaml = @bank.export_rates(:yaml)
+          YAML.load(yaml).should == @rates
+        end
+      end
+
+      describe 'with unknown format' do
+        it 'should raise `UnknownRateFormat`' do
+          lambda{@bank.export_rates(:foo)}.should raise_error Money::Bank::UnknownRateFormat
+        end
+      end
+
+      describe 'with :file provided' do
+        it 'should write rates to file' do
+          f = mock('IO')
+          File.should_receive(:open).with('null', 'w').and_return(f)
+          f.should_receive(:write).with(@rates.to_json)
+
+          @bank.export_rates(:json, 'null')
+        end
+      end
+    end
+
+    describe '#import_rates' do
+      describe 'with format == :json' do
+        it 'should load the rates provided' do
+          s = '{"USD_TO_EUR":1.25,"USD_TO_JPY":2.55}'
+          @bank.import_rates(:json, s)
+          @bank.get_rate('USD', 'EUR').should == 1.25
+          @bank.get_rate('USD', 'JPY').should == 2.55
+        end
+      end
+
+      describe 'with format == :ruby' do
+        it 'should load the rates provided' do
+          s = Marshal.dump({"USD_TO_EUR"=>1.25,"USD_TO_JPY"=>2.55})
+          @bank.import_rates(:ruby, s)
+          @bank.get_rate('USD', 'EUR').should == 1.25
+          @bank.get_rate('USD', 'JPY').should == 2.55
+        end
+      end
+
+      describe 'with format == :yaml' do
+        it 'should load the rates provided' do
+          s = "--- \nUSD_TO_EUR: 1.25\nUSD_TO_JPY: 2.55\n"
+          @bank.import_rates(:yaml, s)
+          @bank.get_rate('USD', 'EUR').should == 1.25
+          @bank.get_rate('USD', 'JPY').should == 2.55
+        end
+      end
+
+      describe 'with unknown format' do
+        it 'should raise `UnknownRateFormat`' do
+          lambda{@bank.import_rates(:foo, "")}.should raise_error Money::Bank::UnknownRateFormat
+        end
+      end
+    end
+
+    describe '#rate_key_for' do
+      it 'should accept str/str' do
+        lambda{@bank.send(:rate_key_for, 'USD', 'EUR')}.should_not raise_exception
+      end
+
+      it 'should accept currency/str' do
+        lambda{@bank.send(:rate_key_for, Money::Currency.wrap('USD'), 'EUR')}.should_not raise_exception
+      end
+
+      it 'should accept str/currency' do
+        lambda{@bank.send(:rate_key_for, 'USD', Money::Currency.wrap('EUR'))}.should_not raise_exception
+      end
+
+      it 'should accept currency/currency' do
+        lambda{@bank.send(:rate_key_for, Money::Currency.wrap('USD'), Money::Currency.wrap('EUR'))}.should_not raise_exception
+      end
+
+      it 'should return a hashkey based on the passed arguments' do
+        @bank.send(:rate_key_for, 'USD', 'EUR').should == 'USD_TO_EUR'
+        @bank.send(:rate_key_for, Money::Currency.wrap('USD'), 'EUR').should == 'USD_TO_EUR'
+        @bank.send(:rate_key_for, 'USD', Money::Currency.wrap('EUR')).should == 'USD_TO_EUR'
+        @bank.send(:rate_key_for, Money::Currency.wrap('USD'), Money::Currency.wrap('EUR')).should == 'USD_TO_EUR'
+      end
+
+      it 'should raise an UnknownCurrency exception when an unknown currency is passed' do
+        lambda{@bank.send(:rate_key_for, 'AAA', 'BBB')}.should raise_exception(Money::Currency::UnknownCurrency)
+      end
+    end
+
+  end
+
+
+  describe '#new with &block' do
+    before :each do
+      proc = Proc.new { |n| n.ceil }
+      @bank = Money::Bank::VariableExchange.new(&proc)
+      @bank.add_rate('USD', 'EUR', 1.33)
+    end
+
+    describe '#exchange_with' do
+      it 'should use a stored truncation method' do
+        @bank.exchange_with(Money.new(10, 'USD'), 'EUR').should == Money.new(14, 'EUR')
+      end
+
+      it 'should use a custom truncation method over a stored one' do
+        proc = Proc.new { |n| n.ceil + 1 }
+        @bank.exchange_with(Money.new(10, 'USD'), 'EUR', &proc).should == Money.new(15, 'EUR')
+      end
+    end
+  end
+
+  describe "#marshal_dump" do
+    before :each do
+      @bank = Money::Bank::VariableExchange.new
+    end
+
+    it 'should not raise an error' do
+      lambda{Marshal.dump(@bank)}.should_not raise_error
+    end
+
+    it 'should work with Marshal.load' do
+      b = Marshal.load(Marshal.dump(@bank))
+
+      b.rates.should           == @bank.rates
+      b.rounding_method.should == @bank.rounding_method
+    end
+  end
+end

data/spec/core_extensions_spec.rb

@@ -0,0 +1,158 @@
+require "spec_helper"
+
+describe "Money core extensions" do
+
+  describe Numeric do
+    describe "#to_money" do
+      it "should work" do
+        money = 1234.to_money
+        money.cents.should == 1234_00
+        money.currency.should == Money.default_currency
+
+        money = 100.37.to_money
+        money.cents.should == 100_37
+        money.currency.should == Money.default_currency
+
+        money = BigDecimal.new('1234').to_money
+        money.cents.should == 1234_00
+        money.currency.should == Money.default_currency
+      end
+
+      it "should accept optional currency" do
+        1234.to_money('USD').should == Money.new(123400, 'USD')
+        1234.to_money('EUR').should == Money.new(123400, 'EUR')
+      end
+
+      it "should respect :subunit_to_unit currency property" do
+        10.to_money('USD').should == Money.new(10_00, 'USD')
+        10.to_money('TND').should == Money.new(10_000, 'TND')
+        10.to_money('CLP').should == Money.new(10, 'CLP')
+      end
+
+      specify "#issue/15" do
+        amount = 555.55.to_money
+        amount.should == Money.new(55555)
+      end
+    end
+  end
+
+  describe String do
+    describe "#to_money" do
+
+      StringToMoney = {
+        "20.15"           => Money.new(20_15)             ,
+        "100"             => Money.new(100_00)            ,
+        "100.37"          => Money.new(100_37)            ,
+        "100,37"          => Money.new(100_37)            ,
+        "100 000"         => Money.new(100_000_00)        ,
+        "100,000.00"      => Money.new(100_000_00)        ,
+        "1,000"           => Money.new(1_000_00)          ,
+        "-1,000"          => Money.new(-1_000_00)         ,
+        "1,000.5"         => Money.new(1_000_50)          ,
+        "1,000.51"        => Money.new(1_000_51)          ,
+        "1,000.505"       => Money.new(1_000_51)          ,
+        "1,000.504"       => Money.new(1_000_50)          ,
+        "1,000.0000"      => Money.new(1_000_00)          ,
+        "1,000.5000"      => Money.new(1_000_50)          ,
+        "1,000.5099"      => Money.new(1_000_51)          ,
+        "1.550"           => Money.new(1_55)              ,
+        "25."             => Money.new(25_00)             ,
+        ".75"             => Money.new(75)                ,
+
+        "100 USD"         => Money.new(100_00, "USD")     ,
+        "-100 USD"        => Money.new(-100_00, "USD")    ,
+        "100 EUR"         => Money.new(100_00, "EUR")     ,
+        "100.37 EUR"      => Money.new(100_37, "EUR")     ,
+        "100,37 EUR"      => Money.new(100_37, "EUR")     ,
+        "100,000.00 USD"  => Money.new(100_000_00, "USD") ,
+        "100.000,00 EUR"  => Money.new(100_000_00, "EUR") ,
+        "1,000 USD"       => Money.new(1_000_00, "USD")   ,
+        "-1,000 USD"      => Money.new(-1_000_00, "USD")  ,
+        "1,000.5500 USD"  => Money.new(1_000_55, "USD")   ,
+        "-1,000.6500 USD" => Money.new(-1_000_65, "USD")  ,
+        "1.550 USD"       => Money.new(1_55, "USD")       ,
+
+        "USD 100"         => Money.new(100_00, "USD")     ,
+        "EUR 100"         => Money.new(100_00, "EUR")     ,
+        "EUR 100.37"      => Money.new(100_37, "EUR")     ,
+        "CAD -100.37"     => Money.new(-100_37, "CAD")    ,
+        "EUR 100,37"      => Money.new(100_37, "EUR")     ,
+        "EUR -100,37"     => Money.new(-100_37, "EUR")    ,
+        "USD 100,000.00"  => Money.new(100_000_00, "USD") ,
+        "EUR 100.000,00"  => Money.new(100_000_00, "EUR") ,
+        "USD 1,000"       => Money.new(1_000_00, "USD")   ,
+        "USD -1,000"      => Money.new(-1_000_00, "USD")  ,
+        "USD 1,000.9000"  => Money.new(1_000_90, "USD")   ,
+        "USD -1,000.090"  => Money.new(-1_000_09, "USD")  ,
+        "USD 1.5500"      => Money.new(1_55, "USD")       ,
+
+        "$100 USD"        => Money.new(100_00, "USD")     ,
+        "$1,194.59 USD"   => Money.new(1_194_59, "USD")   ,
+        "$-1,955 USD"     => Money.new(-1_955_00, "USD")  ,
+        "$1,194.5900 USD" => Money.new(1_194_59, "USD")   ,
+        "$-1,955.000 USD" => Money.new(-1_955_00, "USD")  ,
+        "$1.99000 USD"    => Money.new(1_99, "USD")       ,
+      }
+
+      specify "it should work" do
+        StringToMoney.each do |string, money|
+          string.to_money.should == money
+        end
+      end
+
+      it "should coerce input to string" do
+        Money.parse(20, "USD").should == Money.new(20_00, "USD")
+      end
+
+      it "should accept optional currency" do
+        "10.10".to_money('USD').should == Money.new(1010, 'USD')
+        "10.10".to_money('EUR').should == Money.new(1010, 'EUR')
+        "10.10 USD".to_money('USD').should == Money.new(1010, 'USD')
+      end
+
+      it "should raise error if optional currency doesn't match string currency" do
+        lambda{ "10.10 USD".to_money('EUR') }.should raise_error(/Mismatching Currencies/)
+      end
+
+      it "should ignore unrecognized data" do
+        "hello 2000 world".to_money.should == Money.new(2000_00)
+      end
+
+      it "should respect :subunit_to_unit currency property" do
+        "1".to_money("USD").should == Money.new(1_00,  "USD")
+        "1".to_money("TND").should == Money.new(1_000, "TND")
+        "1".to_money("CLP").should == Money.new(1,     "CLP")
+        "1.5".to_money("KWD").cents.should == 1500
+      end
+    end
+
+    describe "#to_currency" do
+      it "should convert string to Currency" do
+        "USD".to_currency.should == Money::Currency.new(:usd)
+        "EUR".to_currency.should == Money::Currency.new(:eur)
+      end
+
+      it "should raise Money::Currency::UnknownCurrency with unknown Currency" do
+        lambda { "XXX".to_currency }.should raise_error(Money::Currency::UnknownCurrency)
+        lambda { " ".to_currency }.should raise_error(Money::Currency::UnknownCurrency)
+      end
+    end
+  end
+
+  describe Symbol do
+    describe "#to_currency" do
+      it "should convert symbol to Currency" do
+        :usd.to_currency.should == Money::Currency.new(:usd)
+        :ars.to_currency.should == Money::Currency.new(:ars)
+      end
+      it "should work case-insensitive" do
+        :EUR.to_currency.should == Money::Currency.new(:eur)
+      end
+      it "should raise Money::Currency::UnknownCurrency with unknown Currency" do
+        lambda { :XXX.to_currency }.should raise_error(Money::Currency::UnknownCurrency)
+        lambda { :" ".to_currency }.should raise_error(Money::Currency::UnknownCurrency)
+      end
+    end
+  end
+
+end