money 1.7.1 → 2.0.0

data/MIT-LICENSE

@@ -1,4 +1,5 @@
 Copyright (c) 2005 Tobias Lutke
+Copyright (c) 2008 Phusion
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -17,4 +18,4 @@ 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.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,97 @@
+= Introduction
+
+This library aids one in handling money and different currencies. Features:
+
+- Provides a Money class which encapsulates all information about an certain
+  amount of money, such as its value and its currency.
+- Represents monetary values as integers, in cents. This avoids floating point
+  rounding errors.
+- Provides APIs for exchanging money from one currency to another.
+- Has the ability to parse a money string into a Money object.
+
+Resources:
+
+- Website: http://money.rubyforge.org
+- RDoc API: http://money.rubyforge.org
+- Git repository: http://github.com/FooBarWidget/money/tree/master
+
+== Download
+
+Install stable releases with the following command:
+
+  gem install money
+
+The development version (hosted on Github) can be installed with:
+
+  gem sources -a http://gems.github.com
+  gem install FooBarWidget-money
+
+== Usage
+
+=== Synopsis
+
+  require 'money'
+  
+  # 10.00 USD
+  money = Money.new(1000, "USD")
+  money.cents     # => 1000
+  money.currency  # => "USD"
+  
+  Money.new(1000, "USD") == Money.new(1000, "USD")   # => true
+  Money.new(1000, "USD") == Money.new(100, "USD")    # => false
+  Money.new(1000, "USD") == Money.new(1000, "EUR")   # => false
+
+=== Currency Exchange
+
+Exchanging money is performed through an exchange bank object. The default
+exchange bank object requires one to manually specify the exchange rate. Here's
+an example of how it works:
+
+  Money.add_rate("USD", "CAD", 1.24515)
+  Money.add_rate("CAD", "USD", 0.803115)
+  
+  Money.us_dollar(100).exchange_to("CAD")  # => Money.new(124, "CAD")
+  Money.ca_dollar(100).exchange_to("USD")  # => Money.new(80, "USD")
+
+Comparison and arithmetic operations work as expected:
+
+  Money.new(1000, "USD") <=> Money.new(900, "USD")   # => 1; 9.00 USD is smaller
+  Money.new(1000, "EUR") + Money.new(10, "EUR") == Money.new(1010, "EUR")
+  
+  Money.add_rate("USD", "EUR", 0.5)
+  Money.new(1000, "EUR") + Money.new(1000, "USD") == Money.new(1500, "EUR")
+
+There is nothing stopping you from creating bank objects which scrapes
+www.xe.com for the current rates or just returns <tt>rand(2)</tt>:
+
+  Money.default_bank = ExchangeBankWhichScrapesXeDotCom.new
+
+=== Ruby on Rails
+
+Use the +compose_of+ helper to let Active Record deal with embedding the money
+object in your models. The following example requires a +cents+ and a +currency+
+field.
+
+  class ProductUnit < ActiveRecord::Base
+    belongs_to :product
+    composed_of :price, :class_name => "Money", :mapping => [%w(cents cents), %w(currency currency)]
+    
+    private        
+      validate :cents_not_zero
+      
+      def cents_not_zero
+        errors.add("cents", "cannot be zero or less") unless cents > 0
+      end
+      
+      validates_presence_of :sku, :currency
+      validates_uniqueness_of :sku        
+  end
+  
+=== Default Currency
+
+By default Money defaults to USD as its currency. This can be overwritten using
+
+  Money.default_currency = "CAD"
+
+If you use Rails, then environment.rb is a very good place to put this. 
+

data/Rakefile

@@ -0,0 +1,18 @@
+desc "Build a gem"
+task :gem do
+	sh "gem build money.gemspec"
+end
+
+task "Generate RDoc documentation"
+task :rdoc do
+	sh "hanna README.rdoc lib -U"
+end
+
+task :upload => :rdoc do
+	sh "scp -r doc/* rubyforge.org:/var/www/gforge-projects/money/"
+end
+
+desc "Run unit tests"
+task :test do
+	sh "spec -f s -c test/*_spec.rb"
+end

data/lib/money.rb

@@ -1,5 +1,5 @@
-#--
 # Copyright (c) 2005 Tobias Luetke
+# Copyright (c) 2008 Phusion
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -19,11 +19,7 @@
 # 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.
-#++
 
-
-require File.dirname(__FILE__) + '/support/cattr_accessor'
-require File.dirname(__FILE__) + '/bank/no_exchange_bank'
-require File.dirname(__FILE__) + '/bank/variable_exchange_bank'
-require File.dirname(__FILE__) + '/money/money'
-require File.dirname(__FILE__) + '/money/core_extensions'
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__))
+require 'money/money'
+require 'money/core_extensions'

data/lib/money/core_extensions.rb

@@ -1,25 +1,37 @@
-# Allows Writing of 100.to_money for +Numeric+ types
-#   100.to_money => #<Money @cents=10000>
-#   100.37.to_money => #<Money @cents=10037>
 class Numeric
+  # Converts this numeric to a Money object in the default currency. It
+  # multiplies the numeric value by 100 and treats that as cents.
+  #
+  #   100.to_money => #<Money @cents=10000>
+  #   100.37.to_money => #<Money @cents=10037>
   def to_money
     Money.new(self * 100)
   end
 end
 
-# Allows Writing of '100'.to_money for +String+ types
-# Excess characters will be discarded
-#   '100'.to_money => #<Money @cents=10000>
-#   '100.37'.to_money => #<Money @cents=10037>
 class String
+  # Parses the current string and converts it to a Money object.
+  # Excess characters will be discarded.
+  #
+  #   '100'.to_money       # => #<Money @cents=10000>
+  #   '100.37'.to_money    # => #<Money @cents=10037>
+  #   '100 USD'.to_money   # => #<Money @cents=10000, @currency="USD">
+  #   'USD 100'.to_money   # => #<Money @cents=10000, @currency="USD">
+  #   '$100 USD'.to_money   # => #<Money @cents=10000, @currency="USD">
   def to_money
-    # Get the currency
+    # Get the currency.
     matches = scan /([A-Z]{2,3})/ 
     currency = matches[0] ? matches[0][0] : Money.default_currency
     
     # Get the cents amount
-    matches = scan /(\-?\d+(\.(\d+))?)/
-    cents = matches[0] ? (matches[0][0].to_f * 100) : 0
+    matches = scan /(\-?[\d ]+([\.,](\d+))?)/
+    cents = if matches[0]
+              value = matches[0][0].gsub(/,/, '.')
+              value.gsub!(/ +/, '')
+              value.to_f * 100
+            else
+              0
+            end
     
     Money.new(cents, currency)
   end

data/lib/money/errors.rb

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

data/lib/money/money.rb

@@ -1,64 +1,89 @@
-# === Usage with ActiveRecord
-# 
-# Use the compose_of helper to let active record deal with embedding the money
-# object in your models. The following example requires a cents and a currency field.
-# 
-#   class ProductUnit < ActiveRecord::Base
-#     belongs_to :product
-#     composed_of :price, :class_name => "Money", :mapping => [ %w(cents cents), %w(currency currency) ]
-# 
-#     private        
-#       validate :cents_not_zero
-#     
-#       def cents_not_zero
-#         errors.add("cents", "cannot be zero or less") unless cents > 0
-#       end
-#     
-#       validates_presence_of :sku, :currency
-#       validates_uniqueness_of :sku        
-#   end
-#   
+require 'money/variable_exchange_bank'
+
+# Represents an amount of money in a certain currency.
 class Money
   include Comparable
-
-  attr_reader :cents, :currency
-
-  class MoneyError < StandardError# :nodoc:
+  
+  attr_reader :cents, :currency, :bank
+  
+  class << self
+    # Each Money object is associated to a bank object, which is responsible
+    # for currency exchange. This property allows one to specify the default
+    # bank object.
+    #
+    #   bank1 = MyBank.new
+    #   bank2 = MyOtherBank.new
+    #   
+    #   Money.default_bank = bank1
+    #   money1 = Money.new(10)
+    #   money1.bank  # => bank1
+    #   
+    #   Money.default_bank = bank2
+    #   money2 = Money.new(10)
+    #   money2.bank  # => bank2
+    #   money1.bank  # => bank1
+    #
+    # The default value for this property is an instance if VariableExchangeBank.
+    # It allows one to specify custom exchange rates:
+    #
+    #   Money.default_bank.add_rate("USD", "CAD", 1.24515)
+    #   Money.default_bank.add_rate("CAD", "USD", 0.803115)
+    #   Money.us_dollar(100).exchange_to("CAD")  # => Money.ca_dollar(124)
+    #   Money.ca_dollar(100).exchange_to("USD")  # => Money.us_dollar(80)
+    attr_accessor :default_bank
+    
+    # The default currency, which is used when <tt>Money.new</tt> is called
+    # without an explicit currency argument. The default value is "USD".
+    attr_accessor :default_currency
+  end
+  
+  self.default_bank = VariableExchangeBank.instance
+  self.default_currency = "USD"
+  
+  
+  # Create a new money object with value 0.
+  def self.empty(currency = default_currency)
+    Money.new(0, currency)
   end
 
-  # Bank lets you exchange the object which is responsible for currency
-  # exchange. 
-  # The default implementation just throws an exception. However money
-  # ships with a variable exchange bank implementation which supports
-  # custom excahnge rates:
-  #
-  #  Money.bank = VariableExchangeBank.new
-  #  Money.bank.add_rate("USD", "CAD", 1.24515)
-  #  Money.bank.add_rate("CAD", "USD", 0.803115)
-  #  Money.us_dollar(100).exchange_to("CAD") => Money.ca_dollar(124)
-  #  Money.ca_dollar(100).exchange_to("USD") => Money.us_dollar(80)
-  @@bank = NoExchangeBank.new
-  cattr_accessor :bank
-
-  @@default_currency = "USD"
-  cattr_accessor :default_currency
+  # Creates a new Money object of the given value, using the Canadian dollar currency.
+  def self.ca_dollar(cents)
+    Money.new(cents, "CAD")
+  end
 
+  # Creates a new Money object of the given value, using the American dollar currency.
+  def self.us_dollar(cents)
+    Money.new(cents, "USD")
+  end
+  
+  # Creates a new Money object of the given value, using the Euro currency.
+  def self.euro(cents)
+    Money.new(cents, "EUR")
+  end
+  
+  def self.add_rate(from_currency, to_currency, rate)
+    Money.default_bank.add_rate(from_currency, to_currency, rate)
+  end
+  
+  
   # Creates a new money object. 
   #  Money.new(100) 
   # 
   # Alternativly you can use the convinience methods like 
   # Money.ca_dollar and Money.us_dollar 
-  def initialize(cents, currency = default_currency)
-    @cents, @currency = cents.round, currency
+  def initialize(cents, currency = Money.default_currency, bank = Money.default_bank)
+    @cents = cents.round
+    @currency = currency
+    @bank = bank
   end
 
   # Do two money objects equal? Only works if both objects are of the same currency
-  def eql?(other_money)
-    cents == other_money.cents && currency == other_money.currency
+  def ==(other_money)
+    cents == other_money.cents && bank.same_currency?(currency, other_money.currency)
   end
 
   def <=>(other_money)
-    if currency == other_money.currency
+    if bank.same_currency?(currency, other_money.currency)
       cents <=> other_money.cents
     else
       cents <=> other_money.exchange_to(currency).cents
@@ -66,9 +91,6 @@ class Money
   end
 
   def +(other_money)
-    return other_money.dup if cents.zero? 
-    return dup if other_money.cents.zero?
-
     if currency == other_money.currency
       Money.new(cents + other_money.cents, other_money.currency)
     else
@@ -77,24 +99,16 @@ class Money
   end
 
   def -(other_money)
-
     if currency == other_money.currency
       Money.new(cents - other_money.cents, other_money.currency)
     else
-      
-      return other_money.dup if self.cents.zero?
-
-      return self.dup if other_money.cents.zero?
-      
-      
       Money.new(cents - other_money.exchange_to(currency).cents, currency)
-      
     end   
   end
 
   # get the cents value of the object
   def cents
-    @cents.to_i
+    @cents
   end
 
   # multiply money by fixnum
@@ -153,57 +167,37 @@ class Money
     end
     formatted
   end
-
+  
   # Money.ca_dollar(100).to_s => "1.00"
   def to_s
-    sprintf("%.2f", cents.to_f / 100  )
+    sprintf("%.2f", cents / 100.00)
   end
-
-  # Recieve the amount of this money object in another currency   
+  
+  # Recieve the amount of this money object in another currency.
   def exchange_to(other_currency)
-    self.class.bank.reduce(self, other_currency)
+    Money.new(@bank.exchange(self.cents, currency, other_currency), other_currency)
   end  
-
-  # Create a new money object with value 0
-  def self.empty(currency = default_currency)
-    Money.new(0, currency)
-  end
-
-  # Create a new money object using the Canadian dollar currency
-  def self.ca_dollar(num)
-    Money.new(num, "CAD")
-  end
-
-  # Create a new money object using the American dollar currency
-  def self.us_dollar(num)
-    Money.new(num, "USD")
-  end
-
-  # Create a new money object using the Euro currency
-  def self.euro(num)
-    Money.new(num, "EUR")
-  end
-
+  
   # Recieve a money object with the same amount as the current Money object
   # in american dollar 
   def as_us_dollar
     exchange_to("USD")
   end
-
+  
   # Recieve a money object with the same amount as the current Money object
   # in canadian dollar 
   def as_ca_dollar
     exchange_to("CAD")
   end
-
+  
   # Recieve a money object with the same amount as the current Money object
   # in euro
-  def as_ca_euro
+  def as_euro
     exchange_to("EUR")
-  end  
-
+  end
+  
   # Conversation to self
   def to_money
     self
   end  
-end
+end

data/lib/money/variable_exchange_bank.rb

@@ -0,0 +1,72 @@
+require 'thread'
+require 'money/errors'
+
+# Class for aiding in exchanging money between different currencies.
+# By default, the Money class uses an object of this class (accessible through
+# Money#bank) for performing currency exchanges.
+#
+# By default, VariableExchangeBank has no knowledge about conversion rates.
+# One must manually specify them with +add_rate+, after which one can perform
+# exchanges with +exchange+. For example:
+#
+#  bank = Money::VariableExchangeBank.new
+#  bank.add_rate("USD", "CAD", 1.24515)
+#  bank.add_rate("CAD", "USD", 0.803115)
+#  
+#  # Exchange 100 CAD to USD:
+#  bank.exchange(100_00, "CAD", "USD")  # => 124
+#  # Exchange 100 USD to CAD:
+#  bank.exchange(100_00, "USD", "CAD")  # => 80
+class Money
+  class VariableExchangeBank
+    # Returns the singleton instance of VariableExchangeBank.
+    #
+    # By default, <tt>Money.default_bank</tt> returns the same object.
+    def self.instance
+      @@singleton
+    end
+    
+    def initialize
+      @rates = {}
+      @mutex = Mutex.new
+    end
+    
+    # Registers a conversion rate. +from+ and +to+ are both currency names.
+    def add_rate(from, to, rate)
+      @mutex.synchronize do
+        @rates["#{from}_TO_#{to}".upcase] = rate
+      end
+    end
+    
+    # Gets the rate for exchanging the currency named +from+ to the currency
+    # named +to+. Returns nil if the rate is unknown.
+    def get_rate(from, to)
+      @mutex.synchronize do
+        @rates["#{from}_TO_#{to}".upcase] 
+      end
+    end
+    
+    # Given two currency names, checks whether they're both the same currency.
+    #
+    #   bank = VariableExchangeBank.new
+    #   bank.same_currency?("usd", "USD")   # => true
+    #   bank.same_currency?("usd", "EUR")   # => false
+    def same_currency?(currency1, currency2)
+      currency1.upcase == currency2.upcase
+    end
+    
+    # Exchange the given amount of cents in +from_currency+ to +to_currency+.
+    # Returns the amount of cents in +to_currency+ as an integer, rounded down.
+    #
+    # If the conversion rate is unknown, then Money::UnknownRate will be raised.
+    def exchange(cents, from_currency, to_currency)
+      rate = get_rate(from_currency, to_currency)
+      if !rate
+        raise Money::UnknownRate, "No conversion rate known for '#{from_currency}' -> '#{to_currency}'"
+      end
+      (cents * rate).floor
+    end
+    
+    @@singleton = VariableExchangeBank.new
+  end
+end

data/money.gemspec

@@ -0,0 +1,23 @@
+Gem::Specification.new do |s|
+  s.name = "money"
+  s.version = "2.0.0"
+  s.summary = "Money and currency exchange support library"
+  s.email = "hongli@phusion.nl"
+  s.homepage = "http://money.rubyforge.org/"
+  s.description = "Money and currency exchange support library."
+  s.has_rdoc = true
+  s.rubyforge_project = "money"
+  s.authors = ["Tobias Luetke", "Hongli Lai"]
+  
+  s.files = [
+      "README.rdoc", "MIT-LICENSE", "money.gemspec", "Rakefile",
+      "lib/money.rb",
+      "lib/money/core_extensions.rb",
+      "lib/money/errors.rb",
+      "lib/money/money.rb",
+      "lib/money/variable_exchange_bank.rb",
+      "test/core_extensions_spec.rb",
+      "test/exchange_bank_spec.rb",
+      "test/money_spec.rb"
+  ]
+end

data/test/core_extensions_spec.rb

@@ -0,0 +1,33 @@
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__) + "/../lib")
+require 'money/core_extensions'
+
+describe "Money core extensions" do
+	specify "Numberic#to_money works" 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
+	end
+	
+	specify "String#to_money works" do
+		"100".to_money.should == Money.new(100_00)
+		"100.37".to_money.should == Money.new(100_37)
+		"100,37".to_money.should == Money.new(100_37)
+		"100 000".to_money.should == Money.new(100_000_00)
+		
+		"100 USD".to_money.should == Money.new(100_00, "USD")
+		"100 EUR".to_money.should == Money.new(100_00, "EUR")
+		"100.37 EUR".to_money.should == Money.new(100_37, "EUR")
+		"100,37 EUR".to_money.should == Money.new(100_37, "EUR")
+		
+		"USD 100".to_money.should == Money.new(100_00, "USD")
+		"EUR 100".to_money.should == Money.new(100_00, "EUR")
+		"EUR 100.37".to_money.should == Money.new(100_37, "EUR")
+		"EUR 100,37".to_money.should == Money.new(100_37, "EUR")
+		
+		"$100 USD".to_money.should == Money.new(100_00, "USD")
+	end
+end

data/test/exchange_bank_spec.rb

@@ -0,0 +1,45 @@
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__) + "/../lib")
+require 'money/variable_exchange_bank'
+
+describe Money::VariableExchangeBank do
+	before :each do
+		@bank = Money::VariableExchangeBank.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 "raises Money::UnknownRate upon conversion if the conversion rate is unknown" do
+		block = lambda { @bank.exchange(10, "USD", "EUR") }
+		block.should raise_error(Money::UnknownRate)
+	end
+end

data/test/money_spec.rb

@@ -0,0 +1,124 @@
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__) + "/../lib")
+require 'money/money'
+
+describe Money do
+	it "is associated to the singleton instance of VariableExchangeBank by default" do
+		Money.new(0).bank.object_id.should == Money::VariableExchangeBank.instance.object_id
+	end
+	
+	specify "#cents returns the amount of cents passed to the constructor" do
+		Money.new(200_00, "USD").cents.should == 200_00
+	end
+	
+	it "rounds the given cents to an integer" do
+		Money.new(1.00, "USD").cents.should == 1
+		Money.new(1.01, "USD").cents.should == 1
+		Money.new(1.50, "USD").cents.should == 2
+	end
+	
+	specify "#currency returns the currency passed to the constructor" do
+		Money.new(200_00, "USD").currency.should == "USD"
+	end
+	
+	specify "#zero? returns whether the amount is 0" do
+		Money.new(0, "USD").should be_zero
+		Money.new(0, "EUR").should be_zero
+		Money.new(1, "USD").should_not be_zero
+		Money.new(10, "YEN").should_not be_zero
+		Money.new(-1, "EUR").should_not be_zero
+	end
+	
+	specify "#exchange_to exchanges the amount via its exchange bank" do
+		money = Money.new(100_00, "USD")
+		money.bank.should_receive(:exchange).with(100_00, "USD", "EUR").and_return(200_00)
+		money.exchange_to("EUR")
+	end
+	
+	specify "#exchange_to exchanges the amount properly" do
+		money = Money.new(100_00, "USD")
+		money.bank.should_receive(:exchange).with(100_00, "USD", "EUR").and_return(200_00)
+		money.exchange_to("EUR").should == Money.new(200_00, "EUR")
+	end
+	
+	specify "#== returns true if and only if their amount and currency are equal" do
+		Money.new(1_00, "USD").should == Money.new(1_00, "USD")
+		Money.new(1_00, "USD").should_not == Money.new(1_00, "EUR")
+		Money.new(1_00, "USD").should_not == Money.new(2_00, "USD")
+		Money.new(1_00, "USD").should_not == Money.new(99_00, "EUR")
+	end
+	
+	specify "#* multiplies the money's amount by the multiplier while retaining the currency" do
+		(Money.new(1_00, "USD") * 10).should == Money.new(10_00, "USD")
+	end
+	
+	specify "#* divides the money's amount by the divisor while retaining the currency" do
+		(Money.new(10_00, "USD") / 10).should == Money.new(1_00, "USD")
+	end
+	
+	specify "Money.empty creates a new Money object of 0 cents" do
+		Money.empty.should == Money.new(0)
+	end
+	
+	specify "Money.ca_dollar creates a new Money object of the given value in CAD" do
+		Money.ca_dollar(50).should == Money.new(50, "CAD")
+	end
+	
+	specify "Money.ca_dollar creates a new Money object of the given value in USD" do
+		Money.us_dollar(50).should == Money.new(50, "USD")
+	end
+	
+	specify "Money.ca_dollar creates a new Money object of the given value in EUR" do
+		Money.euro(50).should == Money.new(50, "EUR")
+	end
+	
+	specify "Money.add_rate works" do
+		Money.add_rate("EUR", "USD", 10)
+		Money.new(10_00, "EUR").exchange_to("USD").should == Money.new(100_00, "USD")
+	end
+end
+
+describe "Actions involving two Money objects" do
+	describe "if the other Money object has the same currency" do
+		specify "#<=> compares the two objects' amounts" do
+			(Money.new(1_00, "USD") <=> Money.new(1_00, "USD")).should == 0
+			(Money.new(1_00, "USD") <=> Money.new(99, "USD")).should > 0
+			(Money.new(1_00, "USD") <=> Money.new(2_00, "USD")).should < 0
+		end
+		
+		specify "#+ adds the other object's amount to the current object's amount while retaining the currency" do
+			(Money.new(10_00, "USD") + Money.new(90, "USD")).should == Money.new(10_90, "USD")
+		end
+		
+		specify "#- substracts the other object's amount from the current object's amount while retaining the currency" do
+			(Money.new(10_00, "USD") - Money.new(90, "USD")).should == Money.new(9_10, "USD")
+		end
+	end
+	
+	describe "if the other Money object has a different currency" do
+		specify "#<=> compares the two objects' amount after converting the other object's amount to its own currency" do
+			target = Money.new(200_00, "EUR")
+			target.should_receive(:exchange_to).with("USD").and_return(Money.new(300_00, "USD"))
+			(Money.new(100_00, "USD") <=> target).should < 0
+			
+			target = Money.new(200_00, "EUR")
+			target.should_receive(:exchange_to).with("USD").and_return(Money.new(100_00, "USD"))
+			(Money.new(100_00, "USD") <=> target).should == 0
+			
+			target = Money.new(200_00, "EUR")
+			target.should_receive(:exchange_to).with("USD").and_return(Money.new(99_00, "USD"))
+			(Money.new(100_00, "USD") <=> target).should > 0
+		end
+		
+		specify "#+ adds the other object's amount, converted to this object's currency, to this object's amount while retaining its currency" do
+			other = Money.new(90, "EUR")
+			other.should_receive(:exchange_to).with("USD").and_return(Money.new(9_00, "USD"))
+			(Money.new(10_00, "USD") + other).should == Money.new(19_00, "USD")
+		end
+		
+		specify "#- substracts the other object's amount, converted to this object's currency, from this object's amount while retaining its currency" do
+			other = Money.new(90, "EUR")
+			other.should_receive(:exchange_to).with("USD").and_return(Money.new(9_00, "USD"))
+			(Money.new(10_00, "USD") - other).should == Money.new(1_00, "USD")
+		end
+	end
+end

metadata

@@ -1,49 +1,65 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.11
-specification_version: 1
 name: money
 version: !ruby/object:Gem::Version 
-  version: 1.7.1
-date: 2006-02-13 00:00:00 -05:00
-summary: Class aiding in the handling of Money.
-require_paths: 
-  - lib
-email: tobi@leetsoft.com
-homepage: http://leetsoft.com/rails/money
-rubyforge_project: 
-description: Class aiding in the handling of Money and Currencies.\nIt supports easy pluggable bank objects for customized exchange strategies.\nCan be used as composite in ActiveRecord tables.
-autorequire: money
-default_executable: 
+  version: 2.0.0
+platform: ruby
+authors: 
+- Tobias Luetke
+- Hongli Lai
+autorequire: 
 bindir: bin
+cert_chain: []
+
+date: 2008-10-31 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: Money and currency exchange support library.
+email: hongli@phusion.nl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- MIT-LICENSE
+- money.gemspec
+- Rakefile
+- lib/money.rb
+- lib/money/core_extensions.rb
+- lib/money/errors.rb
+- lib/money/money.rb
+- lib/money/variable_exchange_bank.rb
+- test/core_extensions_spec.rb
+- test/exchange_bank_spec.rb
+- test/money_spec.rb
 has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
+homepage: http://money.rubyforge.org/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
-    - 
-      - ">"
-      - !ruby/object:Gem::Version 
-        version: 0.0.0
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
   version: 
-platform: ruby
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: money
+rubygems_version: 1.2.0
 signing_key: 
-cert_chain: 
-authors: 
-  - Tobias Luetke
-files: 
-  - README
-  - MIT-LICENSE
-  - lib/bank
-  - lib/money
-  - lib/money.rb
-  - lib/support
-  - lib/bank/no_exchange_bank.rb
-  - lib/bank/variable_exchange_bank.rb
-  - lib/money/core_extensions.rb
-  - lib/money/money.rb
-  - lib/support/cattr_accessor.rb
+specification_version: 2
+summary: Money and currency exchange support library
 test_files: []
-rdoc_options: []
-extra_rdoc_files: []
-executables: []
-extensions: []
-requirements: []
-dependencies: []
+

data/README

@@ -1,75 +0,0 @@
-== Money class
-
-This money class is based on the example from the ActiveRecord doc:
-http://api.rubyonrails.org/classes/ActiveRecord/Aggregations/ClassMethods.html
-
-Its in production use at http://www.snowdevil.ca and I haven't found any major issues
-so far. 
-The main reason to open source it is because It might be useful to other people and 
-I hope i'll get some feedback on how to improve the class. 
-
-I bundled the exporter with the money class since some tests depend on it and I figured
-that most applications which need to deal with Money also need to deal with proper 
-exporting. 
-
-== Download
-
-Preferred method of installation is gem: 
-
-  gem install --source http://dist.leetsoft.com money 
-
-Alternatively you can get the library packed
-  
-  http://dist.leetsoft.com/pkg/
-
-== Usage
-
-Use the compose_of helper to let active record deal with embedding the money
-object in your models. The following example requires a cents and a currency field.
-
-  class ProductUnit < ActiveRecord::Base
-    belongs_to :product
-    composed_of :price, :class_name => "Money", :mapping => [%w(cents cents) %(currency currency)]
-
-    private        
-      validate :cents_not_zero
-    
-      def cents_not_zero
-        errors.add("cents", "cannot be zero or less") unless cents > 0
-      end
-    
-      validates_presence_of :sku, :currency
-      validates_uniqueness_of :sku        
-  end
-  
-== Class configuration
-
-Two const class variables are available to tailor Money to your needs. 
-If you don't need currency exchange at all, just ignore those.
-
-=== Default Currency
-
-By default Money defaults to USD as its currency. This can be overwritten using
-
-  Money.default_currency = "CAD"
-  
-If you use rails, the environment.rb is a very good place to put this. 
-
-=== Currency Exchange
-
-The second parameter is a bit more complex. It lets you provide your own implementation of the 
-currency exchange service. By default Money throws an exception when trying to call .exchange_to. 
-
-A second minimalist implementation is provided which lets you supply custom exchange rates:
-
-  Money.bank = VariableExchangeBank.new 
-  Money.bank.add_rate("USD", "CAD", 1.24515)
-  Money.bank.add_rate("CAD", "USD", 0.803115)
-  Money.us_dollar(100).exchange_to("CAD") => Money.ca_dollar(124)
-  Money.ca_dollar(100).exchange_to("USD") => Money.us_dollar(80)
-
-There is nothing stopping you from creating bank objects which scrape www.xe.com for the current rates or just return rand(2)
-  
-== Code
-
-If you have any improvements please email them to tobi [at] leetsoft.com 

data/lib/bank/no_exchange_bank.rb

@@ -1,9 +0,0 @@
-class NoExchangeBank# :nodoc:
-
-  def reduce(money, currency)
-    return money if money.currency == currency
-    raise Money::MoneyError.new("Current Money::bank does not support money exchange. Please implement a bank object that does and assign it to the Money class.")
-  end
-  
-  
-end

data/lib/bank/variable_exchange_bank.rb

@@ -1,30 +0,0 @@
-# Example useage:
-#
-#  Money.bank = VariableExchangeBank.new
-#  Money.bank.add_rate("USD", "CAD", 1.24515)
-#  Money.bank.add_rate("CAD", "USD", 0.803115)
-#  Money.us_dollar(100).exchange_to("CAD") => Money.ca_dollar(124)
-#  Money.ca_dollar(100).exchange_to("USD") => Money.us_dollar(80)
-class VariableExchangeBank 
-   
-  def add_rate(from, to, rate)
-    rates["#{from}_TO_#{to}".upcase] = rate
-  end
-  
-  def get_rate(from, to)
-    rates["#{from}_TO_#{to}".upcase] 
-  end
-  
-  def reduce(money, currency)
-    rate = get_rate(money.currency, currency) or raise Money::MoneyError.new("Can't find required exchange rate")
-    
-    Money.new((money.cents * rate).floor, currency)
-  end
-  
-  private
-  
-  def rates
-    @rates ||= {} 
-  end
-  
-end

data/lib/support/cattr_accessor.rb

@@ -1,57 +0,0 @@
-# Extends the class object with class and instance accessors for class attributes, 
-# just like the native attr* accessors for instance attributes.
-class Class # :nodoc:
-  def cattr_reader(*syms)
-    syms.each do |sym|
-      class_eval <<-EOS
-        if ! defined? @@#{sym.id2name}
-          @@#{sym.id2name} = nil
-        end
-        
-        def self.#{sym.id2name}
-          @@#{sym}
-        end
-
-        def #{sym.id2name}
-          @@#{sym}
-        end
-
-        def call_#{sym.id2name}
-          case @@#{sym.id2name}
-            when Symbol then send(@@#{sym})
-            when Proc   then @@#{sym}.call(self)
-            when String then @@#{sym}
-            else nil
-          end
-        end
-      EOS
-    end
-  end
-  
-  def cattr_writer(*syms)
-    syms.each do |sym|
-      class_eval <<-EOS
-        if ! defined? @@#{sym.id2name}
-          @@#{sym.id2name} = nil
-        end
-        
-        def self.#{sym.id2name}=(obj)
-          @@#{sym.id2name} = obj
-        end
-
-        def self.set_#{sym.id2name}(obj)
-          @@#{sym.id2name} = obj
-        end
-
-        def #{sym.id2name}=(obj)
-          @@#{sym} = obj
-        end
-      EOS
-    end
-  end
-  
-  def cattr_accessor(*syms)
-    cattr_reader(*syms)
-    cattr_writer(*syms)
-  end
-end