README.md

sejong

simple translate library like ruby's i18n module

Example

Suppose you need some greetings messages in English and Korean respectively.

You can write en-GB.yml

# en-GB.yml
en-GB:
  message:
    welcome: "Hello, %{nickname}!"
    farewell: "It's %{time} o'clock. Good bye, %{nickname}!"

and ko.yml.

# ko.yml
ko:
  message:
    welcome: "안녕, %{nickname}!"
    farewell: "%{time}시 입니다. 잘가요, %{nickname}!"

then you can use sejong.T for translate.

package main

import (
	"fmt"
	"strconv"
	"time"

	"github.com/zzerjae/sejong"
)

func main() {
	sejong.Locale = "en-GB"

	message, err := sejong.T("message.welcome", "nickname", "John")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(message) // Hello, John!

	message, err = sejong.T("message.farewell", "nickname", "John", "time", strconv.Itoa(time.Now().Hour()))
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(message) // It's 5 o'clock. Good bye, John!

	sejong.Locale = "ko"

	message, err = sejong.T("message.welcome", "nickname", "길동")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(message) // 안녕, 길동!
}

Configuration

Location of locale files

Default location is the directory of main.go, but you can set the env SEJONG_LOCALE_DIRECTORY for yours.

Working with multiple locales

You can also create many different translators for use in your application. Each will have its own unique locale source.

Example:

package main

import (
	"fmt"

	"github.com/zzerjae/sejong"
)

func main() {
	ko, err := sejong.New("ko")
	if err != nil {
		fmt.Println(err)
		return
	}
	gb, err := sejong.New("en-GB")
	if err != nil {
		fmt.Println(err)
		return
	}

	message, err := ko.T("message.welcome", "nickname", "길동")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(message) // 안녕, 길동!

	message, err = gb.T("message.welcome", "nickname", "John")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(message) // Hello, John!
}

QNA

Why is it called "sejong"?

https://en.wikipedia.org/wiki/Sejong_the_Great

Author

@zzerjae

License

MIT