python gpt po

Traductor de archivos PO de Python GPT-4

Este script de Python proporciona una herramienta sólida y flexible para traducir archivos .po utilizando el modelo GPT-4 de OpenAI. Admite varios modos de traducción, maneja entradas difusas e integra procesamiento por lotes para proyectos más grandes, lo que lo hace adecuado para diversas estructuras y tamaños de archivos .po .

Características

• Modos de traducción masiva e individual : permite una traducción masiva eficiente o traducciones precisas, entrada por entrada, para contenido matizado.
• Opción de idioma detallado ( --detail-lang ) : admite el uso de nombres de idiomas completos (p. ej., "Países Bajos, alemán") junto con códigos cortos (p. ej., nl, de ), lo que garantiza claridad en las indicaciones de traducción.
• Tamaño de lote configurable : establezca la cantidad de entradas para traducir por lote durante la traducción masiva, optimizando el uso de API.
• Gestión de entradas difusas : elimina automáticamente indicadores y entradas difusas, lo que garantiza que solo se procesen traducciones válidas.
• Inferencia de idioma a partir de la estructura de carpetas : infiere el idioma de destino a partir de la estructura de carpetas, lo que reduce la necesidad de especificaciones de idioma explícitas.
• Validación de traducción y lógica de reintento : los mecanismos integrados validan las traducciones y reintentan automáticamente para evitar traducciones incorrectas o detalladas.
• Registro para mayor transparencia : registro detallado para monitorear, depurar y garantizar el progreso durante todo el proceso de traducción.
• Gestión de claves de API de OpenAI : admite variables de entorno o argumentos de línea de comandos para proporcionar de forma segura credenciales de API de OpenAI.
• Mecanismo de reintento para traducciones fallidas : reintenta las traducciones fallidas hasta tres veces, lo que reduce los resultados incompletos o incorrectos.
• Postprocesamiento para traducciones concisas : revisa automáticamente las traducciones para garantizar que sean concisas y estén libres de explicaciones o repeticiones innecesarias.

Requisitos

• Pitón 3.x
• biblioteca polib (para manejo de archivos .po )
• Paquete openai Python (para integración con modelos OpenAI GPT)
• biblioteca tenacity (para mecanismos de reintento)
• python-dotenv (para gestionar variables de entorno)

Instalación

Vía PyPI

Instale el paquete gpt-po-translator directamente desde PyPI:

pip install gpt-po-translator

Instalación manual

Para instalación manual o trabajar con el código más reciente del repositorio:

1. Clonar el repositorio:

   git clone [repository URL]

2. Navegue hasta el directorio clonado e instale el paquete:

   pip install . 

Configuración de clave API

gpt-po-translator admite dos métodos para proporcionar credenciales de API OpenAI:

1. Variable de entorno : configure su clave API de OpenAI como una variable de entorno denominada OPENAI_API_KEY . Este método se recomienda por razones de seguridad y facilidad de administración de claves API.

    export OPENAI_API_KEY= ' your_api_key_here '

2. Argumento de línea de comandos : pase la clave API como argumento de línea de comandos usando la opción --api_key .

   gpt-po-translator --folder ./locales --lang de,fr --api_key ' your_api_key_here ' --bulk --bulksize 100 --folder-language

Asegúrese de que su clave API esté almacenada de forma segura y no expuesta en espacios o repositorios públicos.

Uso

Utilice gpt-po-translator como herramienta de línea de comandos para traducir archivos .po :

gpt-po-translator --folder [path_to_po_files] --lang [language_codes] [--api_key [your_openai_api_key]] [--fuzzy] [--bulk] [--bulksize [batch_size]] [--folder-language] [--detail-lang [full_language_names]]

Ejemplo

gpt-po-translator --folder ./locales --lang de,fr --api_key ' your_api_key_here ' --bulk --bulksize 40 --folder-language --detail-lang " German,French "

Este comando traduce archivos .po en la carpeta ./locales al alemán y francés, utilizando la clave API de OpenAI proporcionada y procesando 40 traducciones por lote en modo masivo. También infiere el idioma de la estructura de carpetas.

Opciones de línea de comandos

• --folder : especifica la carpeta de entrada que contiene los archivos .po .
• --lang : códigos de idioma separados por comas para filtrar archivos .po (por ejemplo, de,fr ).
• --detail-lang : Argumento opcional para nombres completos de idiomas, que coinciden con el orden de --lang (por ejemplo, "alemán, francés").
• --fuzzy : elimina las entradas difusas antes del procesamiento.
• --bulk : habilita el modo de traducción masiva para un procesamiento más rápido.
• --bulksize : establece el tamaño del lote para la traducción masiva (el valor predeterminado es 50).
• --model : especifica el modelo OpenAI que se utilizará para las traducciones (el valor predeterminado es gpt-3.5-turbo-0125 ).
• --api_key : clave API de OpenAI. Se puede proporcionar a través de la línea de comando o como una variable de entorno.
• --folder-language : Infiere el idioma de destino a partir de la estructura de carpetas.

Nombres de idiomas detallados y códigos cortos

La opción --detail-lang complementa --lang permitiéndole especificar nombres completos de idiomas (por ejemplo, Netherlands,German ) en lugar de códigos cortos de idioma. Luego, los nombres completos se utilizan en el contexto de las indicaciones de OpenAI, lo que mejora la claridad del modelo GPT.

Uso de ejemplo:

gpt-po-translator --folder ./locales --lang nl,de --detail-lang " Netherlands,German " 

Explotación florestal

El script registra información detallada sobre los archivos que se procesan, la cantidad de traducciones y detalles del lote en modo masivo. Los registros son esenciales para monitorear el progreso, depurar problemas y garantizar la transparencia durante todo el proceso de traducción.

Manejo de errores y reintentos

El script incluye un sólido manejo de errores y reintentos para garantizar una traducción confiable:

• Traducciones fallidas : reintenta automáticamente las traducciones fallidas hasta tres veces.
• Traducciones vacías : si se devuelve una traducción vacía, el script intentará traducir el texto nuevamente utilizando un enfoque alternativo.
• Traducciones largas o incorrectas : las traducciones que son demasiado largas o que contienen explicaciones en lugar de traducciones directas se marcan y se vuelven a intentar.

Licencia

Este proyecto está bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.