Localizer: convenient localization for Go
Localizer intends to make it easy for you to work with locales in Go. It was inspired by many good tools that came before it, such as:
I couldn't find one Go package that did everything, so I took the best of what was out there, made some improvements & tweaks, and put them together into localizer. I also wanted to leverage golang.org/x/text/language as much as possible, since it takes care of some difficult tasks.
Getting Started: Example
import (
"fmt"
"time"
"github.com/razor-1/cldr/resources/currency"
"golang.org/x/text/language"
"github.com/razor-1/localizer"
)
func main() {
l, err := localizer.NewLocale(language.Spanish)
if err != nil {
panic(err)
}
jan2020 := time.Date(2020, 1, 1, 0, 0, 0, 0, time.UTC)
month, err := l.Calendar.Format(jan2020, "MMMM")
if err != nil {
panic(err)
}
fmt.Println(month) // "enero"
fmt.Println(l.Calendar.FormatNames.Months.Wide.Jan) // "enero"
fmt.Println(l.FmtNumber(10000.12)) // "10.000,12"
cur, err := l.FmtCurrency(currency.USD, 10000.12)
if err != nil {
panic(err)
}
fmt.Println(cur) // "10.000,12 US$"
}
As you can see, the locale object makes it easy to interact with CLDR data. What about translated strings?
gotl := gotext.NewLocale("translations", "es")
gotl.AddDomain("messages")
gtstore := gotextstore.GetTranslationStore(gotl)
l, err := localizer.NewLocaleWithStore(language.Spanish, gtstore)
if err != nil {
panic(err)
}
fmt.Println(l.Get("form.button.login")) //"Iniciar sesión"
fmt.Println(l.GetPlural("%d hours", 1, 1)) //"1 hora"
fmt.Println(l.GetPlural("%d hours", 2, 2)) //"2 horas"
You can use any package which implements the localizer/store.TranslationStore interface to load translations. The above example uses a helper package, localizer/gotextstore, which integrates with gotext to provide gettext po/mo support for localizer. If other packages implement this interface, support for xliff, xmb, and other common formats can be added. You can also easily implement it for your own custom store.
localizer also exposes a message printer if you'd like to use it. Just call l.NewPrinter() and you can then call Printf() and other methods on it.
49 Nov 29, 2022
3.9k Dec 24, 2022
52 Nov 9, 2022
4 Dec 14, 2022
54 Jan 7, 2023
260 Dec 16, 2022
3.5k Dec 29, 2022
289 Dec 20, 2022
9 May 14, 2021
91 Dec 30, 2022
5k Jan 6, 2023
19 Jun 2, 2022
3 Nov 15, 2022
1 Nov 1, 2021
1 Dec 27, 2021
1 Nov 28, 2021
0 Dec 29, 2021
0 Jan 1, 2022
0 Jan 31, 2022
0 Feb 5, 2022