i18n

README

I18n for Go

Install

go get -u github.com/fitv/go-i18n

Usage

YAML files

├── locales
│   ├── en.yml
│   ├── zh.yml
└── main.go

package main

import "github.com/fitv/go-i18n"

//go:embed locales/*.yml
var fs embed.FS

func main() {
    i18n, err := i18n.New(fs, "locales")
    i18n.SetDefaultLocale("en")

    i18n.Trans("hello.world") // World
    i18n.Locale("zh").Trans("hello.world") // 世界

    // with params
    user := map[string]interface{}{"name": "Jack", "email": "jack@example.com"}
    // foo %s
    i18n.Trans("hello.foo", "bar") // foo bar
    // Name: {name}, Email: {email}
    i18n.Trans("user.description", user) // Name: Jack, Email: jack@example.com
}

Documentation

Index

• type I18n
  • func New(fs embed.FS, path string) (*I18n, error)
  • func (i *I18n) Locale(locale string) *translator.Translator
  • func (i *I18n) SetDefaultLocale(local string)
  • func (i *I18n) Trans(key string, args ...interface{}) string

Types

type I18n

type I18n struct {
	// contains filtered or unexported fields
}

func New

func New(fs embed.FS, path string) (*I18n, error)

New returns an I18n instance

func (*I18n) Locale

func (i *I18n) Locale(locale string) *translator.Translator

Locale returns the translator instance by the given locale

func (*I18n) SetDefaultLocale

func (i *I18n) SetDefaultLocale(local string)

SetDefaultLocale set the default locale

func (*I18n) Trans

func (i *I18n) Trans(key string, args ...interface{}) string

Trans returns language translation by the given key