python gpt po

Tradutor de arquivos PO Python GPT-4

Este script Python fornece uma ferramenta robusta e flexível para traduzir arquivos .po usando o modelo GPT-4 da OpenAI. Ele acomoda vários modos de tradução, lida com entradas difusas e integra processamento em lote para projetos maiores, tornando-o adequado para diversas estruturas e tamanhos de arquivos .po .

Características

• Modos de tradução em massa e individual : permite tradução em massa eficiente ou traduções precisas, entrada por entrada, para conteúdo diferenciado.
• Opção detalhada de idioma ( --detail-lang ) : Suporta o uso de nomes completos de idiomas (por exemplo, "Holanda, Alemão") junto com códigos de acesso (por exemplo, nl, de ), garantindo clareza nas instruções de tradução.
• Tamanho de lote configurável : defina o número de entradas a serem traduzidas por lote durante a tradução em massa, otimizando o uso da API.
• Gerenciamento de entradas difusas : remove automaticamente sinalizadores e entradas difusas, garantindo que apenas traduções válidas sejam processadas.
• Inferência de idioma a partir da estrutura de pastas : infere o idioma de destino a partir da estrutura de pastas, reduzindo a necessidade de especificações explícitas de idioma.
• Validação de tradução e lógica de repetição : mecanismos integrados validam as traduções e tentam novamente automaticamente para evitar traduções incorretas ou detalhadas.
• Registro para transparência : registro detalhado para monitoramento, depuração e garantia do progresso durante todo o processo de tradução.
• Gerenciamento de chaves de API OpenAI : oferece suporte a variáveis ​​de ambiente ou argumentos de linha de comando para fornecer credenciais de API OpenAI com segurança.
• Mecanismo de nova tentativa para traduções com falha : tenta novamente traduções com falha até três vezes, reduzindo resultados incompletos ou incorretos.
• Pós-processamento para traduções concisas : revisa automaticamente as traduções para garantir que sejam concisas e livres de explicações ou repetições desnecessárias.

Requisitos

• Python 3.x
• biblioteca polib (para manipulação de arquivos .po )
• pacote openai Python (para integração com modelos OpenAI GPT)
• biblioteca tenacity (para mecanismos de nova tentativa)
• python-dotenv (para gerenciar variáveis ​​de ambiente)

Instalação

Através do PyPI

Instale o pacote gpt-po-translator diretamente do PyPI:

pip install gpt-po-translator

Instalação manual

Para instalação manual ou trabalho com o código mais recente do repositório:

1. Clone o repositório:

   git clone [repository URL]

2. Navegue até o diretório clonado e instale o pacote:

   pip install . 

Configuração de chave de API

O gpt-po-translator oferece suporte a dois métodos para fornecer credenciais da API OpenAI:

1. Variável de ambiente : defina sua chave de API OpenAI como uma variável de ambiente chamada OPENAI_API_KEY . Este método é recomendado para segurança e facilidade de gerenciamento de chaves de API.

    export OPENAI_API_KEY= ' your_api_key_here '

2. Argumento de linha de comando : passe a chave API como um argumento de linha de comando usando a opção --api_key .

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

Certifique-se de que sua chave de API esteja armazenada com segurança e não seja exposta em espaços públicos ou repositórios.

Uso

Use gpt-po-translator como uma ferramenta de linha de comando para traduzir arquivos .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]]

Exemplo

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 traduz arquivos .po na pasta ./locales para alemão e francês, usando a chave de API OpenAI fornecida e processando 40 traduções por lote no modo em massa. Também infere o idioma da estrutura de pastas.

Opções de linha de comando

• --folder : especifica a pasta de entrada que contém os arquivos .po .
• --lang : Códigos de idioma separados por vírgula para filtrar arquivos .po (por exemplo, de,fr ).
• --detail-lang : Argumento opcional para nomes completos de idiomas, correspondendo à ordem de --lang (por exemplo, "Alemão,Francês").
• --fuzzy : Remove entradas difusas antes do processamento.
• --bulk : ativa o modo de tradução em massa para processamento mais rápido.
• --bulksize : Define o tamanho do lote para tradução em massa (o padrão é 50).
• --model : especifica o modelo OpenAI a ser usado para traduções (o padrão é gpt-3.5-turbo-0125 ).
• --api_key : chave da API OpenAI. Pode ser fornecido por meio da linha de comando ou como uma variável de ambiente.
• --folder-language : infere o idioma de destino da estrutura de pastas.

Nomes detalhados de idiomas e códigos de acesso

A opção --detail-lang complementa --lang permitindo que você especifique nomes completos de idiomas (por exemplo, Netherlands,German ) em vez de códigos de acesso de idiomas. Os nomes completos são então usados ​​no contexto dos prompts do OpenAI, melhorando a clareza do modelo GPT.

Exemplo de uso:

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

Registro

O script registra informações detalhadas sobre os arquivos que estão sendo processados, o número de traduções e detalhes do lote no modo em massa. Os logs são essenciais para monitorar o progresso, depurar problemas e garantir transparência em todo o processo de tradução.

Tratamento de erros e novas tentativas

O script inclui tratamento robusto de erros e novas tentativas para garantir uma tradução confiável:

• Traduções com falha : repete automaticamente as traduções com falha até três vezes.
• Traduções Vazias : Se uma tradução vazia for retornada, o script tentará traduzir o texto novamente usando uma abordagem alternativa.
• Traduções longas ou incorretas : traduções muito longas ou que contêm explicações em vez de traduções diretas são sinalizadas e repetidas.

Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes.