Metadata-Version: 2.4
Name: initium-translation
Version: 0.1.1
Summary: Initium tool for PO files translation using Google Translator
Home-page: https://github.com/straconxsa/strx_tools/
Author: Initium Team
Author-email: Initium Team <info@initium.com>
License: LGPL-3
Project-URL: Homepage, https://github.com/straconxsa/strx_tools/
Project-URL: Bug Tracker, https://github.com/straconxsa/strx_tools/issues
Keywords: odoo,translation,po,initium
Classifier: Framework :: Odoo
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: polib
Requires-Dist: deep-translator
Dynamic: author
Dynamic: home-page

# Traductor PO

Script ejecutable para traducir archivos PO usando Google Translator.

## Instalación

El script `traductor-po` está disponible como comando ejecutable. Para usarlo globalmente, asegúrate de que `~/.local/bin` esté en tu PATH:

```bash
# Agregar al PATH (temporal)
export PATH=$PATH:~/.local/bin

# O agregar permanentemente a ~/.bashrc o ~/.zshrc
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
source ~/.bashrc
```

## Dependencias

Instala las dependencias necesarias:

```bash
pip3 install polib deep-translator
```

## Uso

```bash
# Traducir un archivo PO a español (por defecto)
traductor-po archivo.po

# Reemplazar el archivo original (in-place)
traductor-po archivo.po -i

# Especificar idioma de destino
traductor-po archivo.po -t es

# Especificar archivo de salida
traductor-po archivo.po -o archivo_traducido.po

# Sobrescribir traducciones existentes
traductor-po archivo.po -f

# Reemplazar archivo original y sobrescribir traducciones existentes
traductor-po archivo.po -i -f

# Modo verbose (mostrar detalles)
traductor-po archivo.po -v

# Especificar idioma de origen
traductor-po archivo.po -s en -t es
```

## Opciones

- `input_file`: Archivo PO de entrada (requerido)
- `-t, --target-language`: Código de idioma de destino (default: es)
- `-s, --source-language`: Código de idioma de origen (default: auto)
- `-o, --output-file`: Archivo PO de salida (default: archivo_translated.po)
- `-i, --in-place`: Reemplazar el archivo original en lugar de crear uno nuevo
- `-f, --force`: Sobrescribir traducciones existentes
- `-v, --verbose`: Mostrar información detallada de la traducción

**Nota**: No puedes usar `-i` y `-o` al mismo tiempo.

## Ejemplos

```bash
# Traducir a español (crea archivo nuevo)
traductor-po i18n/es.po

# Reemplazar el archivo original
traductor-po i18n/es.po -i

# Traducir a inglés desde español (crea archivo nuevo)
traductor-po i18n/es.po -s es -t en -o i18n/en.po

# Reemplazar archivo original y sobrescribir traducciones existentes
traductor-po i18n/es.po -i -f

# Traducir forzando sobrescritura con modo verbose
traductor-po i18n/es.po -f -v
```

## Características

- Preserva el contenido entre llaves `{}` durante la traducción
- Solo traduce entradas sin traducción existente (a menos que uses `-f`)
- Valida que el contenido entre llaves se preserve correctamente
- Maneja variaciones de espacios que Google Translator puede agregar
