python gpt po

مترجم ملفات بايثون GPT-4 PO

يوفر برنامج Python النصي أداة قوية ومرنة لترجمة ملفات .po باستخدام نموذج GPT-4 الخاص بـ OpenAI. فهو يستوعب أوضاع الترجمة المختلفة، ويتعامل مع الإدخالات الغامضة، ويدمج المعالجة المجمعة للمشاريع الأكبر، مما يجعله مناسبًا لهياكل وأحجام ملفات .po المتنوعة.

سمات

• أوضاع الترجمة المجمعة والفردية : تتيح ترجمة مجمعة فعالة أو ترجمات دقيقة لكل إدخال للمحتوى الدقيق.
• خيار اللغة التفصيلي ( --detail-lang ) : يدعم استخدام أسماء اللغات الكاملة (على سبيل المثال، "هولندا، الألمانية") إلى جانب الرموز القصيرة (على سبيل المثال، nl, de )، مما يضمن الوضوح في مطالبات الترجمة.
• حجم الدفعة القابل للتكوين : قم بتعيين عدد الإدخالات المطلوب ترجمتها لكل دفعة أثناء الترجمة المجمعة، مما يؤدي إلى تحسين استخدام واجهة برمجة التطبيقات.
• إدارة الإدخالات الغامضة : تزيل العلامات والإدخالات الغامضة تلقائيًا، مما يضمن معالجة الترجمات الصالحة فقط.
• استدلال اللغة من بنية المجلد : يستنتج اللغة الهدف من بنية المجلد، مما يقلل الحاجة إلى مواصفات لغة صريحة.
• التحقق من صحة الترجمة وإعادة المحاولة المنطقية : تقوم الآليات المضمنة بالتحقق من صحة الترجمات وإعادة المحاولة تلقائيًا لتجنب الترجمات غير الصحيحة أو المطولة.
• التسجيل من أجل الشفافية : تسجيل تفصيلي للمراقبة وتصحيح الأخطاء وضمان التقدم خلال عملية الترجمة.
• إدارة مفاتيح OpenAI API : يدعم متغيرات البيئة أو وسيطات سطر الأوامر لتوفير بيانات اعتماد OpenAI API بشكل آمن.
• آلية إعادة المحاولة للترجمات الفاشلة : إعادة محاولة الترجمات الفاشلة حتى ثلاث مرات، مما يقلل النتائج غير الكاملة أو غير الصحيحة.
• المعالجة اللاحقة للترجمات الموجزة : مراجعة الترجمات تلقائيًا للتأكد من أنها موجزة وخالية من التوضيحات أو التكرارات غير الضرورية.

متطلبات

• بايثون 3.x
• مكتبة polib (لمعالجة ملفات .po )
• حزمة openai Python (للتكامل مع نماذج OpenAI GPT)
• مكتبة tenacity (لآليات إعادة المحاولة)
• python-dotenv (لإدارة متغيرات البيئة)

تثبيت

عبر باي بي آي

قم بتثبيت حزمة gpt-po-translator مباشرةً من PyPI:

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 . يوصى بهذه الطريقة للأمان وسهولة إدارة مفاتيح واجهة برمجة التطبيقات.

    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 إلى الألمانية والفرنسية، باستخدام مفتاح OpenAI API المقدم ومعالجة 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 " 

التسجيل

يسجل البرنامج النصي معلومات تفصيلية حول الملفات التي تتم معالجتها وعدد الترجمات وتفاصيل الدفعة في الوضع المجمع. تعد السجلات ضرورية لمراقبة التقدم وتصحيح الأخطاء وضمان الشفافية طوال عملية الترجمة.

معالجة الأخطاء وإعادة المحاولة

يتضمن البرنامج النصي معالجة قوية للأخطاء وإعادة المحاولة لضمان ترجمة موثوقة:

• الترجمات الفاشلة : إعادة محاولة الترجمات الفاشلة تلقائيًا حتى ثلاث مرات.
• الترجمات الفارغة : إذا تم إرجاع ترجمة فارغة، فسيحاول البرنامج النصي ترجمة النص مرة أخرى باستخدام أسلوب بديل.
• الترجمات الطويلة أو غير الصحيحة : يتم وضع علامة على الترجمات الطويلة جدًا أو التي تحتوي على شرح بدلاً من الترجمات المباشرة وإعادة المحاولة.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. راجع ملف الترخيص للحصول على التفاصيل.