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 許可證的許可。有關詳細信息，請參閱許可證文件。