lexigo

Documentation

Index

• func FromCtx(ctx context.Context) (language.Tag, bool)
• func LanguageMiddleware(matcher *Matcher) func(http.Handler) http.Handler
• func WithLanguage(ctx context.Context, lang language.Tag) context.Context
• func WithLanguageString(ctx context.Context, lang string) (context.Context, error)
• type Matcher
  • func NewMatcher(supported []language.Tag, opts ...language.MatchOption) *Matcher
  • func (m *Matcher) Match(lang language.Tag) language.Tag
  • func (m *Matcher) MatchAll(langs ...language.Tag) language.Tag

Functions

func FromCtx

func FromCtx(ctx context.Context) (language.Tag, bool)

FromCtx retrieves the language tag from the context

func LanguageMiddleware

func LanguageMiddleware(matcher *Matcher) func(http.Handler) http.Handler

LanguageMiddleware inserts the language.Tag into the request context according to "Accept-Language" header

Usage:

func main() {
	// Assuming the package name where the generated locales are is "i18n"
	mux := LanguageMiddleware(i18n.Matcher)(http.DefaultServeMux)
	//...
}

func WithLanguage

func WithLanguage(ctx context.Context, lang language.Tag) context.Context

WithLanguage injects the language.Tag into the context

If the provided value is not a valid language according to language.Parse, an empty value with be injected, in which case creating a locale with the ctx will result in the default tag being used.

func WithLanguageString

func WithLanguageString(ctx context.Context, lang string) (context.Context, error)

WithLanguageString injects the language.Tag corresponding to the given string into the context

Refer to WithLanguage for more info.

Types

type Matcher

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

func NewMatcher

func NewMatcher(supported []language.Tag, opts ...language.MatchOption) *Matcher

func (*Matcher) Match

func (m *Matcher) Match(lang language.Tag) language.Tag

func (*Matcher) MatchAll

func (m *Matcher) MatchAll(langs ...language.Tag) language.Tag