collectiveidea-money 1.7.3 → 1.7.4

data/README

@@ -1,46 +1,55 @@
-== Money class
+== Money
 
-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. 
+This library makes it easier to deal with Money values, storing them as integers to avoid floating-point math errors.
 
 == Download
 
 Preferred method of installation is gem: 
 
-  gem install --source http://dist.leetsoft.com money 
+  gem install --source http://gems.github.com collectiveidea-money 
 
-Alternatively you can get the library packed
+You can find the source at:
   
-  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        
+  http://github.com/collectiveidea/money
+
+== Rails
+
+There is a rails extension that makes it easier to store money values in the database.
+
+  class Product < ActiveRecord::Base
+    money :price
+    validates_numericality_of :price_in_cents, :greater_than => 0
+  end
+
+This assumes that there is a price_in_cents (integer) column in the database, which can
+be changed by passing the :cents option.  You can also specify the :currency option to
+save the currency to a field in the database.
+
+  class Room < ActiveRecord::Base
+    money :rate, :cents => :rate_cents, :currency => :rate_currency
+    money :discount, :cents => :discount_cents
   end
+
+You can set the attribute to a String, Fixnum, or Float and it will call #to_money to
+convert it to a Money object.  This makes it convenient for using money fields in forms.
+
+  r = Room.new :rate => "100.00"
+  r.rate  # returns <Money:0x249ef9c @currency="USD", @cents=10000>
+
+By default, money values will be stored with a precision of 2 (cents). If you need to store different precisions, such as to the nearest tenth of a cent, you can specify the +:precision+ option:
+
+  class Room < ActiveRecord::Base
+    money :rate, :precision => 3
+  end
+
+  r = Room.new :rate => "100"
+  r.rate.format  # returns $100.000
+  r.rate = "100.995"
+  r.rate.format  # returns $100.995
+
+To use the Rails functionality, install money as a plugin, or require 'money/rails'.
+This version is compatible with Rails 2.2.  For compatibility with previous versions of
+Rails, check out the rails-2.1 branch.
   
 == Class configuration
 

data/lib/money/rails.rb

@@ -9,21 +9,21 @@ module ActiveRecord #:nodoc:
 
       module ClassMethods
         
-        def default_currency
-          'USD'
-        end
-        
         def money(name, options = {})
-          options = {:cents => "#{name}_in_cents".to_sym, :currency => default_currency}.merge(options)
-          mapping = [[options[:cents].to_s, 'cents']]
+          options = {:precision => 2, :cents => "#{name}_in_cents".to_sym}.merge(options)
+          mapping = [[options[:cents], 'cents']]
           mapping << [options[:currency].to_s, 'currency'] if options[:currency]
-          
-          composed_of name, :class_name => 'Money', :allow_nil => true, :mapping => mapping,
-            :converter => lambda {|m| m.to_money }
+          composed_of name, :class_name => 'Money', :mapping => mapping, :allow_nil => true,
+            :converter => lambda{ |m| m.to_money(options[:precision]) }
+
+          define_method "#{name}_with_cleanup=" do |amount|
+            send "#{name}_without_cleanup=", amount.blank? ? nil : amount.to_money(options[:precision])
+          end
+          alias_method_chain "#{name}=", :cleanup
         end
       end
     end
   end
 end
 
-ActiveRecord::Base.send :include, ActiveRecord::Acts::Money
+ActiveRecord::Base.send :include, ActiveRecord::Acts::Money

data/lib/money.rb

@@ -207,7 +207,7 @@ class Money
   end  
 
   # Conversation to self
-  def to_money
-    self
+  def to_money(precision = nil)
+    precision ? to_precision(precision) : self
   end  
 end

data/lib/support/cattr_accessor.rb

@@ -26,7 +26,7 @@ class Class # :nodoc:
         end
       EOS
     end
-  end
+  end unless instance_methods.include?('cattr_reader')
   
   def cattr_writer(*syms)
     syms.each do |sym|
@@ -48,10 +48,10 @@ class Class # :nodoc:
         end
       EOS
     end
-  end
+  end  unless instance_methods.include?('cattr_writer')
   
   def cattr_accessor(*syms)
     cattr_reader(*syms)
     cattr_writer(*syms)
-  end
+  end unless instance_methods.include?('cattr_accessor')
 end

metadata

@@ -1,20 +1,21 @@
 --- !ruby/object:Gem::Specification 
 name: collectiveidea-money
 version: !ruby/object:Gem::Version 
-  version: 1.7.3
+  version: 1.7.4
 platform: ruby
 authors: 
+- Brandon Keepers
 - Tobias Luetke
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-10-27 00:00:00 -07:00
+date: 2009-01-11 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
 description: Class aiding in the handling of Money and Currencies. It supports easy pluggable bank objects for customized exchange strategies. Can be used as composite in ActiveRecord tables.
-email: tobi@leetsoft.com
+email: brandon@opensoul.org
 executables: []
 
 extensions: []
@@ -31,7 +32,7 @@ files:
 - lib/money/rails.rb
 - lib/support/cattr_accessor.rb
 has_rdoc: true
-homepage: http://leetsoft.com/rails/money
+homepage: http://github.com/collectiveidea/money
 post_install_message: 
 rdoc_options: []