blulang

README

BluLang

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/bluiceoficial/blulang

---

🚀 Uso básico

Definindo traduções

import "github.com/bluiceoficial/blulang"

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

---

Obtendo tradução simples

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

---

Tradução com parâmetros

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

---

Fallback automático

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

---

🌐 Detecção de idioma

lang := blulang.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://www.bluice.com.br

📺 https://youtube.com/@bluiceoficial

---

License

Copyright (c) 2026 Murilo Gomes Julio

Licensed under the MIT license.

All contributions to the BluLang 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