Module: ConcernsOnRails::Models::Monetizable

Extended by:

ActiveSupport::Concern

Defined in:

lib/concerns_on_rails/models/monetizable.rb

Overview

Money handling for an integer "subunit" column (e.g. cents) — exact, float-free, via BigDecimal.

Declaring monetizable :price_cents adds three methods derived from the column name (the _cents suffix is stripped):

* `price`            — the amount as a BigDecimal (cents / 100)
* `price=`           — assign in major units; rounded to whole cents
* `formatted_price`  — a display string ("$1,234.56")

class Product < ApplicationRecord
include ConcernsOnRails::Models::Monetizable

monetizable :price_cents                       # => price / price= / formatted_price
monetizable :shipping_cents, as: :shipping
monetizable :total_cents, unit: "€", separator: ",", delimiter: "."
end

product.price = 19.99   # stores price_cents = 1999
product.price           # => 0.1999e2  (BigDecimal 19.99)
product.formatted_price # => "$19.99"

Options: as: (explicit method name — required when the column does not end in _cents), unit: ("$"), precision: (2), delimiter: (","), separator: ("."), subunit_to_unit: (100).