puente 0.3

Strings extraction and other tools

======
puente
======

**This is an experiment. Don't use this, yet.**

.. image:: puente_logo.jpg

Puente is a Python library that handles l10n things for Django projects
using Jinja2 templates.

* extract command to extract strings from your project and shove them into a
``.pot`` file
* merge command that merges new strings from a ``.pot`` file into locale ``.po``
files
* code to collapse whitespace for Jinja2's trans block
* code to mark all gettext output as safe in templates
* driven from Django settings
* solid documentation

This is derived from `Tower <https://github.com/clouserw/tower>`_, but heavily
changed.

:Code: https://github.com/mozilla/puente/
:Issues: https://github.com/mozilla/puente/issues
:License: BSD 3-clause; See LICENSE
:Contributors: See AUTHORS.rst
:Documentation: https://puente.readthedocs.org/en/latest/
:IRC: #puente on irc.mozilla.org


Install
=======

>From PyPI
---------

Run::

$ pip install puente


For hacking
-----------

Run::

# Clone the repository
$ git clone https://github.com/mozilla/puente

# Create a virtualenvironment
...

# Install Puente and dev requirements
$ pip install -r requirements-dev.txt


Usage
=====

See documentation for configuration and usage.




=======
History
=======

0.3 (November 5th, 2015)
========================

* add "Translators:" to the translator prefix list (#34)
* make ``puente.ext.i18n`` be an alias for ``puente.ext.PuenteI18nExtension``
* fix the gettext alias to be moar korrect (#35)
* fix the jingo-related docs in regards to extensions (#35)
* lots of changes to the Migrating from Tower document
* fleshed out ``test_project_jingo`` so we can use it for development
* fixed merge to handle ``LANGUAGES`` setting correctly
* first pass on Python 3.4 support (pretty sure it works) (#15)
* logo (#37)


0.2 (October 30th, 2015)
========================

* fix requirements
* remove mention of elasticutils in release process
* fix meta information regarding python 3--we don't support that, yet


0.1 (October 30th, 2015)
========================

Initial writing. Everything has changed!