From 27a5c4e0e343e8da47a921b59701ae9e983da764 Mon Sep 17 00:00:00 2001 From: David Lord Date: Wed, 29 Jan 2020 06:17:56 -0800 Subject: [PATCH] add note about ugettext --- src/jinja2/ext.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/jinja2/ext.py b/src/jinja2/ext.py index 7c36bb43..533ff179 100644 --- a/src/jinja2/ext.py +++ b/src/jinja2/ext.py @@ -26,11 +26,9 @@ from .runtime import concat from .utils import contextfunction from .utils import import_string -# the only real useful gettext functions for a Jinja template. Note -# that ugettext must be assigned to gettext as Jinja doesn't support -# non unicode strings. +# I18N functions available in Jinja templates. If the I18N library +# provides ugettext, it will be assigned to gettext. GETTEXT_FUNCTIONS = ("_", "gettext", "ngettext") - _ws_re = re.compile(r"\s*\n\s*") @@ -192,6 +190,8 @@ class InternationalizationExtension(Extension): ) def _install(self, translations, newstyle=None): + # ugettext and ungettext are preferred in case the I18N library + # is providing compatibility with older Python versions. gettext = getattr(translations, "ugettext", None) if gettext is None: gettext = translations.gettext -- 2.47.2