python gpt po

Penerjemah File Python GPT-4 PO

Skrip Python ini menyediakan alat yang kuat dan fleksibel untuk menerjemahkan file .po menggunakan model GPT-4 OpenAI. Ini mengakomodasi berbagai mode terjemahan, menangani entri fuzzy, dan mengintegrasikan pemrosesan batch untuk proyek yang lebih besar, sehingga cocok untuk beragam struktur dan ukuran file .po .

Fitur

• Mode Terjemahan Massal dan Individual : Memungkinkan terjemahan massal yang efisien atau terjemahan entri demi entri yang tepat untuk konten yang berbeda.
• Opsi Bahasa Terperinci ( --detail-lang ) : Mendukung penggunaan nama bahasa lengkap (misalnya, "Belanda, Jerman") bersama kode pendek (misalnya, nl, de ), memastikan kejelasan dalam petunjuk terjemahan.
• Ukuran Batch yang Dapat Dikonfigurasi : Mengatur jumlah entri yang akan diterjemahkan per batch selama terjemahan massal, mengoptimalkan penggunaan API.
• Manajemen Entri Fuzzy : Secara otomatis menghapus tanda dan entri fuzzy, memastikan hanya terjemahan valid yang diproses.
• Inferensi Bahasa dari Struktur Folder : Menyimpulkan bahasa target dari struktur folder, sehingga mengurangi kebutuhan akan spesifikasi bahasa eksplisit.
• Validasi Terjemahan dan Logika Coba Ulang : Mekanisme bawaan memvalidasi terjemahan dan mencoba ulang secara otomatis untuk menghindari terjemahan yang salah atau bertele-tele.
• Logging untuk Transparansi : Logging mendetail untuk memantau, melakukan debug, dan memastikan kemajuan selama proses penerjemahan.
• Manajemen Kunci OpenAI API : Mendukung variabel lingkungan atau argumen baris perintah untuk memberikan kredensial OpenAI API dengan aman.
• Mekanisme Coba Ulang untuk Terjemahan yang Gagal : Mencoba lagi terjemahan yang gagal hingga tiga kali, sehingga mengurangi keluaran yang tidak lengkap atau salah.
• Pasca-Pemrosesan untuk Terjemahan Ringkas : Secara otomatis meninjau terjemahan untuk memastikan terjemahannya ringkas dan bebas dari penjelasan atau pengulangan yang tidak perlu.

Persyaratan

• Python 3.x
• perpustakaan polib (untuk penanganan file .po )
• paket openai Python (untuk integrasi dengan model OpenAI GPT)
• perpustakaan tenacity (untuk mekanisme percobaan ulang)
• python-dotenv (untuk mengelola variabel lingkungan)

Instalasi

Melalui PyPI

Instal paket gpt-po-translator langsung dari PyPI:

pip install gpt-po-translator

Instalasi Manual

Untuk instalasi manual atau bekerja dengan kode terbaru dari repositori:

1. Kloning repositori:

   git clone [repository URL]

2. Arahkan ke direktori kloning dan instal paket:

   pip install . 

Konfigurasi Kunci API

gpt-po-translator mendukung dua metode untuk menyediakan kredensial OpenAI API:

1. Variabel Lingkungan : Tetapkan kunci API OpenAI Anda sebagai variabel lingkungan bernama OPENAI_API_KEY . Metode ini direkomendasikan untuk keamanan dan kemudahan pengelolaan kunci API.

    export OPENAI_API_KEY= ' your_api_key_here '

2. Argumen Baris Perintah : Meneruskan kunci API sebagai argumen baris perintah menggunakan opsi --api_key .

   gpt-po-translator --folder ./locales --lang de,fr --api_key ' your_api_key_here ' --bulk --bulksize 100 --folder-language

Pastikan kunci API Anda disimpan dengan aman dan tidak terekspos di ruang publik atau repositori.

Penggunaan

Gunakan gpt-po-translator sebagai alat baris perintah untuk menerjemahkan file .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]]

Contoh

gpt-po-translator --folder ./locales --lang de,fr --api_key ' your_api_key_here ' --bulk --bulksize 40 --folder-language --detail-lang " German,French "

Perintah ini menerjemahkan file .po di folder ./locales ke bahasa Jerman dan Prancis, menggunakan kunci API OpenAI yang disediakan dan memproses 40 terjemahan per batch dalam mode massal. Itu juga menyimpulkan bahasa dari struktur folder.

Opsi Baris Perintah

• --folder : Menentukan folder masukan yang berisi file .po .
• --lang : Kode bahasa yang dipisahkan koma untuk memfilter file .po (misal, de,fr ).
• --detail-lang : Argumen opsional untuk nama bahasa lengkap, sesuai dengan urutan --lang (misalnya, "Jerman,Prancis").
• --fuzzy : Menghapus entri fuzzy sebelum diproses.
• --bulk : Mengaktifkan mode terjemahan massal untuk pemrosesan lebih cepat.
• --bulksize : Menyetel ukuran batch untuk terjemahan massal (defaultnya adalah 50).
• --model : Menentukan model OpenAI yang akan digunakan untuk terjemahan (standarnya adalah gpt-3.5-turbo-0125 ).
• --api_key : Kunci API OpenAI. Dapat disediakan melalui baris perintah atau sebagai variabel lingkungan.
• --folder-language : Menyimpulkan bahasa target dari struktur folder.

Nama Bahasa dan Kode Pendek Terperinci

Opsi --detail-lang melengkapi --lang dengan memungkinkan Anda menentukan nama bahasa lengkap (misalnya, Netherlands,German ) alih-alih kode pendek bahasa. Nama lengkapnya kemudian digunakan dalam konteks perintah OpenAI, sehingga meningkatkan kejelasan model GPT.

Contoh penggunaan:

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

Pencatatan

Skrip mencatat informasi rinci tentang file yang sedang diproses, jumlah terjemahan, dan detail batch dalam mode massal. Log sangat penting untuk memantau kemajuan, men-debug masalah, dan memastikan transparansi selama proses penerjemahan.

Penanganan Kesalahan dan Percobaan Ulang

Skrip ini mencakup penanganan kesalahan yang kuat dan percobaan ulang untuk memastikan terjemahan yang andal:

• Terjemahan Gagal : Secara otomatis mencoba ulang terjemahan yang gagal hingga tiga kali.
• Terjemahan Kosong : Jika terjemahan kosong dikembalikan, skrip akan mencoba menerjemahkan teks lagi menggunakan pendekatan alternatif.
• Terjemahan yang Panjang atau Salah : Terjemahan yang terlalu panjang atau mengandung penjelasan alih-alih terjemahan langsung akan ditandai dan dicoba lagi.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT. Lihat file LISENSI untuk detailnya.