python gpt po

Python GPT-4 PO 文件转换器

此 Python 脚本提供了一个强大而灵活的工具，用于使用 OpenAI 的 GPT-4 模型翻译.po文件。它适应各种翻译模式，处理模糊条目，并集成大型项目的批处理，使其适合各种.po文件结构和大小。

特征

• 批量和单独翻译模式：允许对细致入微的内容进行高效的批量翻译或精确的逐条翻译。
• 详细语言选项 ( --detail-lang ) ：支持使用完整语言名称（例如“荷兰、德语”）和短代码（例如nl, de ），确保翻译提示的清晰度。
• 可配置的批量大小：设置批量翻译期间每批要翻译的条目数，优化 API 使用。
• 模糊条目管理：自动删除模糊标记和条目，确保仅处理有效的翻译。
• 从文件夹结构推断语言：从文件夹结构推断目标语言，减少对显式语言规范的需求。
• 翻译验证和重试逻辑：内置机制验证翻译并自动重试以避免不正确或冗长的翻译。
• 透明日志记录：用于监控、调试和确保整个翻译过程进度的详细日志记录。
• OpenAI API 密钥管理：支持环境变量或命令行参数，以安全地提供 OpenAI API 凭证。
• 失败翻译重试机制：最多重试失败翻译三次，减少不完整或不正确的输出。
• 简洁翻译的后处理：自动审查翻译，以确保它们简洁且没有不必要的解释或重复。

要求

• Python 3.x
• polib库（用于.po文件处理）
• openai Python 包（用于与 OpenAI GPT 模型集成）
• tenacity库（用于重试机制）
• python-dotenv （用于管理环境变量）

安装

通过 PyPI

直接从 PyPI 安装gpt-po-translator包：

pip install gpt-po-translator

手动安装

对于手动安装或使用存储库中的最新代码：

1. 克隆存储库：

   git clone [repository URL]

2. 导航到克隆的目录并安装包：

   pip install . 

API密钥配置

gpt-po-translator支持两种提供 OpenAI API 凭证的方法：

1. 环境变量：将您的 OpenAI API 密钥设置为名为OPENAI_API_KEY的环境变量。为了安全性和 API 密钥管理的简便性，建议使用此方法。

    export OPENAI_API_KEY= ' your_api_key_here '

2. 命令行参数：使用--api_key选项将 API 密钥作为命令行参数传递。

   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 "

此命令使用提供的 OpenAI API 密钥将./locales文件夹中的.po文件翻译为德语和法语，并以批量模式每批处理 40 个翻译。它还从文件夹结构推断语言。

命令行选项

• --folder ：指定包含.po文件的输入文件夹。
• --lang ：用于过滤.po文件的逗号分隔语言代码（例如de,fr ）。
• --detail-lang ：完整语言名称的可选参数，与--lang的顺序匹配（例如，“德语，法语”）。
• --fuzzy ：在处理之前删除模糊条目。
• --bulk ：启用批量翻译模式以加快处理速度。
• --bulksize ：设置批量翻译的批量大小（默认为 50）。
• --model ：指定用于翻译的 OpenAI 模型（默认为gpt-3.5-turbo-0125 ）。
• --api_key ：OpenAI API 密钥。可以通过命令行或作为环境变量提供。
• --folder-language ：从文件夹结构推断目标语言。

详细的语言名称和简码

--detail-lang选项对--lang进行了补充，允许您指定完整的语言名称（例如， Netherlands,German ）而不是语言短代码。然后在 OpenAI 提示的上下文中使用全名，从而提高 GPT 模型的清晰度。

用法示例：

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

记录

该脚本以批量模式记录有关正在处理的文件、翻译数量和批次详细信息的详细信息。日志对于监控进度、调试问题和确保整个翻译过程的透明度至关重要。

错误处理和重试

该脚本包括强大的错误处理和重试以确保可靠的翻译：

• 失败翻译：自动重试失败翻译最多 3 次。
• 空翻译：如果返回空翻译，脚本将尝试使用替代方法再次翻译文本。
• 冗长或不正确的翻译：太长或包含解释而不是直接翻译的翻译将被标记并重试。

执照

该项目已获得 MIT 许可证的许可。有关详细信息，请参阅许可证文件。