money 6.5.1 → 6.16.0

data/spec/money_spec.rb

@@ -1,745 +0,0 @@
-# encoding: utf-8
-
-require "spec_helper"
-
-describe Money do
-  describe ".new" do
-    let(:initializing_value) { 1 }
-    subject(:money) { Money.new(initializing_value) }
-
-    it "should be an instance of `Money::Bank::VariableExchange`" do
-      expect(money.bank).to be Money::Bank::VariableExchange.instance
-    end
-
-    context 'given the initializing value is an integer' do
-      let(:initializing_value) { Integer(1) }
-      it 'stores the integer as the number of cents' do
-        expect(money.cents).to eq initializing_value
-      end
-    end
-
-    context 'given the initializing value is a float' do
-      context 'and the value is 1.00' do
-        let(:initializing_value) { 1.00 }
-        it { is_expected.to eq Money.new(1) }
-      end
-
-      context 'and the value is 1.01' do
-        let(:initializing_value) { 1.01 }
-        it { is_expected.to eq Money.new(1) }
-      end
-
-      context 'and the value is 1.50' do
-        let(:initializing_value) { 1.50 }
-        it { is_expected.to eq Money.new(2) }
-      end
-    end
-
-    context 'given the initializing value is a rational' do
-      let(:initializing_value) { Rational(1) }
-      it { is_expected.to eq Money.new(1) }
-    end
-
-    context 'given the initializing value is money' do
-      let(:initializing_value) { Money.new(1_00, Money::Currency.new('NZD')) }
-      it { is_expected.to eq initializing_value }
-    end
-
-    context "given the initializing value doesn't respond to .to_d" do
-      let(:initializing_value) { :"1" }
-      it { is_expected.to eq Money.new(1) }
-    end
-
-    context 'given a currency is not provided' do
-      subject(:money) { Money.new(initializing_value) }
-
-      it "should have the default currency" do
-        expect(money.currency).to eq Money.default_currency
-      end
-    end
-
-    context 'given a currency is provided' do
-      subject(:money) { Money.new(initializing_value, currency) }
-
-      context 'and the currency is NZD' do
-        let(:currency) { Money::Currency.new('NZD') }
-
-        it "should have NZD currency" do
-          expect(money.currency).to eq Money::Currency.new('NZD')
-        end
-      end
-
-      context 'and the currency is nil' do
-        let(:currency) { nil }
-
-        it "should have the default currency" do
-          expect(money.currency).to eq Money.default_currency
-        end
-      end
-    end
-
-    context "infinite_precision = true" do
-      before { expect(Money).to receive(:infinite_precision).and_return(true) }
-      context 'given the initializing value is 1.50' do
-        let(:initializing_value) { 1.50 }
-
-        it "should have the correct cents" do
-          expect(money.cents).to eq BigDecimal('1.50')
-        end
-      end
-    end
-  end
-
-  describe ".add_rate" do
-    before do
-      @default_bank = Money.default_bank
-      Money.default_bank = Money::Bank::VariableExchange.new
-    end
-
-    after do
-      Money.default_bank = @default_bank
-    end
-
-    it "saves rate into current bank" do
-      Money.add_rate("EUR", "USD", 10)
-      expect(Money.new(10_00, "EUR").exchange_to("USD")).to eq Money.new(100_00, "USD")
-    end
-  end
-
-  describe ".disallow_currency_conversions!" do
-    before do
-      @default_bank = Money.default_bank
-    end
-
-    after do
-      Money.default_bank = @default_bank
-    end
-
-    it "disallows conversions when doing money arithmetic" do
-      Money.disallow_currency_conversion!
-      expect { Money.new(100, "USD") + Money.new(100, "EUR") }.to raise_exception(Money::Bank::DifferentCurrencyError)
-    end
-  end
-
-  %w[cents pence].each do |units|
-    describe "##{units}" do
-      it "is a synonym of #fractional" do
-        expectation = Money.new(0)
-        def expectation.fractional
-          "expectation"
-        end
-        expect(expectation.cents).to eq "expectation"
-      end
-    end
-  end
-
-  describe "#fractional" do
-    it "returns the amount in fractional unit" do
-      expect(Money.new(1_00).fractional).to eq 1_00
-    end
-
-    it "stores fractional as an integer regardless of what is passed into the constructor" do
-      m = Money.new(100)
-      expect(m.fractional).to eq 100
-      expect(m.fractional).to be_a(Fixnum)
-    end
-
-    context "loading a serialized Money via YAML" do
-
-      let(:serialized) { <<YAML
-!ruby/object:Money
-  fractional: 249.5
-  currency: !ruby/object:Money::Currency
-    id: :eur
-    priority: 2
-    iso_code: EUR
-    name: Euro
-    symbol: €
-    alternate_symbols: []
-    subunit: Cent
-    subunit_to_unit: 100
-    symbol_first: true
-    html_entity: ! '&#x20AC;'
-    decimal_mark: ! ','
-    thousands_separator: .
-    iso_numeric: '978'
-    mutex: !ruby/object:Mutex {}
-    last_updated: 2012-11-23 20:41:47.454438399 +02:00
-YAML
-      }
-
-      it "uses BigDecimal when rounding" do
-        m = YAML::load serialized
-        expect(m).to be_a(Money)
-        expect(m.class.infinite_precision).to be false
-        expect(m.fractional).to eq 250 # 249.5 rounded up
-        expect(m.fractional).to be_a(Integer)
-      end
-
-      context "with infinite_precision" do
-        before do
-          Money.infinite_precision = true
-        end
-
-        after do
-          Money.infinite_precision = false
-        end
-
-        it "is a BigDecimal" do
-          money = YAML::load serialized
-          expect(money.fractional).to be_a BigDecimal
-        end
-      end
-    end
-
-    context "user changes rounding_mode" do
-      after do
-        Money.rounding_mode = BigDecimal::ROUND_HALF_EVEN
-      end
-
-      context "with the setter" do
-        it "respects the rounding_mode" do
-          Money.rounding_mode = BigDecimal::ROUND_DOWN
-          expect(Money.new(1.9).fractional).to eq 1
-
-          Money.rounding_mode = BigDecimal::ROUND_UP
-          expect(Money.new(1.1).fractional).to eq 2
-        end
-      end
-
-      context "with a block" do
-        it "respects the rounding_mode" do
-          expect(Money.rounding_mode(BigDecimal::ROUND_DOWN) do
-            Money.new(1.9).fractional
-          end).to eq 1
-
-          expect(Money.rounding_mode(BigDecimal::ROUND_UP) do
-            Money.new(1.1).fractional
-          end).to eq 2
-
-          expect(Money.rounding_mode).to eq BigDecimal::ROUND_HALF_EVEN
-        end
-
-        it "works for multiplication within a block" do
-          Money.rounding_mode(BigDecimal::ROUND_DOWN) do
-            expect((Money.new(1_00) * "0.019".to_d).fractional).to eq 1
-          end
-
-          Money.rounding_mode(BigDecimal::ROUND_UP) do
-            expect((Money.new(1_00) * "0.011".to_d).fractional).to eq 2
-          end
-
-          expect(Money.rounding_mode).to eq BigDecimal::ROUND_HALF_EVEN
-        end
-      end
-    end
-
-    context "infinite_precision = true" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "returns the amount in fractional unit" do
-        expect(Money.new(1_00).fractional).to eq BigDecimal("100")
-      end
-
-      it "stores in fractional unit as an integer regardless of what is passed into the constructor" do
-        m = Money.new(100)
-        expect(m.fractional).to eq BigDecimal("100")
-        expect(m.fractional).to be_a(BigDecimal)
-      end
-    end
-  end
-  
-  describe "#round_to_nearest_cash_value" do
-    it "rounds to the nearest possible cash value" do
-      money = Money.new(2350, "AED")
-      expect(money.round_to_nearest_cash_value).to eq 2350
-      
-      money = Money.new(-2350, "AED")
-      expect(money.round_to_nearest_cash_value).to eq(-2350)
-      
-      money = Money.new(2213, "AED")
-      expect(money.round_to_nearest_cash_value).to eq 2225
-      
-      money = Money.new(-2213, "AED")
-      expect(money.round_to_nearest_cash_value).to eq(-2225)
-      
-      money = Money.new(2212, "AED")
-      expect(money.round_to_nearest_cash_value).to eq 2200
-      
-      money = Money.new(-2212, "AED")
-      expect(money.round_to_nearest_cash_value).to eq(-2200)
-    
-      money = Money.new(178, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq 180
-      
-      money = Money.new(-178, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq(-180)
-      
-      money = Money.new(177, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq 175
-      
-      money = Money.new(-177, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq(-175)
-      
-      money = Money.new(175, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq 175
-      
-      money = Money.new(-175, "CHF")
-      expect(money.round_to_nearest_cash_value).to eq(-175)
-      
-      money = Money.new(299, "USD")
-      expect(money.round_to_nearest_cash_value).to eq 299
-      
-      money = Money.new(-299, "USD")
-      expect(money.round_to_nearest_cash_value).to eq(-299)
-      
-      money = Money.new(300, "USD")
-      expect(money.round_to_nearest_cash_value).to eq 300
-      
-      money = Money.new(-300, "USD")
-      expect(money.round_to_nearest_cash_value).to eq(-300)
-      
-      money = Money.new(301, "USD")
-      expect(money.round_to_nearest_cash_value).to eq 301
-      
-      money = Money.new(-301, "USD")
-      expect(money.round_to_nearest_cash_value).to eq(-301)
-    end
-    
-    it "raises an exception if smallest denomination is not defined" do
-      money = Money.new(100, "XAG")
-      expect {money.round_to_nearest_cash_value}.to raise_error(Money::UndefinedSmallestDenomination)
-    end
-    
-    it "returns a Fixnum when infinite_precision is not set" do
-      money = Money.new(100, "USD")
-      expect(money.round_to_nearest_cash_value).to be_a Fixnum
-    end
-  
-    context "with infinite_precision" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "returns a BigDecimal" do
-        money = Money.new(100, "EUR")
-        expect(money.round_to_nearest_cash_value).to be_a BigDecimal
-      end
-    end
-  end
-
-  describe "#amount" do
-    it "returns the amount of cents as dollars" do
-      expect(Money.new(1_00).amount).to eq 1
-    end
-
-    it "respects :subunit_to_unit currency property" do
-      expect(Money.new(1_00,  "USD").amount).to eq 1
-      expect(Money.new(1_000, "TND").amount).to eq 1
-      expect(Money.new(1,     "VUV").amount).to eq 1
-    end
-
-    it "does not loose precision" do
-      expect(Money.new(100_37).amount).to eq 100.37
-    end
-
-    it 'produces a BigDecimal' do
-      expect(Money.new(1_00).amount).to be_a BigDecimal
-    end
-  end
-
-  describe "#dollars" do
-    it "is synonym of #amount" do
-      m = Money.new(0)
-
-      # Make a small expectation
-      def m.amount
-        5
-      end
-
-      expect(m.dollars).to eq 5
-    end
-  end
-
-  describe "#currency" do
-    it "returns the currency object" do
-      expect(Money.new(1_00, "USD").currency).to eq Money::Currency.new("USD")
-    end
-  end
-
-  describe "#currency_as_string" do
-    it "returns the iso_code of the currency object" do
-      expect(Money.new(1_00, "USD").currency_as_string).to eq "USD"
-      expect(Money.new(1_00, "EUR").currency_as_string).to eq "EUR"
-    end
-  end
-
-  describe "#currency_as_string=" do
-    it "sets the currency object using the provided string" do
-      money = Money.new(100_00, "USD")
-      money.currency_as_string = "EUR"
-      expect(money.currency).to eq Money::Currency.new("EUR")
-      money.currency_as_string = "YEN"
-      expect(money.currency).to eq Money::Currency.new("YEN")
-    end
-  end
-
-  describe "#hash=" do
-    it "returns the same value for equal objects" do
-      expect(Money.new(1_00, "EUR").hash).to eq Money.new(1_00, "EUR").hash
-      expect(Money.new(2_00, "USD").hash).to eq Money.new(2_00, "USD").hash
-      expect(Money.new(1_00, "EUR").hash).not_to eq Money.new(2_00, "EUR").hash
-      expect(Money.new(1_00, "EUR").hash).not_to eq Money.new(1_00, "USD").hash
-      expect(Money.new(1_00, "EUR").hash).not_to eq Money.new(2_00, "USD").hash
-    end
-
-    it "can be used to return the intersection of Money object arrays" do
-      intersection = [Money.new(1_00, "EUR"), Money.new(1_00, "USD")] & [Money.new(1_00, "EUR")]
-      expect(intersection).to eq [Money.new(1_00, "EUR")]
-    end
-  end
-
-  describe "#symbol" do
-    it "works as documented" do
-      currency = Money::Currency.new("EUR")
-      expect(currency).to receive(:symbol).and_return("€")
-      expect(Money.new(0, currency).symbol).to eq "€"
-
-      currency = Money::Currency.new("EUR")
-      expect(currency).to receive(:symbol).and_return(nil)
-      expect(Money.new(0, currency).symbol).to eq "¤"
-    end
-  end
-
-  describe "#to_s" do
-    it "works as documented" do
-      expect(Money.new(10_00).to_s).to eq "10.00"
-      expect(Money.new(400_08).to_s).to eq "400.08"
-      expect(Money.new(-237_43).to_s).to eq "-237.43"
-    end
-
-    it "respects :subunit_to_unit currency property" do
-      expect(Money.new(10_00, "BHD").to_s).to eq "1.000"
-      expect(Money.new(10_00, "CNY").to_s).to eq "10.00"
-    end
-
-    it "does not have decimal when :subunit_to_unit == 1" do
-      expect(Money.new(10_00, "VUV").to_s).to eq "1000"
-    end
-
-    it "does not work when :subunit_to_unit == 5" do
-      expect(Money.new(10_00, "MGA").to_s).to eq "200.0"
-    end
-
-    it "respects :decimal_mark" do
-      expect(Money.new(10_00, "BRL").to_s).to eq "10,00"
-    end
-
-    context "infinite_precision = true" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "shows fractional cents" do
-        expect(Money.new(1.05, "USD").to_s).to eq "0.0105"
-      end
-
-      it "suppresses fractional cents when there is none" do
-        expect(Money.new(1.0, "USD").to_s).to eq "0.01"
-      end
-
-      it "shows fractional if needed when :subunut_to_unit == 1" do
-        expect(Money.new(10_00.1, "VUV").to_s).to eq "1000.1"
-      end
-    end
-  end
-
-  describe "#to_d" do
-    it "works as documented" do
-      decimal = Money.new(10_00).to_d
-      expect(decimal).to be_a(BigDecimal)
-      expect(decimal).to eq 10.0
-    end
-
-    it "respects :subunit_to_unit currency property" do
-      decimal = Money.new(10_00, "BHD").to_d
-      expect(decimal).to be_a(BigDecimal)
-      expect(decimal).to eq 1.0
-    end
-
-    it "works with float :subunit_to_unit currency property" do
-      money = Money.new(10_00, "BHD")
-      allow(money.currency).to receive(:subunit_to_unit).and_return(1000.0)
-
-      decimal = money.to_d
-      expect(decimal).to be_a(BigDecimal)
-      expect(decimal).to eq 1.0
-    end
-  end
-
-  describe "#to_f" do
-    it "works as documented" do
-      expect(Money.new(10_00).to_f).to eq 10.0
-    end
-
-    it "respects :subunit_to_unit currency property" do
-      expect(Money.new(10_00, "BHD").to_f).to eq 1.0
-    end
-  end
-
-  describe "#to_i" do
-    it "works as documented" do
-      expect(Money.new(10_00).to_i).to eq 10
-    end
-
-    it "respects :subunit_to_unit currency property" do
-      expect(Money.new(10_00, "BHD").to_i).to eq 1
-    end
-  end
-
-  describe "#to_money" do
-    it "works as documented" do
-      money = Money.new(10_00, "DKK")
-      expect(money).to eq money.to_money
-      expect(money).to eq money.to_money("DKK")
-      expect(money.bank).to receive(:exchange_with).with(Money.new(10_00, Money::Currency.new("DKK")), Money::Currency.new("EUR")).and_return(Money.new(200_00, Money::Currency.new('EUR')))
-      expect(money.to_money("EUR")).to eq Money.new(200_00, "EUR")
-    end
-  end
-
-  describe "#exchange_to" do
-    it "exchanges the amount via its exchange bank" do
-      money = Money.new(100_00, "USD")
-      expect(money.bank).to receive(:exchange_with).with(Money.new(100_00, Money::Currency.new("USD")), Money::Currency.new("EUR")).and_return(Money.new(200_00, Money::Currency.new('EUR')))
-      money.exchange_to("EUR")
-    end
-
-    it "exchanges the amount properly" do
-      money = Money.new(100_00, "USD")
-      expect(money.bank).to receive(:exchange_with).with(Money.new(100_00, Money::Currency.new("USD")), Money::Currency.new("EUR")).and_return(Money.new(200_00, Money::Currency.new('EUR')))
-      expect(money.exchange_to("EUR")).to eq Money.new(200_00, "EUR")
-    end
-
-    it 'uses the block given as rounding method' do
-      money = Money.new(100_00, 'USD')
-      expect(money.bank).to receive(:exchange_with).and_yield(300_00)
-      expect { |block| money.exchange_to(Money::Currency.new('EUR'), &block) }.to yield_successive_args(300_00)
-    end
-
-    it "does no exchange when the currencies are the same" do
-      money = Money.new(100_00, "USD")
-      expect(money.bank).to_not receive(:exchange_with)
-      expect(money.exchange_to("USD")).to eq money
-    end
-  end
-
-  describe "#allocate" do
-    it "takes no action when one gets all" do
-      expect(Money.us_dollar(005).allocate([1.0])).to eq [Money.us_dollar(5)]
-    end
-
-    it "keeps currencies intact" do
-      expect(Money.ca_dollar(005).allocate([1])).to eq [Money.ca_dollar(5)]
-    end
-
-    it "does not loose pennies" do
-      moneys = Money.us_dollar(5).allocate([0.3, 0.7])
-      expect(moneys[0]).to eq Money.us_dollar(2)
-      expect(moneys[1]).to eq Money.us_dollar(3)
-    end
-
-    it "does not loose pennies" do
-      moneys = Money.us_dollar(100).allocate([0.333, 0.333, 0.333])
-      expect(moneys[0].cents).to eq 34
-      expect(moneys[1].cents).to eq 33
-      expect(moneys[2].cents).to eq 33
-    end
-
-    it "requires total to be less then 1" do
-      expect { Money.us_dollar(0.05).allocate([0.5, 0.6]) }.to raise_error(ArgumentError)
-    end
-
-    context "infinite_precision = true" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "allows for fractional cents allocation" do
-        one_third = BigDecimal("1") / BigDecimal("3")
-
-        moneys = Money.new(100).allocate([one_third, one_third, one_third])
-        expect(moneys[0].cents).to eq one_third * BigDecimal("100")
-        expect(moneys[1].cents).to eq one_third * BigDecimal("100")
-        expect(moneys[2].cents).to eq one_third * BigDecimal("100")
-      end
-    end
-  end
-
-  describe "#split" do
-    it "needs at least one party" do
-      expect { Money.us_dollar(1).split(0) }.to raise_error(ArgumentError)
-      expect { Money.us_dollar(1).split(-1) }.to raise_error(ArgumentError)
-    end
-
-    it "gives 1 cent to both people if we start with 2" do
-      expect(Money.us_dollar(2).split(2)).to eq [Money.us_dollar(1), Money.us_dollar(1)]
-    end
-
-    it "may distribute no money to some parties if there isnt enough to go around" do
-      expect(Money.us_dollar(2).split(3)).to eq [Money.us_dollar(1), Money.us_dollar(1), Money.us_dollar(0)]
-    end
-
-    it "does not lose pennies" do
-      expect(Money.us_dollar(5).split(2)).to eq [Money.us_dollar(3), Money.us_dollar(2)]
-    end
-
-    it "splits a dollar" do
-      moneys = Money.us_dollar(100).split(3)
-      expect(moneys[0].cents).to eq 34
-      expect(moneys[1].cents).to eq 33
-      expect(moneys[2].cents).to eq 33
-    end
-
-    context "infinite_precision = true" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "allows for splitting by fractional cents" do
-        thirty_three_and_one_third = BigDecimal("100") / BigDecimal("3")
-
-        moneys = Money.new(100).split(3)
-        expect(moneys[0].cents).to eq thirty_three_and_one_third
-        expect(moneys[1].cents).to eq thirty_three_and_one_third
-        expect(moneys[2].cents).to eq thirty_three_and_one_third
-      end
-    end
-  end
-
-  describe "#round" do
-
-    let(:money) { Money.new(15.75, 'NZD') }
-    subject(:rounded) { money.round }
-
-    context "without infinite_precision" do
-      before do
-        Money.infinite_precision = false
-      end
-
-      it "returns self (as it is already rounded)" do
-        rounded = money.round
-        expect(rounded).to be money
-        expect(rounded.cents).to eq 16
-      end
-    end
-
-    context "with infinite_precision" do
-      before do
-        Money.infinite_precision = true
-      end
-
-      after do
-        Money.infinite_precision = false
-      end
-
-      it "returns a different money" do
-        expect(rounded).not_to be money
-      end
-
-      it "rounds the cents" do
-        expect(rounded.cents).to eq 16
-      end
-
-      it "maintains the currency" do
-        expect(rounded.currency).to eq Money::Currency.new('NZD')
-      end
-
-      it "uses a provided rounding strategy" do
-        rounded = money.round(BigDecimal::ROUND_DOWN)
-        expect(rounded.cents).to eq 15
-      end
-    end
-  end
-
-  describe "inheritance" do
-    it "allows inheritance" do
-      # TypeError:
-      #   wrong argument type nil (expected Fixnum)
-      # ./lib/money/money.rb:63:in `round'
-      # ./lib/money/money.rb:63:in `fractional'
-      # ./lib/money/money/arithmetic.rb:115:in `-'
-      MoneyChild = Class.new(Money)
-      expect(MoneyChild.new(1000) - Money.new(500)).to eq Money.new(500)
-    end
-  end
-
-  describe "#as_*" do
-    before do
-      Money.default_bank = Money::Bank::VariableExchange.new
-      Money.add_rate("EUR", "USD", 1)
-      Money.add_rate("EUR", "CAD", 1)
-      Money.add_rate("USD", "EUR", 1)
-    end
-
-    after do
-      Money.default_bank = Money::Bank::VariableExchange.instance
-    end
-
-    specify "as_us_dollar converts Money object to USD" do
-      obj = Money.new(1, "EUR")
-      expect(obj.as_us_dollar).to eq Money.new(1, "USD")
-    end
-
-    specify "as_ca_dollar converts Money object to CAD" do
-      obj = Money.new(1, "EUR")
-      expect(obj.as_ca_dollar).to eq Money.new(1, "CAD")
-    end
-
-    specify "as_euro converts Money object to EUR" do
-      obj = Money.new(1, "USD")
-      expect(obj.as_euro).to eq Money.new(1, "EUR")
-    end
-  end
-
-  describe ".default_currency" do
-    before do
-      @default_currency = Money.default_currency
-    end
-
-    after do
-      Money.default_currency = @default_currency
-    end
-
-    it "accepts a lambda" do
-      Money.default_currency = lambda { :eur }
-      expect(Money.default_currency).to eq Money::Currency.new(:eur)
-    end
-
-    it "accepts a symbol" do
-      Money.default_currency = :eur
-      expect(Money.default_currency).to eq Money::Currency.new(:eur)
-    end
-  end
-end