mglang

README

MGLang

Uma biblioteca simples e leve em Go para gerenciamento de traduções (i18n), com suporte a detecção automática do idioma do sistema e formatação dinâmica de strings.

Ideal para aplicações desktop, CLI ou bibliotecas que precisam de internacionalização sem dependências pesadas.

---

✨ Recursos

• 🌍 Detecção automática do idioma do sistema
• 🗂️ Registro simples de traduções por chave
• 🔁 Fallback automático quando a tradução não existe
• 🧩 Suporte a para textos dinâmicos
• 🚀 API minimalista e fácil de integrar

---

📦 Instalação

go get github.com/mugomes/mglang

---

🚀 Uso básico

Definindo traduções

import "github.com/mugomes/mglang"

func main() {
	mglang.Set("hello", "Olá")
	mglang.Set("Welcome %s", "Bem-vindo, %s!")
}

---

Obtendo tradução simples

text := mglang.T("hello")
// Resultado: Olá

---

Tradução com parâmetros

text := mglang.T("Welcome %s", "Murilo")
// Resultado: Bem-vindo, Murilo!

---

Fallback automático

text := mglang.T("not_exists")
// Resultado: not_exists

---

🌐 Detecção de idioma

lang := mglang.GetLang()
fmt.Println(lang) // ex: pt, en, es

A função detecta o idioma do sistema operacional e retorna apenas o código base (pt, en, es, etc).

---

🧠 Estrutura interna

• Set(key, value) → registra tradução
• T(key, args...) → retorna texto traduzido
• GetLang() → detecta idioma do sistema

---

👤 Autor

Murilo Gomes Julio

🔗 https://mugomes.github.io

📺 https://youtube.com/@mugomesoficial

---

License

Copyright (c) 2025-2026 Murilo Gomes Julio

Licensed under the MIT license.

All contributions to the MGLang are subject to this license.

Documentation

Index

• func GetLang() string
• func Set(name string, value string)
• func T(key string, args ...any) string
• type Provider
• type Translations

Functions

func GetLang

func GetLang() string

Detecta o idioma do sistema e retorna apenas o código base (pt, en, es, etc.)

func Set

func Set(name string, value string)

func T

func T(key string, args ...any) string

T retorna o texto traduzido com formatação opcional.

Types

type Provider

type Provider interface {
	GetSystemLanguage() string
}

var Current Provider

type Translations

type Translations map[string]string