Monetized

As a general rule, using floats to store money is a bad idea.

Integers on the other hand are great.

However, in order for it to be an actual viable option we must first lay some groundwork and this is why Monetized library exists.

Usage

alias Monetized.Money
alias Monetized.Math

# Create with a string
item_one = Money.make("200.50", [currency: "GBP"])
item_one == %Monetized.Money{currency: "GBP", units: 20050}

# Or a float
item_two = Money.make(10.25)

# Adding two moneys together
Math.add(item_one, item_two) == %Monetized.Money{currency: "USD", units: 21075}

# Or an integer
balance = Money.make(100_000_00, [units: true])

# Substracting from money
result = Math.sub(balance, 50_000)
result == %Monetized.Money{currency: "USD", units: 5000000}

# Getting the string representation
Money.to_string(result, [show_currency: true]) == "$ 50,000.00"

Check the docs for more examples

Note

Although you can give Money.make/1 a float to create a money struct, serves only as a convenience utility and none of the internal operactions are done on floats but rather on the basic fractional units (integers).

Config

config :monetized, config: [
  delimiter: ",",
  separator: ".",
  currency: "USD",
  format: "%c %n%s%d"
]

Installation

Add monetized to your list of dependencies in mix.exs:

def deps do
  [{:monetized, "~> 0.1.0"}]
end

Contributing

See CONTRIBUTING.md for details.

Licensing

See LICENSE.md