/django-autotranslate

A simple Django app to automatically translate the pot (.po) files generated by django's makemessages command using google translate.

Primary LanguagePythonMIT LicenseMIT

django-autotranslate

A simple Django app to automatically translate the pot (.po) files generated by django's makemessages command using google translate.

travis-ci pypi-version pypi-downloads-month requirements

Installation:

pip install django-autotranslate

Add 'autotranslate' to your INSTALLED_APPS setting.

INSTALLED_APPS = (
    ...
    'autotranslate',
)

Quickstart:

python manage.py translate_messages

The command finds all the generated pot (.po) files under the locale paths (LOCALE_PATHS) specified in django project settings, and translates them automatically.

Options:

  1. -f, --set-fuzzy: Set the 'fuzzy' flag on autotranslated entries
  2. -l, --locale 'locale': Only translate the specified locales
  3. -u, --untranslated: Only translate the untranslated messages
python manage.py translate_messages -l 'de' -l 'es'

Settings:

  1. Use a different Translation Service:
# default: 'autotranslate.services.GoSlateTranslatorService'
# pip install google-api-python-client
AUTOTRANSLATE_TRANSLATOR_SERVICE = 'autotranslate.services.GoogleAPITranslatorService'
GOOGLE_TRANSLATE_KEY = '<google-api-key>'

Tests:

# run test against all environments
tox
# run test against a specific environment defined in tox.ini
# eg. django>1.9 & python3.4
tox -e dj19-py34