120 lines
3.8 KiB
Python
120 lines
3.8 KiB
Python
"""
|
|
Internationalization support.
|
|
"""
|
|
from django.utils.encoding import force_unicode
|
|
from django.utils.functional import lazy, curry
|
|
|
|
|
|
__all__ = ['gettext', 'gettext_noop', 'gettext_lazy', 'ngettext',
|
|
'ngettext_lazy', 'string_concat', 'activate', 'deactivate',
|
|
'get_language', 'get_language_bidi', 'get_date_formats',
|
|
'get_partial_date_formats', 'check_for_language', 'to_locale',
|
|
'get_language_from_request', 'templatize', 'ugettext', 'ugettext_lazy',
|
|
'ungettext', 'ungettext_lazy', 'pgettext', 'pgettext_lazy',
|
|
'npgettext', 'npgettext_lazy', 'deactivate_all']
|
|
|
|
# Here be dragons, so a short explanation of the logic won't hurt:
|
|
# We are trying to solve two problems: (1) access settings, in particular
|
|
# settings.USE_I18N, as late as possible, so that modules can be imported
|
|
# without having to first configure Django, and (2) if some other code creates
|
|
# a reference to one of these functions, don't break that reference when we
|
|
# replace the functions with their real counterparts (once we do access the
|
|
# settings).
|
|
|
|
class Trans(object):
|
|
"""
|
|
The purpose of this class is to store the actual translation function upon
|
|
receiving the first call to that function. After this is done, changes to
|
|
USE_I18N will have no effect to which function is served upon request. If
|
|
your tests rely on changing USE_I18N, you can delete all the functions
|
|
from _trans.__dict__.
|
|
|
|
Note that storing the function with setattr will have a noticeable
|
|
performance effect, as access to the function goes the normal path,
|
|
instead of using __getattr__.
|
|
"""
|
|
def __getattr__(self, real_name):
|
|
from django.conf import settings
|
|
if settings.USE_I18N:
|
|
from django.utils.translation import trans_real as trans
|
|
else:
|
|
from django.utils.translation import trans_null as trans
|
|
setattr(self, real_name, getattr(trans, real_name))
|
|
return getattr(trans, real_name)
|
|
|
|
_trans = Trans()
|
|
|
|
# The Trans class is no more needed, so remove it from the namespace.
|
|
del Trans
|
|
|
|
def gettext_noop(message):
|
|
return _trans.gettext_noop(message)
|
|
|
|
ugettext_noop = gettext_noop
|
|
|
|
def gettext(message):
|
|
return _trans.gettext(message)
|
|
|
|
def ngettext(singular, plural, number):
|
|
return _trans.ngettext(singular, plural, number)
|
|
|
|
def ugettext(message):
|
|
return _trans.ugettext(message)
|
|
|
|
def ungettext(singular, plural, number):
|
|
return _trans.ungettext(singular, plural, number)
|
|
|
|
def pgettext(context, message):
|
|
return _trans.pgettext(context, message)
|
|
|
|
def npgettext(context, singular, plural, number):
|
|
return _trans.npgettext(context, singular, plural, number)
|
|
|
|
ngettext_lazy = lazy(ngettext, str)
|
|
gettext_lazy = lazy(gettext, str)
|
|
ungettext_lazy = lazy(ungettext, unicode)
|
|
ugettext_lazy = lazy(ugettext, unicode)
|
|
pgettext_lazy = lazy(pgettext, unicode)
|
|
npgettext_lazy = lazy(npgettext, unicode)
|
|
|
|
def activate(language):
|
|
return _trans.activate(language)
|
|
|
|
def deactivate():
|
|
return _trans.deactivate()
|
|
|
|
def get_language():
|
|
return _trans.get_language()
|
|
|
|
def get_language_bidi():
|
|
return _trans.get_language_bidi()
|
|
|
|
def get_date_formats():
|
|
return _trans.get_date_formats()
|
|
|
|
def get_partial_date_formats():
|
|
return _trans.get_partial_date_formats()
|
|
|
|
def check_for_language(lang_code):
|
|
return _trans.check_for_language(lang_code)
|
|
|
|
def to_locale(language):
|
|
return _trans.to_locale(language)
|
|
|
|
def get_language_from_request(request):
|
|
return _trans.get_language_from_request(request)
|
|
|
|
def templatize(src):
|
|
return _trans.templatize(src)
|
|
|
|
def deactivate_all():
|
|
return _trans.deactivate_all()
|
|
|
|
def _string_concat(*strings):
|
|
"""
|
|
Lazy variant of string concatenation, needed for translations that are
|
|
constructed from multiple parts.
|
|
"""
|
|
return u''.join([force_unicode(s) for s in strings])
|
|
string_concat = lazy(_string_concat, unicode)
|