NewLocalizer function

NewLocalizer creates a new localizer for the application, the localizer is

used to localize strings in the application. The localizer requires the

application and the locale to be passed in, the locale is the language

the user wants to use. If the locale is not found or is empty, the

localizer will default to English, assuming it as the fallback.

Example:

t, err := i18n.NewLocalizer(app, "")
if err != nil {
	fmt.Printf("Error: %v\n", err)
	return
}
fmt.Println(t.Get("I am Batman!"))

Parameters:

  • localeFS embed.FS
  • defaultDomain string
  • locale string

Returns:

  • *spreak.Localizer
  • error
Show/Hide Function Body 
{
	foundLocale, err := language.Parse(locale)
	if err != nil {
		foundLocale = language.English
	}

	// we need to get the supported languages from the locales file system
	// to do so we expect a LINGUAS file to be present
	linguas, err := localeFS.ReadFile("locales/LINGUAS")
	if err != nil {
		return nil, fmt.Errorf("no LINGUAS file found: %v", err)
	}

	// spreak.WithLanguage requires a slice of interfaces
	supportedLanguages := make([]interface{}, 0)
	for _, l := range strings.Split(string(linguas), "\n") {
		if l == "" {
			continue
		}
		supportedLanguages = append(supportedLanguages, language.MustParse(l))
	}

	// we need to create a new bundle for the localizer, here we use the RDNN
	// as the default localizer domain
	bundle, err := spreak.NewBundle(
		spreak.WithSourceLanguage(language.English),
		spreak.WithDefaultDomain(defaultDomain),
		spreak.WithDomainFs(defaultDomain, localeFS),
		spreak.WithRequiredLanguage(foundLocale),
		spreak.WithLanguage(supportedLanguages...),
	)
	if err != nil {
		return nil, err
	}

	return spreak.NewLocalizer(bundle, foundLocale), nil
}

embed import

Import example:

import "embed"

fmt import

Import example:

import "fmt"

strings import

Import example:

import "strings"

github.com/vorlif/spreak import

Import example:

import "github.com/vorlif/spreak"

golang.org/x/text/language import

Import example:

import "golang.org/x/text/language"