libretranslate-aio 0.1.0

Cliente Python sync e async para a API do LibreTranslate (httpx)

libretranslate-aio

Cliente Python síncrono e assíncrono para a API do LibreTranslate, baseado em httpx.

Instalação

pip install libretranslate-aio

Uso rápido (sync)

from libretranslate_aio import LibreTranslate

with LibreTranslate() as client:
    result = client.translate("Hello world!", source="en", target="pt")
    print(result.translated_text)  # Olá mundo!

Uso rápido (async)

import asyncio
from libretranslate_aio import AsyncLibreTranslate


async def main():
    async with AsyncLibreTranslate() as client:
        result = await client.translate("Hello world!", source="en", target="pt")
        print(result.translated_text)


asyncio.run(main())

Configuração

LibreTranslate(
    base_url="https://libretranslate.com",  # ou sua instância self-hosted
    api_key="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",  # opcional
    timeout=30.0,
)

Variáveis de ambiente (usadas pela CLI):

• LIBRETRANSLATE_URL — URL base da API
• LIBRETRANSLATE_API_KEY — chave de API

API

Método	Descrição
translate(q, source, target, format="text", alternatives=0)	Traduz texto (str ou list[str])
translate_file(file, source, target)	Traduz um arquivo
detect(q)	Detecta o idioma do texto
languages()	Lista idiomas suportados
suggest(q, s, source, target)	Envia sugestão de tradução
frontend_settings()	Configurações do frontend
health()	Health check (True se ok)

CLI

# Traduzir
libretranslate translate "Hello world!" --source en --target pt

# Detectar idioma
libretranslate detect "Bonjour le monde"

# Listar idiomas
libretranslate languages

# Traduzir arquivo
libretranslate translate-file documento.txt --source en --target es -o saida.txt

# Opções globais
libretranslate --url https://minha-instancia.local --api-key KEY translate "Hi" -t pt

Desenvolvimento

uv sync --all-extras
uv run ruff check .
uv run pytest
uv build

Publicação no PyPI

1. Crie o repositório no GitHub e faça push.
2. No PyPI, configure Trusted Publishing apontando para o workflow publish.yml.
3. Crie uma release/tag vX.Y.Z — o GitHub Actions publica automaticamente.

Licença

MIT