python gpt po

เครื่องมือแปลไฟล์ Python GPT-4 PO

สคริปต์ Python นี้มอบเครื่องมือที่มีประสิทธิภาพและยืดหยุ่นสำหรับการแปลไฟล์ .po โดยใช้โมเดล GPT-4 ของ OpenAI รองรับโหมดการแปลที่หลากหลาย จัดการรายการที่ไม่ชัดเจน และรวมการประมวลผลเป็นชุดสำหรับโปรเจ็กต์ขนาดใหญ่ ทำให้เหมาะสำหรับโครงสร้างและขนาดไฟล์ .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. ตัวแปรสภาพแวดล้อม : ตั้งค่าคีย์ OpenAI API ของคุณเป็นตัวแปรสภาพแวดล้อมชื่อ 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 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 ดูไฟล์ใบอนุญาตสำหรับรายละเอียด