README.md

gocurrency

gocurrency is a minimalistic currency library for go.

Exchange rate sources

Current exchange rates are fetched from the european central bank. The base currency is euro. The exchange list will be updated every day by the ecb. It will be locally cached with a cache expire of 4 hours. Fetches are made automatically when you use the library.

Example

The library supports both, raw calculations and type-based usage.

//Money value to start with
money := 13.37

//Convert from euros to us dollars (USD)
money = ConvertEURTo("USD", money)

//Convert from us dollars (USD) to singapore dollars (SGD)
money = ConvertFromTo("USD", "SGD", money)

//Convert from singapore dollars (SGD) to euros (EUR)
money = ConvertToEUR("SGD", money)

//Check if the money is valid (valid means not 0 and not infinite)
println(IsNumberValid(money))

//Print the number formatted with 2 floating points
println(FormatNumber(money, 2))

Type based usage

//Money object to start with, requires the money value and the currency of the money
tmon := Money{Value: 13.37, Currency: "EUR"}

//Convert from euros to us dollars (USD)
tmon.To("USD")

//Convert from us dollars (USD) to singapore dollars (SGD)
tmon.To("SGD")

//Convert from singapore dollars (SGD) to euros (EUR)
tmon.ToEUR()

//Check if the money is valid (valid means not 0 and not infinite)
println(tmon.IsValid())

//Print the number formatted with 2 floating points
println(tmon.Format(2))

Info

This project is licensed under BSD 3-clause "New" or "Revised" license. Feel free to contribute.

Special thanks to @beevik for etree (xml library)