pypoai 1.0

poai: A comprehensive tool for Gettext PO (.po) translation files. It automates translations using artificial intelligence and provides seamless bidirectional conversion between PO and JSON formats.

poai

A .po to JSON and JSON to .po converter with optional AI translation support.

Features

• Bidirectional conversion: .po → JSON and JSON → .po
• AI-powered translation (optional): Use Google Gemini to fill translations
• Empty translation filtering: Skip untranslated messages or process all
• Plural form support: Handles msgid_plural and msgstr[n]
• Batch processing: Translate large files in configurable chunks
• Fallback to source: Automatically fall back to source text for missing translations
• Replace from external JSON: Bulk update translations from a JSON file
• Programmatic and CLI usage: Use as a Python library or via command-line script

Installation

pip install poai

Usage

As a Python library

from poai import PoJsonConverter

# Initialize converter
conv = Poai(
    encoding='utf-8',        # File encoding
    show_empty=False,        # Only include translated messages
    api_key='YOUR_API_KEY'   # Optional Gemini API key for AI translation
)

# Read .po and convert to JSON
data = conv.read_po('locale/tr/LC_MESSAGES/django.po')
conv.save_json('translations.json')

# Load JSON, edit or replace translations, then save back to .po
conv.read_json('translations.json')
conv.set_messages(data['messages'])
conv.save_po('locale/tr/LC_MESSAGES/new.po')

# AI translate missing messages and save results
conv.translate_with_ai(only_empty=True)
conv.save_json('translations_with_ai.json')

CLI (if enabled)

# Read PO, translate all strings, and write JSON
poai read-po --input locale/tr/app.po --show-empty --api-key $GEMINI_KEY \
     | poai save-json --output translations.json

# Replace translations from JSON and write updated PO
poai read-json --input translations.json \
     | poai save-po --output locale/tr/app_updated.po

Development

# Clone and install dev requirements
git clone https://github.com/cagrigungor/poai.git
cd poai
pip install -e .[dev]

# Run tests
pytest

License

This project is licensed under the MIT License. See LICENSE for details.

Author

Hasan Çağrı Güngör
✉️ [e-mail]
🔗 https://github.com/cagrigungor/poai