hissssst / better_number

Convert numbers to various string formats, such as currency

Better Number

BetterNumber is an Elixir library which provides functions to convert numbers into a variety of different formats. It is a fork of Daniel Berkompas's Number but it

1. Has slightly more features

2. Does not perform any configuration lookups and therefore each function is 100% pure.

3. Has no __using__ to import functions

4. Has correct type specifications

5. Actively maintained

Example

alias BetterNumber, as: Number

Number.Currency.number_to_currency(2034.46)
"$2,034.46"

Number.Phone.number_to_phone[phone], area_code: true, country_code: 1)
"[phone]"

Number.Percentage.number_to_percentage(100, precision: 0)
"100%"

Number.Human.number_to_human(1234)
"1.23 Thousand"

Number.Delimit.number_to_delimited(12345678)
"12,345,678"

Installation

Get it from Hex:

defp deps do
  [
    {:better_number, "~> 1.0.0"}
  ]
end

Then run mix deps.get.

Usage

defmodule MyModule do
  alias BetterNumber, as: Number
end

See the Hex documentation for more information about the modules provided by Number.

License

MIT. See LICENSE for more details.