Contents

module Conversions
  # Implements new accessor classmethods to define conversion accessors on active record classes.
  module ActiveRecordAccessors
    # Adds conversion methods to the model for a certain attribute.
    #
    # Options:
    #
    # * <tt>:internal</tt>: The unit of the internal value
    # * <tt>:external</tt>: The unit of desired external value
    # * <tt>:scale</tt>: If a scale is given, the external value is automatically rounded on the specified scale.
    #
    #
    # Examples:
    #
    #  require 'conversions'
    #
    #  class Flight
    #    extend Conversions::ActiveRecordAccessors
    #
    #    attr_accessor :distance
    #    conversion_accessor :distance, :internal => :kilometers, :external => :miles, :scale => 2
    #
    #    def initialize(distance)
    #      self.distance = distance
    #    end
    #  end
    #
    #  flight = Flight.new(1200)
    #  flight.distance_in_miles #=> 745.65, rounded down to two decimals as specified in :scale
    #
    # When used as a plugin for Rails, the ActiveRecord::Base is automatically extended.
    #
    #  class Car < ActiveRecord::Base
    #    conversion_accessor :length, :internal => :kilometers, :external => :miles
    #  end
    def conversion_accessor(attribute, options={})
      if options[:internal].blank? or options[:external].blank?
        raise ArgumentError, "[conversions] Please specify both :external and :internal metrics."
      end
      define_method "#{attribute}_in_#{options[:external]}" do
        value = send(attribute)
        value ? value.convert(options[:internal], options[:external], options.except(:internal, :external)) : nil
      end
      define_method "#{attribute}_in_#{options[:external]}=" do |v|
        send("#{attribute}=", v.blank? ? nil : v.to_f.convert(options[:external], options[:internal], options.except(:internal, :external)))
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
conversions-1.4.6	lib/conversions/active_record_accessors.rb