django-autotranslate 1.0.2

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

====================
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| |requirements|

Installation:
-------------

.. code-block:: bash

pip install django-autotranslate

Add ``'autotranslate'`` to your ``INSTALLED_APPS`` setting.

.. code-block:: python

INSTALLED_APPS = (
...
'autotranslate',
)

Quickstart:
-----------

.. code-block:: bash

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:
--------

#. ``-f, --set-fuzzy``: Set the 'fuzzy' flag on autotranslated entries
#. ``-l, --locale 'locale'``: Only translate the specified locales
#. ``-u, --untranslated``: Only translate the untranslated messages

.. code-block:: bash

python manage.py translate_messages -l 'de' -l 'es'


Settings:
---------

#. Use a different Translation Service:

.. code-block:: bash

# default: 'autotranslate.services.GoSlateTranslatorService'
# pip install google-api-python-client
AUTOTRANSLATE_TRANSLATOR_SERVICE = 'autotranslate.services.GoogleAPITranslatorService'
GOOGLE_TRANSLATE_KEY = '<google-api-key>'


Tests:
-----

.. code-block:: bash

# 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


.. |travis-ci| image:: https://travis-ci.org/ankitpopli1891/django-autotranslate.svg?branch=master
:target: https://travis-ci.org/ankitpopli1891/django-autotranslate

.. |pypi-version| image:: https://img.shields.io/pypi/v/django-autotranslate.svg
:target: https://pypi.python.org/pypi/django-autotranslate/

.. |requirements| image:: https://requires.io/github/ankitpopli1891/django-autotranslate/requirements.svg?branch=master
:target: https://requires.io/github/ankitpopli1891/django-autotranslate/requirements/?branch=master