39 lines
1.0 KiB
ReStructuredText
39 lines
1.0 KiB
ReStructuredText
===================
|
|
Kitchen.i18n Module
|
|
===================
|
|
|
|
.. automodule:: kitchen.i18n
|
|
|
|
Functions
|
|
=========
|
|
|
|
:func:`easy_gettext_setup` should satisfy the needs of most users.
|
|
:func:`get_translation_object` is designed to ease the way for anyone that
|
|
needs more control.
|
|
|
|
.. autofunction:: easy_gettext_setup
|
|
|
|
.. autofunction:: get_translation_object
|
|
|
|
Translation Objects
|
|
===================
|
|
|
|
The standard translation objects from the :mod:`gettext` module suffer from
|
|
several problems:
|
|
|
|
* They can throw :exc:`UnicodeError`
|
|
* They can't find translations for non-:term:`ASCII` byte :class:`str`
|
|
messages
|
|
* They may return either :class:`unicode` string or byte :class:`str` from the
|
|
same function even though the functions say they will only return
|
|
:class:`unicode` or only return byte :class:`str`.
|
|
|
|
:class:`DummyTranslations` and :class:`NewGNUTranslations` were written to fix
|
|
these issues.
|
|
|
|
.. autoclass:: kitchen.i18n.DummyTranslations
|
|
:members:
|
|
|
|
.. autoclass:: kitchen.i18n.NewGNUTranslations
|
|
:members:
|