rust-br-translator 0.2.0

Tradutor CLI português-inglês usando API LibreTranslate
rust-br-translator-0.2.0 is not a library.

🦀 Tradutor CLI - Rust

Uma ferramenta de linha de comando simples e rápida para traduzir palavras e frases do português para inglês usando a API LibreTranslate.

🚀 Como usar

# Palavra única
cargo run -- olá
# Output:
# Tradução: hi
# Alternativas: ["hello", "hey"]

# Frases (com aspas)
cargo run -- "como você está?"
# Output:
# Tradução: how are you?
# Alternativas: ["how are you doing?", "how do you do?"]

📦 Instalação

Via Cargo (Recomendado)

cargo install rust-br-translator
rust-br-translator olá mundo

Via Código Fonte

  1. Clone o projeto:
git clone https://github.com/gustavokurtz/rust-br-translator.git
cd rust-br-translator
  1. Instale dependências do sistema (Linux):
# Ubuntu/Debian
sudo apt install pkg-config libssl-dev

# Fedora/CentOS
sudo dnf install pkg-config openssl-devel
  1. Execute:
cargo run -- "palavra ou frase"

📋 Pré-requisitos

  • Rust instalado (https://rustup.rs/)
  • Conexão com internet (usa API online)
  • No Linux: pkg-config e libssl-dev instalados

🔧 Como funciona

  1. Input: Recebe palavra/frase em português como argumento
  2. API: Consulta LibreTranslate API (gustavodev.tech/translate)
  3. Output: Retorna tradução principal + alternativas
  4. Offline: Não funciona offline (requer internet)

🎯 Recursos

  • ✅ Tradução em tempo real via API
  • ✅ Múltiplas alternativas de tradução
  • ✅ Suporte a palavras e frases completas
  • ✅ API gratuita (sem necessidade de chave)
  • ✅ Mensagens de erro claras
  • ✅ Interface CLI simples
  • ✅ Assíncrono e rápido

📚 Exemplos

# Palavras simples
cargo run -- casa          # house
cargo run -- amarelo       # yellow
cargo run -- computador    # computer

# Frases (sempre usar aspas)
cargo run -- "bom dia"           # good morning
cargo run -- "como vai?"         # how are you?
cargo run -- "eu gosto de café"  # I like coffee

# Casos de erro
cargo run -- xywz123      # Erro de tradução ou palavra inexistente

🔄 Mudanças da v0.1.0 → v0.2.0

✅ Adicionado

  • Integração com API LibreTranslate
  • Suporte a frases completas
  • Múltiplas alternativas de tradução
  • Tradução online em tempo real
  • Tratamento de erros de rede

❌ Removido

  • HashMap interno (não era escalável)
  • Funcionamento offline
  • Dicionário limitado integrado

🔧 Melhorado

  • Qualidade das traduções (API vs dicionário fixo)
  • Cobertura de vocabulário (ilimitada)
  • Flexibilidade (palavras + frases)

🤝 Contribuindo

  1. Olhe as issues
  2. Faça um fork do projeto
  3. Crie sua feature branch (git checkout -b feature/nova-funcionalidade)
  4. Commit suas mudanças (git commit -m 'feat: adiciona nova funcionalidade')
  5. Push para a branch (git push origin feature/nova-funcionalidade)
  6. Abra um Pull Request

📄 Licença

Este projeto é open source e está disponível sob a MIT License.

🙏 Agradecimentos