ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / share / doc / python-kitchen-1.1.1 / html / _sources

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

[-] api-text-converters.txt [edit]
[-] api-pycompat25.txt [edit]
[-] api-collections.txt [edit]
[+] ..
[-] api-text-utf8.txt [edit]
[-] glossary.txt [edit]
[-] index.txt [edit]
[-] api-pycompat27.txt [edit]
[-] api-overview.txt [edit]
[-] api-i18n.txt [edit]
[-] api-text-misc.txt [edit]
[-] unicode-frustrations.txt [edit]
[-] porting-guide-0.3.txt [edit]
[-] hacking.txt [edit]
[-] api-iterutils.txt [edit]
[-] api-versioning.txt [edit]
[-] api-pycompat24.txt [edit]
[-] designing-unicode-apis.txt [edit]
[-] api-exceptions.txt [edit]
[-] tutorial.txt [edit]
[-] api-text-display.txt [edit]
[-] api-text.txt [edit]