python gpt po

Python GPT-4 PO 파일 번역기

이 Python 스크립트는 OpenAI의 GPT-4 모델을 사용하여 .po 파일을 번역하기 위한 강력하고 유연한 도구를 제공합니다. 다양한 번역 모드를 수용하고, 퍼지 항목을 처리하고, 대규모 프로젝트를 위한 일괄 처리를 통합하므로 다양한 .po 파일 구조 및 크기에 적합합니다.

특징

• 대량 및 개별 번역 모드 : 미묘한 콘텐츠에 대한 효율적인 대량 번역 또는 정확한 항목별 번역이 가능합니다.
• 세부 언어 옵션( --detail-lang ) : 단축 코드(예: nl, de )와 함께 전체 언어 이름(예: "네덜란드, 독일어") 사용을 지원하여 번역 프롬프트의 명확성을 보장합니다.
• 구성 가능한 배치 크기 : 대량 번역 중에 배치당 번역할 항목 수를 설정하여 API 사용을 최적화합니다.
• 퍼지 항목 관리 : 퍼지 플래그와 항목을 자동으로 제거하여 유효한 번역만 처리되도록 합니다.
• 폴더 구조에서 언어 추론 : 폴더 구조에서 대상 언어를 추론하여 명시적인 언어 지정의 필요성을 줄입니다.
• 번역 검증 및 재시도 로직 : 내장된 메커니즘은 번역을 검증하고 부정확하거나 장황한 번역을 피하기 위해 자동으로 재시도합니다.
• 투명성을 위한 로깅 : 번역 프로세스 전반에 걸쳐 진행 상황을 모니터링, 디버깅 및 확인하기 위한 자세한 로깅입니다.
• OpenAI API 키 관리 : OpenAI API 자격 증명을 안전하게 제공하기 위해 환경 변수 또는 명령줄 인수를 지원합니다.
• 실패한 번역에 대한 재시도 메커니즘 : 실패한 번역을 최대 3번까지 재시도하여 불완전하거나 잘못된 출력을 줄입니다.
• 간결한 번역을 위한 후처리 : 번역을 자동으로 검토하여 간결하고 불필요한 설명이나 반복이 없는지 확인합니다.

요구사항

• 파이썬 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 키가 안전하게 저장되어 있고 공공 장소나 저장소에 노출되지 않았는지 확인하세요.

용법

.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 키를 사용하고 대량 모드에서 배치당 40개의 번역을 처리하여 ./locales 폴더에 있는 .po 파일을 독일어 및 프랑스어로 번역합니다. 또한 폴더 구조에서 언어를 추론합니다.

명령줄 옵션

• --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 파일을 참조하세요.