python gpt po

Переводчик файлов Python GPT-4 PO

Этот скрипт Python предоставляет надежный и гибкий инструмент для перевода файлов .po с использованием модели OpenAI GPT-4. Он поддерживает различные режимы перевода, обрабатывает нечеткие записи и интегрирует пакетную обработку для более крупных проектов, что делает его подходящим для различных структур и размеров файлов .po .

Функции

• Массовый и индивидуальный режимы перевода . Обеспечивает эффективный массовый перевод или точный, поэтапный перевод для тонкого контента.
• Подробный вариант языка ( --detail-lang ) : поддерживает использование полных названий языков (например, «Нидерланды, немецкий») вместе с короткими кодами (например, nl, de ), обеспечивая ясность в подсказках по переводу.
• Настраиваемый размер пакета : установите количество записей для перевода в каждом пакете во время массового перевода, оптимизируя использование API.
• Управление нечеткими вводами : автоматически удаляет нечеткие флаги и записи, обеспечивая обработку только действительных переводов.
• Вывод языка из структуры папок : выводит целевой язык из структуры папок, уменьшая необходимость в явных спецификациях языка.
• Проверка перевода и логика повтора : встроенные механизмы проверяют переводы и автоматически повторяют попытки, чтобы избежать неправильных или многословных переводов.
• Ведение журнала для прозрачности : подробное ведение журнала для мониторинга, отладки и обеспечения прогресса на протяжении всего процесса перевода.
• Управление ключами OpenAI API : поддерживает переменные среды или аргументы командной строки для безопасного предоставления учетных данных OpenAI API.
• Механизм повтора для неудачных переводов : повторяет неудачные переводы до трех раз, что снижает количество неполных или неправильных результатов.
• Постобработка для кратких переводов : автоматически проверяет переводы, чтобы убедиться, что они краткие и не содержат ненужных объяснений или повторов.

Требования

• Питон 3.x
• библиотека polib (для обработки файлов .po )
• пакет openai Python (для интеграции с моделями OpenAI GPT)
• библиотека tenacity (для механизмов повтора)
• python-dotenv (для управления переменными среды)

Установка

Через PyPI

Установите пакет gpt-po-translator прямо из PyPI:

pip install gpt-po-translator

Ручная установка

Для ручной установки или работы с последним кодом из репозитория:

1. Клонируем репозиторий:

   git clone [repository URL]

2. Перейдите в клонированный каталог и установите пакет:

   pip install . 

Конфигурация API-ключа

gpt-po-translator поддерживает два метода предоставления учетных данных OpenAI API:

1. Переменная среды : установите ключ API OpenAI в качестве переменной среды с именем OPENAI_API_KEY . Этот метод рекомендуется для обеспечения безопасности и простоты управления ключами API.

    export OPENAI_API_KEY= ' your_api_key_here '

2. Аргумент командной строки : передайте ключ API в качестве аргумента командной строки, используя параметр --api_key .

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

Убедитесь, что ваш ключ API надежно хранится и не доступен в общедоступных местах или репозиториях.

Использование

Используйте gpt-po-translator в качестве инструмента командной строки для перевода файлов .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]]

Пример

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

Эта команда переводит файлы .po в папке ./locales на немецкий и французский языки, используя предоставленный ключ API OpenAI и обрабатывая 40 переводов за пакет в массовом режиме. Он также определяет язык из структуры папок.

Параметры командной строки

• --folder : указывает входную папку, содержащую файлы .po .
• --lang : коды языков, разделенные запятыми, для фильтрации файлов .po (например, de,fr ).
• --detail-lang : Необязательный аргумент для полных названий языков, соответствующий порядку --lang (например, «Немецкий, Французский»).
• --fuzzy : удаляет нечеткие записи перед обработкой.
• --bulk : включает режим массового перевода для более быстрой обработки.
• --bulksize : устанавливает размер пакета для массового перевода (по умолчанию — 50).
• --model : указывает модель OpenAI, используемую для переводов (по умолчанию — gpt-3.5-turbo-0125 ).
• --api_key : ключ API OpenAI. Может быть предоставлен через командную строку или как переменная среды.
• --folder-language : определяет целевой язык из структуры папок.

Подробные названия языков и короткие коды

Опция --detail-lang дополняет --lang , позволяя вам указывать полные названия языков (например, Netherlands,German ) вместо коротких кодов языков. Полные имена затем используются в контексте подсказок OpenAI, что повышает ясность модели GPT.

Пример использования:

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

Ведение журнала

Скрипт записывает подробную информацию об обрабатываемых файлах, количестве переводов и сведениях о пакете в массовом режиме. Журналы необходимы для мониторинга прогресса, устранения проблем и обеспечения прозрачности на протяжении всего процесса перевода.

Обработка ошибок и повторные попытки

Сценарий включает в себя надежную обработку ошибок и повторные попытки для обеспечения надежного перевода:

• Неудачные переводы : автоматически повторяет неудачные переводы до трех раз.
• Пустые переводы : если возвращается пустой перевод, скрипт попытается перевести текст еще раз, используя альтернативный подход.
• Длинные или неправильные переводы . Переводы, которые слишком длинные или содержат пояснения вместо прямого перевода, помечаются и повторяются.

Лицензия

Этот проект лицензируется по лицензии MIT. Подробности смотрите в файле ЛИЦЕНЗИИ.