python gpt po

Python GPT-4 PO ファイル トランスレータ

この Python スクリプトは、OpenAI の GPT-4 モデルを使用して.poファイルを翻訳するための堅牢かつ柔軟なツールを提供します。さまざまな翻訳モードに対応し、あいまいなエントリを処理し、大規模プロジェクト向けのバッチ処理を統合することで、さまざまな.poファイル構造とサイズに適しています。

特徴

• 一括翻訳モードと個別翻訳モード: 効率的な一括翻訳、または微妙な内容の正確なエントリごとの翻訳が可能です。
• 詳細言語オプション ( --detail-lang ) : 完全な言語名 (例: 「オランダ、ドイツ語」) とショートコード (例: nl, de ) の使用をサポートし、翻訳プロンプトの明瞭さを確保します。
• 構成可能なバッチ サイズ: 一括翻訳中にバッチごとに翻訳するエントリの数を設定し、API の使用を最適化します。
• ファジー エントリ管理: ファジー フラグとエントリを自動的に削除し、有効な翻訳のみが処理されるようにします。
• フォルダー構造からの言語推論: フォルダー構造からターゲット言語を推論し、明示的な言語仕様の必要性を減らします。
• 翻訳の検証と再試行ロジック: 組み込みのメカニズムにより翻訳が検証され、不正確または冗長な翻訳を避けるために自動的に再試行されます。
• 透明性のためのログ: 監視、デバッグ、翻訳プロセス全体の進行状況の確認のための詳細なログ。
• OpenAI API キー管理: OpenAI API 資格情報を安全に提供するための環境変数またはコマンドライン引数をサポートします。
• 失敗した翻訳の再試行メカニズム: 失敗した翻訳を最大 3 回再試行し、不完全または不正確な出力を減らします。
• 簡潔な翻訳のための後処理: 翻訳が自動的にレビューされ、簡潔で不必要な説明や繰り返しが含まれていないことを確認します。

要件

• Python 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 資格情報を提供するための 2 つの方法をサポートしています。

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 キーが安全に保管され、公共スペースやリポジトリに公開されないようにしてください。

使用法

.poファイルを翻訳するためのコマンドライン ツールとしてgpt-po-translator使用します。

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 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オプションは、言語ショートコードの代わりに完全な言語名 (例: Netherlands,German ) を指定できるようにすることで--langを補完します。フルネームは OpenAI プロンプトのコンテキストで使用され、GPT モデルの明確さが向上します。

使用例:

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

ロギング

このスクリプトは、処理中のファイル、翻訳数、バッチの詳細に関する詳細情報を一括モードでログに記録します。ログは、進行状況の監視、問題のデバッグ、翻訳プロセス全体の透明性の確保に不可欠です。

エラー処理と再試行

スクリプトには、信頼性の高い変換を保証するための堅牢なエラー処理と再試行が含まれています。

• 失敗した翻訳: 失敗した翻訳を最大 3 回まで自動的に再試行します。
• 空の翻訳: 空の翻訳が返された場合、スクリプトは別のアプローチを使用してテキストの再翻訳を試みます。
• 長い翻訳または不正確な翻訳: 長すぎる翻訳、または直接翻訳ではなく説明が含まれている翻訳にはフラグが付けられ、再試行されます。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。