Popularity
5.7
Declining
Activity
0.0
Stable
46
2
18

Monthly Downloads: 3
Programming language: Elixir
License: MIT License
Tags: Text And Numbers    
Latest version: v0.5.1

monetized alternatives and similar packages

Based on the "Text and Numbers" category.
Alternatively, view monetized alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of monetized or a related project?

Add another 'Text and Numbers' Package

README

Monetized

Build Status Deps Status Inline docs

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

Enter Monetized. A library that aims to facilitate the handling of money through a safe way to store currency values and and providing abstractions to perform arithmetical operations on those values.

Monetized leverages Decimal's ability to safely handle arbitrary precision to perform calculations on money values.

A typical %Monetized.Money{} struct will contain a value in the shape of a Decimal struct and a currency (if any) as a string.

Requires elixir version 1.3.x or above as per ecto 2.x

Usage

Monetized also ships with a Ecto.Type that gives us an easier way to store money.


alias Monetized.Money

schema "transaction" do
  field :description, :string
  field :balance, Money, default: Money.zero

  timestamps
end

By doing this we're able to pass a %Money{} struct to the changeset and insert in the Repo since Ecto knows how to convert that struct into a primitive type to save and back when you read from it.


balance = Money.make("£ 100.50")
changeset = Transaction.changeset(%Transaction{}, %{description: "Invoice payment", balance: balance})

# Or

balance = %{value: "100.50", currency: "GBP"}
changeset = Transaction.changeset(%Transaction{}, %{description: "Invoice payment", balance: balance})

Check the docs for more.

Other usage

alias Monetized.Money
alias Monetized.Math

# Create with a string
iex> item_one = Money.make("£ 200.50")
#Money<200.50GBP>

# Or a float
iex> item_two = Money.make(10.25, [currency: "GBP"])
#Money<10.25GBP>

# Adding two moneys together
iex> Math.add(item_one, item_two)
#Money<210.75GBP>

# Or an integer
iex> balance = Money.make(100_000, [currency: "USD"])
#Money<100000.00USD>

# Substracting from money (currency inferred from balance)
iex> result = Math.sub(balance, 50_000)
#Money<50000.00USD>

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

# You can also use `from_integer/2`, `from_float/2`, `from_decimal/2` and `from_string/2`
# respectively if the desired behavior is to raise when the amount is 
# not of the expected type.

# If either the symbol or the currency key is found within the string,
# that currency will be used. However, if a different currency is given in the
# options, it will take precedence.

iex> Money.from_string("£ 200")
#Money<200.00GBP>

iex> Money.from_string("200 EUR")
#Money<200.00EUR>

iex> Money.from_integer(200)
#Money<200.00>

iex> Money.from_float(200.50)
#Money<200.50>

iex> decimal = Decimal.new(10.25)
...> Money.from_decimal(decimal, currency: "EUR")
#Money<10.15EUR>

iex> Money.from_integer("10")
** (FunctionClauseError) no function clause matching in Monetized.Money.from_integer/2
    (monetized) lib/money.ex:204: Monetized.Money.from_integer("10", [])

Check the docs for more examples

Config

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

Installation

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

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

TODO

  • [ ] New currencies can be added through the package's config
  • [ ] 1.0.0 ! yay!

Benchmarking

$ mix deps.get
$ MIX_ENV=bench mix compile
$ MIX_ENV=bench mix bench

Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

Licensing

See [LICENSE.md](LICENSE.md)


*Note that all licence references and agreements mentioned in the monetized README section above are relevant to that project's source code only.