mrlang

Documentation

Index

• func ParseAcceptLanguage(s string) []string
• func WithContext(ctx context.Context, locale *Locale) context.Context
• type Dictionary
  • func (d *Dictionary) ItemByID(id int) DictionaryItemAttrs
  • func (d *Dictionary) ItemByKey(key string) DictionaryItemAttrs
  • func (d *Dictionary) RegisteredItems() []string
• type DictionaryItemAttrs
  • func (a DictionaryItemAttrs) Attr(name, defaultText string) string
  • func (a DictionaryItemAttrs) RegisteredAttrs() []string
• type DictionaryMap
• type Locale
  • func Ctx(ctx context.Context) *Locale
  • func (l *Locale) HasErrorCode(code string) bool
  • func (l *Locale) LangCode() string
  • func (l *Locale) LangID() uint16
  • func (l *Locale) TranslateError(code, defaultMessage string, args ...mrmsg.NamedArg) mrmsg.ErrorMessage
  • func (l *Locale) TranslateMessage(code, defaultMessage string, args ...mrmsg.NamedArg) string
  • func (l *Locale) WithContext(ctx context.Context) context.Context
• type MultiLangDictionary
  • func (d *MultiLangDictionary) ByLangCode(code string) (*Dictionary, error)
  • func (d *MultiLangDictionary) ByLangID(id uint16) (*Dictionary, error)
  • func (d *MultiLangDictionary) Name() string
  • func (d *MultiLangDictionary) RegisteredLangs() []string
• type Translator
  • func NewTranslator(opts TranslatorOptions) (*Translator, error)
  • func (t *Translator) DefaultLocale() *Locale
  • func (t *Translator) Dictionary(name string) (*MultiLangDictionary, error)
  • func (t *Translator) FindFirstLocale(langs ...string) *Locale
  • func (t *Translator) LocaleByCode(lang string) (*Locale, error)
  • func (t *Translator) LocaleByID(langID uint16) (*Locale, error)
  • func (t *Translator) RegisteredDictionaries() []string
  • func (t *Translator) RegisteredLocales() []string
• type TranslatorOptions

Functions

func ParseAcceptLanguage

func ParseAcceptLanguage(s string) []string

ParseAcceptLanguage Sample Accept-Language: ru;q=0.9, fr-CH, fr;q=0.8, en;q=0.7, *;q=0.5

func WithContext

func WithContext(ctx context.Context, locale *Locale) context.Context

Types

type Dictionary

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

func (*Dictionary) ItemByID

func (d *Dictionary) ItemByID(id int) DictionaryItemAttrs

func (*Dictionary) ItemByKey

func (d *Dictionary) ItemByKey(key string) DictionaryItemAttrs

func (*Dictionary) RegisteredItems

func (d *Dictionary) RegisteredItems() []string

type DictionaryItemAttrs

type DictionaryItemAttrs map[string]string

func (DictionaryItemAttrs) Attr

func (a DictionaryItemAttrs) Attr(name, defaultText string) string

func (DictionaryItemAttrs) RegisteredAttrs

func (a DictionaryItemAttrs) RegisteredAttrs() []string

type DictionaryMap

type DictionaryMap map[string]DictionaryItemAttrs // dictionary-name -> [id -> [attr1 -> text1, attr2 -> text2, ...], ...]

type Locale

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

func Ctx

func Ctx(ctx context.Context) *Locale

func (*Locale) HasErrorCode

func (l *Locale) HasErrorCode(code string) bool

func (*Locale) LangCode

func (l *Locale) LangCode() string

func (*Locale) LangID

func (l *Locale) LangID() uint16

func (*Locale) TranslateError

func (l *Locale) TranslateError(code, defaultMessage string, args ...mrmsg.NamedArg) mrmsg.ErrorMessage

func (*Locale) TranslateMessage

func (l *Locale) TranslateMessage(code, defaultMessage string, args ...mrmsg.NamedArg) string

func (*Locale) WithContext

func (l *Locale) WithContext(ctx context.Context) context.Context

type MultiLangDictionary

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

func (*MultiLangDictionary) ByLangCode

func (d *MultiLangDictionary) ByLangCode(code string) (*Dictionary, error)

func (*MultiLangDictionary) ByLangID

func (d *MultiLangDictionary) ByLangID(id uint16) (*Dictionary, error)

func (*MultiLangDictionary) Name

func (d *MultiLangDictionary) Name() string

func (*MultiLangDictionary) RegisteredLangs

func (d *MultiLangDictionary) RegisteredLangs() []string

type Translator

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

func NewTranslator

func NewTranslator(opts TranslatorOptions) (*Translator, error)

func (*Translator) DefaultLocale

func (t *Translator) DefaultLocale() *Locale

func (*Translator) Dictionary

func (t *Translator) Dictionary(name string) (*MultiLangDictionary, error)

func (*Translator) FindFirstLocale

func (t *Translator) FindFirstLocale(langs ...string) *Locale

FindFirstLocale - if not exists get default locale

func (*Translator) LocaleByCode

func (t *Translator) LocaleByCode(lang string) (*Locale, error)

func (*Translator) LocaleByID

func (t *Translator) LocaleByID(langID uint16) (*Locale, error)

func (*Translator) RegisteredDictionaries

func (t *Translator) RegisteredDictionaries() []string

func (*Translator) RegisteredLocales

func (t *Translator) RegisteredLocales() []string

type TranslatorOptions

type TranslatorOptions struct {
	DirPath           string
	LangCodes         []string
	DefaultLang       string // optional
	DictionaryDirPath string
	Dictionaries      []string // optional
}