From d291c72bf24387e4abe8d9883ebe9c69abdd26d0 Mon Sep 17 00:00:00 2001 From: Mike Hansen Date: Fri, 21 Jun 2019 09:41:01 -0700 Subject: Fixed #30585 -- Added {% translate %} and {% blocktranslate %} template tags. --- .../syntax_tests/i18n/test_blocktrans.py | 475 ----------------- .../syntax_tests/i18n/test_blocktranslate.py | 562 +++++++++++++++++++++ .../template_tests/syntax_tests/i18n/test_trans.py | 212 -------- .../syntax_tests/i18n/test_translate.py | 269 ++++++++++ 4 files changed, 831 insertions(+), 687 deletions(-) delete mode 100644 tests/template_tests/syntax_tests/i18n/test_blocktrans.py create mode 100644 tests/template_tests/syntax_tests/i18n/test_blocktranslate.py delete mode 100644 tests/template_tests/syntax_tests/i18n/test_trans.py create mode 100644 tests/template_tests/syntax_tests/i18n/test_translate.py (limited to 'tests/template_tests/syntax_tests') diff --git a/tests/template_tests/syntax_tests/i18n/test_blocktrans.py b/tests/template_tests/syntax_tests/i18n/test_blocktrans.py deleted file mode 100644 index 744b410ea6..0000000000 --- a/tests/template_tests/syntax_tests/i18n/test_blocktrans.py +++ /dev/null @@ -1,475 +0,0 @@ -import os - -from asgiref.local import Local - -from django.template import Context, Template, TemplateSyntaxError -from django.test import SimpleTestCase, override_settings -from django.utils import translation -from django.utils.safestring import mark_safe -from django.utils.translation import trans_real - -from ...utils import setup -from .base import MultipleLocaleActivationTestCase, extended_locale_paths, here - - -class I18nBlockTransTagTests(SimpleTestCase): - libraries = {'i18n': 'django.templatetags.i18n'} - - @setup({'i18n03': '{% load i18n %}{% blocktrans %}{{ anton }}{% endblocktrans %}'}) - def test_i18n03(self): - """simple translation of a variable""" - output = self.engine.render_to_string('i18n03', {'anton': 'Å'}) - self.assertEqual(output, 'Å') - - @setup({'i18n04': '{% load i18n %}{% blocktrans with berta=anton|lower %}{{ berta }}{% endblocktrans %}'}) - def test_i18n04(self): - """simple translation of a variable and filter""" - output = self.engine.render_to_string('i18n04', {'anton': 'Å'}) - self.assertEqual(output, 'å') - - @setup({'legacyi18n04': '{% load i18n %}' - '{% blocktrans with anton|lower as berta %}{{ berta }}{% endblocktrans %}'}) - def test_legacyi18n04(self): - """simple translation of a variable and filter""" - output = self.engine.render_to_string('legacyi18n04', {'anton': 'Å'}) - self.assertEqual(output, 'å') - - @setup({'i18n05': '{% load i18n %}{% blocktrans %}xxx{{ anton }}xxx{% endblocktrans %}'}) - def test_i18n05(self): - """simple translation of a string with interpolation""" - output = self.engine.render_to_string('i18n05', {'anton': 'yyy'}) - self.assertEqual(output, 'xxxyyyxxx') - - @setup({'i18n07': '{% load i18n %}' - '{% blocktrans count counter=number %}singular{% plural %}' - '{{ counter }} plural{% endblocktrans %}'}) - def test_i18n07(self): - """translation of singular form""" - output = self.engine.render_to_string('i18n07', {'number': 1}) - self.assertEqual(output, 'singular') - - @setup({'legacyi18n07': '{% load i18n %}' - '{% blocktrans count number as counter %}singular{% plural %}' - '{{ counter }} plural{% endblocktrans %}'}) - def test_legacyi18n07(self): - """translation of singular form""" - output = self.engine.render_to_string('legacyi18n07', {'number': 1}) - self.assertEqual(output, 'singular') - - @setup({'i18n08': '{% load i18n %}' - '{% blocktrans count number as counter %}singular{% plural %}' - '{{ counter }} plural{% endblocktrans %}'}) - def test_i18n08(self): - """translation of plural form""" - output = self.engine.render_to_string('i18n08', {'number': 2}) - self.assertEqual(output, '2 plural') - - @setup({'legacyi18n08': '{% load i18n %}' - '{% blocktrans count counter=number %}singular{% plural %}' - '{{ counter }} plural{% endblocktrans %}'}) - def test_legacyi18n08(self): - """translation of plural form""" - output = self.engine.render_to_string('legacyi18n08', {'number': 2}) - self.assertEqual(output, '2 plural') - - @setup({'i18n17': '{% load i18n %}' - '{% blocktrans with berta=anton|escape %}{{ berta }}{% endblocktrans %}'}) - def test_i18n17(self): - """ - Escaping inside blocktrans and trans works as if it was directly in the - template. - """ - output = self.engine.render_to_string('i18n17', {'anton': 'α & β'}) - self.assertEqual(output, 'α & β') - - @setup({'i18n18': '{% load i18n %}' - '{% blocktrans with berta=anton|force_escape %}{{ berta }}{% endblocktrans %}'}) - def test_i18n18(self): - output = self.engine.render_to_string('i18n18', {'anton': 'α & β'}) - self.assertEqual(output, 'α & β') - - @setup({'i18n19': '{% load i18n %}{% blocktrans %}{{ andrew }}{% endblocktrans %}'}) - def test_i18n19(self): - output = self.engine.render_to_string('i18n19', {'andrew': 'a & b'}) - self.assertEqual(output, 'a & b') - - @setup({'i18n21': '{% load i18n %}{% blocktrans %}{{ andrew }}{% endblocktrans %}'}) - def test_i18n21(self): - output = self.engine.render_to_string('i18n21', {'andrew': mark_safe('a & b')}) - self.assertEqual(output, 'a & b') - - @setup({'legacyi18n17': '{% load i18n %}' - '{% blocktrans with anton|escape as berta %}{{ berta }}{% endblocktrans %}'}) - def test_legacyi18n17(self): - output = self.engine.render_to_string('legacyi18n17', {'anton': 'α & β'}) - self.assertEqual(output, 'α & β') - - @setup({'legacyi18n18': '{% load i18n %}' - '{% blocktrans with anton|force_escape as berta %}' - '{{ berta }}{% endblocktrans %}'}) - def test_legacyi18n18(self): - output = self.engine.render_to_string('legacyi18n18', {'anton': 'α & β'}) - self.assertEqual(output, 'α & β') - - @setup({'i18n26': '{% load i18n %}' - '{% blocktrans with extra_field=myextra_field count counter=number %}' - 'singular {{ extra_field }}{% plural %}plural{% endblocktrans %}'}) - def test_i18n26(self): - """ - translation of plural form with extra field in singular form (#13568) - """ - output = self.engine.render_to_string('i18n26', {'myextra_field': 'test', 'number': 1}) - self.assertEqual(output, 'singular test') - - @setup({'legacyi18n26': '{% load i18n %}' - '{% blocktrans with myextra_field as extra_field count number as counter %}' - 'singular {{ extra_field }}{% plural %}plural{% endblocktrans %}'}) - def test_legacyi18n26(self): - output = self.engine.render_to_string('legacyi18n26', {'myextra_field': 'test', 'number': 1}) - self.assertEqual(output, 'singular test') - - @setup({'i18n27': '{% load i18n %}{% blocktrans count counter=number %}' - '{{ counter }} result{% plural %}{{ counter }} results' - '{% endblocktrans %}'}) - def test_i18n27(self): - """translation of singular form in Russian (#14126)""" - with translation.override('ru'): - output = self.engine.render_to_string('i18n27', {'number': 1}) - self.assertEqual(output, '1 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442') - - @setup({'legacyi18n27': '{% load i18n %}' - '{% blocktrans count number as counter %}{{ counter }} result' - '{% plural %}{{ counter }} results{% endblocktrans %}'}) - def test_legacyi18n27(self): - with translation.override('ru'): - output = self.engine.render_to_string('legacyi18n27', {'number': 1}) - self.assertEqual(output, '1 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442') - - @setup({'i18n28': '{% load i18n %}' - '{% blocktrans with a=anton b=berta %}{{ a }} + {{ b }}{% endblocktrans %}'}) - def test_i18n28(self): - """simple translation of multiple variables""" - output = self.engine.render_to_string('i18n28', {'anton': 'α', 'berta': 'β'}) - self.assertEqual(output, 'α + β') - - @setup({'legacyi18n28': '{% load i18n %}' - '{% blocktrans with anton as a and berta as b %}' - '{{ a }} + {{ b }}{% endblocktrans %}'}) - def test_legacyi18n28(self): - output = self.engine.render_to_string('legacyi18n28', {'anton': 'α', 'berta': 'β'}) - self.assertEqual(output, 'α + β') - - # blocktrans handling of variables which are not in the context. - # this should work as if blocktrans was not there (#19915) - @setup({'i18n34': '{% load i18n %}{% blocktrans %}{{ missing }}{% endblocktrans %}'}) - def test_i18n34(self): - output = self.engine.render_to_string('i18n34') - if self.engine.string_if_invalid: - self.assertEqual(output, 'INVALID') - else: - self.assertEqual(output, '') - - @setup({'i18n34_2': '{% load i18n %}{% blocktrans with a=\'α\' %}{{ missing }}{% endblocktrans %}'}) - def test_i18n34_2(self): - output = self.engine.render_to_string('i18n34_2') - if self.engine.string_if_invalid: - self.assertEqual(output, 'INVALID') - else: - self.assertEqual(output, '') - - @setup({'i18n34_3': '{% load i18n %}{% blocktrans with a=anton %}{{ missing }}{% endblocktrans %}'}) - def test_i18n34_3(self): - output = self.engine.render_to_string( - 'i18n34_3', {'anton': '\xce\xb1'}) - if self.engine.string_if_invalid: - self.assertEqual(output, 'INVALID') - else: - self.assertEqual(output, '') - - @setup({'i18n37': '{% load i18n %}' - '{% trans "Page not found" as page_not_found %}' - '{% blocktrans %}Error: {{ page_not_found }}{% endblocktrans %}'}) - def test_i18n37(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n37') - self.assertEqual(output, 'Error: Seite nicht gefunden') - - # blocktrans tag with asvar - @setup({'i18n39': '{% load i18n %}' - '{% blocktrans asvar page_not_found %}Page not found{% endblocktrans %}' - '>{{ page_not_found }}<'}) - def test_i18n39(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n39') - self.assertEqual(output, '>Seite nicht gefunden<') - - @setup({'i18n40': '{% load i18n %}' - '{% trans "Page not found" as pg_404 %}' - '{% blocktrans with page_not_found=pg_404 asvar output %}' - 'Error: {{ page_not_found }}' - '{% endblocktrans %}'}) - def test_i18n40(self): - output = self.engine.render_to_string('i18n40') - self.assertEqual(output, '') - - @setup({'i18n41': '{% load i18n %}' - '{% trans "Page not found" as pg_404 %}' - '{% blocktrans with page_not_found=pg_404 asvar output %}' - 'Error: {{ page_not_found }}' - '{% endblocktrans %}' - '>{{ output }}<'}) - def test_i18n41(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n41') - self.assertEqual(output, '>Error: Seite nicht gefunden<') - - @setup({'template': '{% load i18n %}{% blocktrans asvar %}Yes{% endblocktrans %}'}) - def test_blocktrans_syntax_error_missing_assignment(self): - msg = "No argument provided to the 'blocktrans' tag for the asvar option." - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% blocktrans %}%s{% endblocktrans %}'}) - def test_blocktrans_tag_using_a_string_that_looks_like_str_fmt(self): - output = self.engine.render_to_string('template') - self.assertEqual(output, '%s') - - @setup({'template': '{% load i18n %}{% blocktrans %}{% block b %} {% endblock %}{% endblocktrans %}'}) - def test_with_block(self): - msg = "'blocktrans' doesn't allow other block tags (seen 'block b') inside it" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% blocktrans %}{% for b in [1, 2, 3] %} {% endfor %}{% endblocktrans %}'}) - def test_with_for(self): - msg = "'blocktrans' doesn't allow other block tags (seen 'for b in [1, 2, 3]') inside it" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% blocktrans with foo=bar with %}{{ foo }}{% endblocktrans %}'}) - def test_variable_twice(self): - with self.assertRaisesMessage(TemplateSyntaxError, "The 'with' option was specified more than once"): - self.engine.render_to_string('template', {'foo': 'bar'}) - - @setup({'template': '{% load i18n %}{% blocktrans with %}{% endblocktrans %}'}) - def test_no_args_with(self): - msg = '"with" in \'blocktrans\' tag needs at least one keyword argument.' - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% blocktrans count a %}{% endblocktrans %}'}) - def test_count(self): - msg = '"count" in \'blocktrans\' tag expected exactly one keyword argument.' - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template', {'a': [1, 2, 3]}) - - @setup({'template': ( - '{% load i18n %}{% blocktrans count count=var|length %}' - 'There is {{ count }} object. {% block a %} {% endblock %}' - '{% endblocktrans %}' - )}) - def test_plural_bad_syntax(self): - msg = "'blocktrans' doesn't allow other block tags inside it" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template', {'var': [1, 2, 3]}) - - -class TranslationBlockTransTagTests(SimpleTestCase): - - @override_settings(LOCALE_PATHS=extended_locale_paths) - def test_template_tags_pgettext(self): - """{% blocktrans %} takes message contexts into account (#14806).""" - trans_real._active = Local() - trans_real._translations = {} - with translation.override('de'): - # Nonexistent context - t = Template('{% load i18n %}{% blocktrans context "nonexistent" %}May{% endblocktrans %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'May') - - # Existing context... using a literal - t = Template('{% load i18n %}{% blocktrans context "month name" %}May{% endblocktrans %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% blocktrans context "verb" %}May{% endblocktrans %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Kann') - - # Using a variable - t = Template('{% load i18n %}{% blocktrans context message_context %}May{% endblocktrans %}') - rendered = t.render(Context({'message_context': 'month name'})) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% blocktrans context message_context %}May{% endblocktrans %}') - rendered = t.render(Context({'message_context': 'verb'})) - self.assertEqual(rendered, 'Kann') - - # Using a filter - t = Template('{% load i18n %}{% blocktrans context message_context|lower %}May{% endblocktrans %}') - rendered = t.render(Context({'message_context': 'MONTH NAME'})) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% blocktrans context message_context|lower %}May{% endblocktrans %}') - rendered = t.render(Context({'message_context': 'VERB'})) - self.assertEqual(rendered, 'Kann') - - # Using 'count' - t = Template( - '{% load i18n %}{% blocktrans count number=1 context "super search" %}' - '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, '1 Super-Ergebnis') - t = Template( - '{% load i18n %}{% blocktrans count number=2 context "super search" %}{{ number }}' - ' super result{% plural %}{{ number }} super results{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, '2 Super-Ergebnisse') - t = Template( - '{% load i18n %}{% blocktrans context "other super search" count number=1 %}' - '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, '1 anderen Super-Ergebnis') - t = Template( - '{% load i18n %}{% blocktrans context "other super search" count number=2 %}' - '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, '2 andere Super-Ergebnisse') - - # Using 'with' - t = Template( - '{% load i18n %}{% blocktrans with num_comments=5 context "comment count" %}' - 'There are {{ num_comments }} comments{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, 'Es gibt 5 Kommentare') - t = Template( - '{% load i18n %}{% blocktrans with num_comments=5 context "other comment count" %}' - 'There are {{ num_comments }} comments{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, 'Andere: Es gibt 5 Kommentare') - - # Using trimmed - t = Template( - '{% load i18n %}{% blocktrans trimmed %}\n\nThere\n\t are 5 ' - '\n\n comments\n{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, 'There are 5 comments') - t = Template( - '{% load i18n %}{% blocktrans with num_comments=5 context "comment count" trimmed %}\n\n' - 'There are \t\n \t {{ num_comments }} comments\n\n{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, 'Es gibt 5 Kommentare') - t = Template( - '{% load i18n %}{% blocktrans context "other super search" count number=2 trimmed %}\n' - '{{ number }} super \n result{% plural %}{{ number }} super results{% endblocktrans %}' - ) - rendered = t.render(Context()) - self.assertEqual(rendered, '2 andere Super-Ergebnisse') - - # Misuses - msg = "Unknown argument for 'blocktrans' tag: %r." - with self.assertRaisesMessage(TemplateSyntaxError, msg % 'month="May"'): - Template('{% load i18n %}{% blocktrans context with month="May" %}{{ month }}{% endblocktrans %}') - msg = '"context" in %r tag expected exactly one argument.' % 'blocktrans' - with self.assertRaisesMessage(TemplateSyntaxError, msg): - Template('{% load i18n %}{% blocktrans context %}{% endblocktrans %}') - with self.assertRaisesMessage(TemplateSyntaxError, msg): - Template( - '{% load i18n %}{% blocktrans count number=2 context %}' - '{{ number }} super result{% plural %}{{ number }}' - ' super results{% endblocktrans %}' - ) - - @override_settings(LOCALE_PATHS=[os.path.join(here, 'other', 'locale')]) - def test_bad_placeholder_1(self): - """ - Error in translation file should not crash template rendering (#16516). - (%(person)s is translated as %(personne)s in fr.po). - """ - with translation.override('fr'): - t = Template('{% load i18n %}{% blocktrans %}My name is {{ person }}.{% endblocktrans %}') - rendered = t.render(Context({'person': 'James'})) - self.assertEqual(rendered, 'My name is James.') - - @override_settings(LOCALE_PATHS=[os.path.join(here, 'other', 'locale')]) - def test_bad_placeholder_2(self): - """ - Error in translation file should not crash template rendering (#18393). - (%(person) misses a 's' in fr.po, causing the string formatting to fail) - . - """ - with translation.override('fr'): - t = Template('{% load i18n %}{% blocktrans %}My other name is {{ person }}.{% endblocktrans %}') - rendered = t.render(Context({'person': 'James'})) - self.assertEqual(rendered, 'My other name is James.') - - -class MultipleLocaleActivationBlockTransTests(MultipleLocaleActivationTestCase): - - def test_single_locale_activation(self): - """ - Simple baseline behavior with one locale for all the supported i18n - constructs. - """ - with translation.override('fr'): - self.assertEqual( - Template("{% load i18n %}{% blocktrans %}Yes{% endblocktrans %}").render(Context({})), - 'Oui' - ) - - def test_multiple_locale_btrans(self): - with translation.override('de'): - t = Template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") - with translation.override(self._old_language), translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - def test_multiple_locale_deactivate_btrans(self): - with translation.override('de', deactivate=True): - t = Template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") - with translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - def test_multiple_locale_direct_switch_btrans(self): - with translation.override('de'): - t = Template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") - with translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - -class MiscTests(SimpleTestCase): - - @override_settings(LOCALE_PATHS=extended_locale_paths) - def test_percent_in_translatable_block(self): - t_sing = Template("{% load i18n %}{% blocktrans %}The result was {{ percent }}%{% endblocktrans %}") - t_plur = Template( - "{% load i18n %}{% blocktrans count num as number %}" - "{{ percent }}% represents {{ num }} object{% plural %}" - "{{ percent }}% represents {{ num }} objects{% endblocktrans %}" - ) - with translation.override('de'): - self.assertEqual(t_sing.render(Context({'percent': 42})), 'Das Ergebnis war 42%') - self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 1})), '42% stellt 1 Objekt dar') - self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 4})), '42% stellt 4 Objekte dar') - - @override_settings(LOCALE_PATHS=extended_locale_paths) - def test_percent_formatting_in_blocktrans(self): - """ - Python's %-formatting is properly escaped in blocktrans, singular, or - plural. - """ - t_sing = Template("{% load i18n %}{% blocktrans %}There are %(num_comments)s comments{% endblocktrans %}") - t_plur = Template( - "{% load i18n %}{% blocktrans count num as number %}" - "%(percent)s% represents {{ num }} object{% plural %}" - "%(percent)s% represents {{ num }} objects{% endblocktrans %}" - ) - with translation.override('de'): - # Strings won't get translated as they don't match after escaping % - self.assertEqual(t_sing.render(Context({'num_comments': 42})), 'There are %(num_comments)s comments') - self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 1})), '%(percent)s% represents 1 object') - self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 4})), '%(percent)s% represents 4 objects') diff --git a/tests/template_tests/syntax_tests/i18n/test_blocktranslate.py b/tests/template_tests/syntax_tests/i18n/test_blocktranslate.py new file mode 100644 index 0000000000..11bd456ea8 --- /dev/null +++ b/tests/template_tests/syntax_tests/i18n/test_blocktranslate.py @@ -0,0 +1,562 @@ +import inspect +import os +from functools import partial, wraps + +from asgiref.local import Local + +from django.template import Context, Template, TemplateSyntaxError +from django.test import SimpleTestCase, override_settings +from django.utils import translation +from django.utils.safestring import mark_safe +from django.utils.translation import trans_real + +from ...utils import setup as base_setup +from .base import MultipleLocaleActivationTestCase, extended_locale_paths, here + + +def setup(templates, *args, **kwargs): + blocktrans_setup = base_setup(templates, *args, **kwargs) + blocktranslate_setup = base_setup({ + name: template.replace( + '{% blocktrans ', '{% blocktranslate ' + ).replace( + '{% endblocktrans %}', '{% endblocktranslate %}' + ) + for name, template in templates.items() + }) + + tags = { + 'blocktrans': blocktrans_setup, + 'blocktranslate': blocktranslate_setup, + } + + def decorator(func): + @wraps(func) + def inner(self, *args): + signature = inspect.signature(func) + for tag_name, setup_func in tags.items(): + if 'tag_name' in signature.parameters: + setup_func(partial(func, tag_name=tag_name))(self) + else: + setup_func(func)(self) + return inner + return decorator + + +class I18nBlockTransTagTests(SimpleTestCase): + libraries = {'i18n': 'django.templatetags.i18n'} + + @setup({'i18n03': '{% load i18n %}{% blocktrans %}{{ anton }}{% endblocktrans %}'}) + def test_i18n03(self): + """simple translation of a variable""" + output = self.engine.render_to_string('i18n03', {'anton': 'Å'}) + self.assertEqual(output, 'Å') + + @setup({'i18n04': '{% load i18n %}{% blocktrans with berta=anton|lower %}{{ berta }}{% endblocktrans %}'}) + def test_i18n04(self): + """simple translation of a variable and filter""" + output = self.engine.render_to_string('i18n04', {'anton': 'Å'}) + self.assertEqual(output, 'å') + + @setup({'legacyi18n04': '{% load i18n %}' + '{% blocktrans with anton|lower as berta %}{{ berta }}{% endblocktrans %}'}) + def test_legacyi18n04(self): + """simple translation of a variable and filter""" + output = self.engine.render_to_string('legacyi18n04', {'anton': 'Å'}) + self.assertEqual(output, 'å') + + @setup({'i18n05': '{% load i18n %}{% blocktrans %}xxx{{ anton }}xxx{% endblocktrans %}'}) + def test_i18n05(self): + """simple translation of a string with interpolation""" + output = self.engine.render_to_string('i18n05', {'anton': 'yyy'}) + self.assertEqual(output, 'xxxyyyxxx') + + @setup({'i18n07': '{% load i18n %}' + '{% blocktrans count counter=number %}singular{% plural %}' + '{{ counter }} plural{% endblocktrans %}'}) + def test_i18n07(self): + """translation of singular form""" + output = self.engine.render_to_string('i18n07', {'number': 1}) + self.assertEqual(output, 'singular') + + @setup({'legacyi18n07': '{% load i18n %}' + '{% blocktrans count number as counter %}singular{% plural %}' + '{{ counter }} plural{% endblocktrans %}'}) + def test_legacyi18n07(self): + """translation of singular form""" + output = self.engine.render_to_string('legacyi18n07', {'number': 1}) + self.assertEqual(output, 'singular') + + @setup({'i18n08': '{% load i18n %}' + '{% blocktrans count number as counter %}singular{% plural %}' + '{{ counter }} plural{% endblocktrans %}'}) + def test_i18n08(self): + """translation of plural form""" + output = self.engine.render_to_string('i18n08', {'number': 2}) + self.assertEqual(output, '2 plural') + + @setup({'legacyi18n08': '{% load i18n %}' + '{% blocktrans count counter=number %}singular{% plural %}' + '{{ counter }} plural{% endblocktrans %}'}) + def test_legacyi18n08(self): + """translation of plural form""" + output = self.engine.render_to_string('legacyi18n08', {'number': 2}) + self.assertEqual(output, '2 plural') + + @setup({'i18n17': '{% load i18n %}' + '{% blocktrans with berta=anton|escape %}{{ berta }}{% endblocktrans %}'}) + def test_i18n17(self): + """ + Escaping inside blocktranslate and translate works as if it was + directly in the template. + """ + output = self.engine.render_to_string('i18n17', {'anton': 'α & β'}) + self.assertEqual(output, 'α & β') + + @setup({'i18n18': '{% load i18n %}' + '{% blocktrans with berta=anton|force_escape %}{{ berta }}{% endblocktrans %}'}) + def test_i18n18(self): + output = self.engine.render_to_string('i18n18', {'anton': 'α & β'}) + self.assertEqual(output, 'α & β') + + @setup({'i18n19': '{% load i18n %}{% blocktrans %}{{ andrew }}{% endblocktrans %}'}) + def test_i18n19(self): + output = self.engine.render_to_string('i18n19', {'andrew': 'a & b'}) + self.assertEqual(output, 'a & b') + + @setup({'i18n21': '{% load i18n %}{% blocktrans %}{{ andrew }}{% endblocktrans %}'}) + def test_i18n21(self): + output = self.engine.render_to_string('i18n21', {'andrew': mark_safe('a & b')}) + self.assertEqual(output, 'a & b') + + @setup({'legacyi18n17': '{% load i18n %}' + '{% blocktrans with anton|escape as berta %}{{ berta }}{% endblocktrans %}'}) + def test_legacyi18n17(self): + output = self.engine.render_to_string('legacyi18n17', {'anton': 'α & β'}) + self.assertEqual(output, 'α & β') + + @setup({'legacyi18n18': '{% load i18n %}' + '{% blocktrans with anton|force_escape as berta %}' + '{{ berta }}{% endblocktrans %}'}) + def test_legacyi18n18(self): + output = self.engine.render_to_string('legacyi18n18', {'anton': 'α & β'}) + self.assertEqual(output, 'α & β') + + @setup({'i18n26': '{% load i18n %}' + '{% blocktrans with extra_field=myextra_field count counter=number %}' + 'singular {{ extra_field }}{% plural %}plural{% endblocktrans %}'}) + def test_i18n26(self): + """ + translation of plural form with extra field in singular form (#13568) + """ + output = self.engine.render_to_string('i18n26', {'myextra_field': 'test', 'number': 1}) + self.assertEqual(output, 'singular test') + + @setup({'legacyi18n26': '{% load i18n %}' + '{% blocktrans with myextra_field as extra_field count number as counter %}' + 'singular {{ extra_field }}{% plural %}plural{% endblocktrans %}'}) + def test_legacyi18n26(self): + output = self.engine.render_to_string('legacyi18n26', {'myextra_field': 'test', 'number': 1}) + self.assertEqual(output, 'singular test') + + @setup({'i18n27': '{% load i18n %}{% blocktrans count counter=number %}' + '{{ counter }} result{% plural %}{{ counter }} results' + '{% endblocktrans %}'}) + def test_i18n27(self): + """translation of singular form in Russian (#14126)""" + with translation.override('ru'): + output = self.engine.render_to_string('i18n27', {'number': 1}) + self.assertEqual(output, '1 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442') + + @setup({'legacyi18n27': '{% load i18n %}' + '{% blocktrans count number as counter %}{{ counter }} result' + '{% plural %}{{ counter }} results{% endblocktrans %}'}) + def test_legacyi18n27(self): + with translation.override('ru'): + output = self.engine.render_to_string('legacyi18n27', {'number': 1}) + self.assertEqual(output, '1 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442') + + @setup({'i18n28': '{% load i18n %}' + '{% blocktrans with a=anton b=berta %}{{ a }} + {{ b }}{% endblocktrans %}'}) + def test_i18n28(self): + """simple translation of multiple variables""" + output = self.engine.render_to_string('i18n28', {'anton': 'α', 'berta': 'β'}) + self.assertEqual(output, 'α + β') + + @setup({'legacyi18n28': '{% load i18n %}' + '{% blocktrans with anton as a and berta as b %}' + '{{ a }} + {{ b }}{% endblocktrans %}'}) + def test_legacyi18n28(self): + output = self.engine.render_to_string('legacyi18n28', {'anton': 'α', 'berta': 'β'}) + self.assertEqual(output, 'α + β') + + # blocktrans handling of variables which are not in the context. + # this should work as if blocktrans was not there (#19915) + @setup({'i18n34': '{% load i18n %}{% blocktrans %}{{ missing }}{% endblocktrans %}'}) + def test_i18n34(self): + output = self.engine.render_to_string('i18n34') + if self.engine.string_if_invalid: + self.assertEqual(output, 'INVALID') + else: + self.assertEqual(output, '') + + @setup({'i18n34_2': '{% load i18n %}{% blocktrans with a=\'α\' %}{{ missing }}{% endblocktrans %}'}) + def test_i18n34_2(self): + output = self.engine.render_to_string('i18n34_2') + if self.engine.string_if_invalid: + self.assertEqual(output, 'INVALID') + else: + self.assertEqual(output, '') + + @setup({'i18n34_3': '{% load i18n %}{% blocktrans with a=anton %}{{ missing }}{% endblocktrans %}'}) + def test_i18n34_3(self): + output = self.engine.render_to_string( + 'i18n34_3', {'anton': '\xce\xb1'}) + if self.engine.string_if_invalid: + self.assertEqual(output, 'INVALID') + else: + self.assertEqual(output, '') + + @setup({'i18n37': '{% load i18n %}' + '{% trans "Page not found" as page_not_found %}' + '{% blocktrans %}Error: {{ page_not_found }}{% endblocktrans %}'}) + def test_i18n37(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n37') + self.assertEqual(output, 'Error: Seite nicht gefunden') + + # blocktrans tag with asvar + @setup({'i18n39': '{% load i18n %}' + '{% blocktrans asvar page_not_found %}Page not found{% endblocktrans %}' + '>{{ page_not_found }}<'}) + def test_i18n39(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n39') + self.assertEqual(output, '>Seite nicht gefunden<') + + @setup({'i18n40': '{% load i18n %}' + '{% trans "Page not found" as pg_404 %}' + '{% blocktrans with page_not_found=pg_404 asvar output %}' + 'Error: {{ page_not_found }}' + '{% endblocktrans %}'}) + def test_i18n40(self): + output = self.engine.render_to_string('i18n40') + self.assertEqual(output, '') + + @setup({'i18n41': '{% load i18n %}' + '{% trans "Page not found" as pg_404 %}' + '{% blocktrans with page_not_found=pg_404 asvar output %}' + 'Error: {{ page_not_found }}' + '{% endblocktrans %}' + '>{{ output }}<'}) + def test_i18n41(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n41') + self.assertEqual(output, '>Error: Seite nicht gefunden<') + + @setup({'template': '{% load i18n %}{% blocktrans asvar %}Yes{% endblocktrans %}'}) + def test_blocktrans_syntax_error_missing_assignment(self, tag_name): + msg = "No argument provided to the '{}' tag for the asvar option.".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% blocktrans %}%s{% endblocktrans %}'}) + def test_blocktrans_tag_using_a_string_that_looks_like_str_fmt(self): + output = self.engine.render_to_string('template') + self.assertEqual(output, '%s') + + @setup({'template': '{% load i18n %}{% blocktrans %}{% block b %} {% endblock %}{% endblocktrans %}'}) + def test_with_block(self, tag_name): + msg = "'{}' doesn't allow other block tags (seen 'block b') inside it".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% blocktrans %}{% for b in [1, 2, 3] %} {% endfor %}{% endblocktrans %}'}) + def test_with_for(self, tag_name): + msg = "'{}' doesn't allow other block tags (seen 'for b in [1, 2, 3]') inside it".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% blocktrans with foo=bar with %}{{ foo }}{% endblocktrans %}'}) + def test_variable_twice(self): + with self.assertRaisesMessage(TemplateSyntaxError, "The 'with' option was specified more than once"): + self.engine.render_to_string('template', {'foo': 'bar'}) + + @setup({'template': '{% load i18n %}{% blocktrans with %}{% endblocktrans %}'}) + def test_no_args_with(self, tag_name): + msg = '"with" in \'{}\' tag needs at least one keyword argument.'.format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% blocktrans count a %}{% endblocktrans %}'}) + def test_count(self, tag_name): + msg = '"count" in \'{}\' tag expected exactly one keyword argument.'.format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template', {'a': [1, 2, 3]}) + + @setup({'template': ( + '{% load i18n %}{% blocktrans count count=var|length %}' + 'There is {{ count }} object. {% block a %} {% endblock %}' + '{% endblocktrans %}' + )}) + def test_plural_bad_syntax(self, tag_name): + msg = "'{}' doesn't allow other block tags inside it".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template', {'var': [1, 2, 3]}) + + +class TranslationBlockTransTagTests(SimpleTestCase): + tag_name = 'blocktrans' + + def get_template(self, template_string): + return Template( + template_string.replace( + '{{% blocktrans ', + '{{% {}'.format(self.tag_name) + ).replace( + '{{% endblocktrans %}}', + '{{% end{} %}}'.format(self.tag_name) + ) + ) + + @override_settings(LOCALE_PATHS=extended_locale_paths) + def test_template_tags_pgettext(self): + """{% blocktrans %} takes message contexts into account (#14806).""" + trans_real._active = Local() + trans_real._translations = {} + with translation.override('de'): + # Nonexistent context + t = self.get_template('{% load i18n %}{% blocktrans context "nonexistent" %}May{% endblocktrans %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'May') + + # Existing context... using a literal + t = self.get_template('{% load i18n %}{% blocktrans context "month name" %}May{% endblocktrans %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Mai') + t = self.get_template('{% load i18n %}{% blocktrans context "verb" %}May{% endblocktrans %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Kann') + + # Using a variable + t = self.get_template('{% load i18n %}{% blocktrans context message_context %}May{% endblocktrans %}') + rendered = t.render(Context({'message_context': 'month name'})) + self.assertEqual(rendered, 'Mai') + t = self.get_template('{% load i18n %}{% blocktrans context message_context %}May{% endblocktrans %}') + rendered = t.render(Context({'message_context': 'verb'})) + self.assertEqual(rendered, 'Kann') + + # Using a filter + t = self.get_template( + '{% load i18n %}{% blocktrans context message_context|lower %}May{% endblocktrans %}' + ) + rendered = t.render(Context({'message_context': 'MONTH NAME'})) + self.assertEqual(rendered, 'Mai') + t = self.get_template( + '{% load i18n %}{% blocktrans context message_context|lower %}May{% endblocktrans %}' + ) + rendered = t.render(Context({'message_context': 'VERB'})) + self.assertEqual(rendered, 'Kann') + + # Using 'count' + t = self.get_template( + '{% load i18n %}{% blocktrans count number=1 context "super search" %}' + '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, '1 Super-Ergebnis') + t = self.get_template( + '{% load i18n %}{% blocktrans count number=2 context "super search" %}{{ number }}' + ' super result{% plural %}{{ number }} super results{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, '2 Super-Ergebnisse') + t = self.get_template( + '{% load i18n %}{% blocktrans context "other super search" count number=1 %}' + '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, '1 anderen Super-Ergebnis') + t = self.get_template( + '{% load i18n %}{% blocktrans context "other super search" count number=2 %}' + '{{ number }} super result{% plural %}{{ number }} super results{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, '2 andere Super-Ergebnisse') + + # Using 'with' + t = self.get_template( + '{% load i18n %}{% blocktrans with num_comments=5 context "comment count" %}' + 'There are {{ num_comments }} comments{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, 'Es gibt 5 Kommentare') + t = self.get_template( + '{% load i18n %}{% blocktrans with num_comments=5 context "other comment count" %}' + 'There are {{ num_comments }} comments{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, 'Andere: Es gibt 5 Kommentare') + + # Using trimmed + t = self.get_template( + '{% load i18n %}{% blocktrans trimmed %}\n\nThere\n\t are 5 ' + '\n\n comments\n{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, 'There are 5 comments') + t = self.get_template( + '{% load i18n %}{% blocktrans with num_comments=5 context "comment count" trimmed %}\n\n' + 'There are \t\n \t {{ num_comments }} comments\n\n{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, 'Es gibt 5 Kommentare') + t = self.get_template( + '{% load i18n %}{% blocktrans context "other super search" count number=2 trimmed %}\n' + '{{ number }} super \n result{% plural %}{{ number }} super results{% endblocktrans %}' + ) + rendered = t.render(Context()) + self.assertEqual(rendered, '2 andere Super-Ergebnisse') + + # Misuses + msg = "Unknown argument for 'blocktrans' tag: %r." + with self.assertRaisesMessage(TemplateSyntaxError, msg % 'month="May"'): + self.get_template( + '{% load i18n %}{% blocktrans context with month="May" %}{{ month }}{% endblocktrans %}' + ) + msg = '"context" in %r tag expected exactly one argument.' % 'blocktrans' + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.get_template('{% load i18n %}{% blocktrans context %}{% endblocktrans %}') + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.get_template( + '{% load i18n %}{% blocktrans count number=2 context %}' + '{{ number }} super result{% plural %}{{ number }}' + ' super results{% endblocktrans %}' + ) + + @override_settings(LOCALE_PATHS=[os.path.join(here, 'other', 'locale')]) + def test_bad_placeholder_1(self): + """ + Error in translation file should not crash template rendering (#16516). + (%(person)s is translated as %(personne)s in fr.po). + """ + with translation.override('fr'): + t = Template('{% load i18n %}{% blocktrans %}My name is {{ person }}.{% endblocktrans %}') + rendered = t.render(Context({'person': 'James'})) + self.assertEqual(rendered, 'My name is James.') + + @override_settings(LOCALE_PATHS=[os.path.join(here, 'other', 'locale')]) + def test_bad_placeholder_2(self): + """ + Error in translation file should not crash template rendering (#18393). + (%(person) misses a 's' in fr.po, causing the string formatting to fail) + . + """ + with translation.override('fr'): + t = Template('{% load i18n %}{% blocktrans %}My other name is {{ person }}.{% endblocktrans %}') + rendered = t.render(Context({'person': 'James'})) + self.assertEqual(rendered, 'My other name is James.') + + +class TranslationBlockTranslationTagTests(TranslationBlockTransTagTests): + tag_name = 'blocktranslation' + + +class MultipleLocaleActivationBlockTransTests(MultipleLocaleActivationTestCase): + tag_name = 'blocktrans' + + def get_template(self, template_string): + return Template( + template_string.replace( + '{{% blocktrans ', + '{{% {}'.format(self.tag_name) + ).replace( + '{{% endblocktrans %}}', + '{{% end{} %}}'.format(self.tag_name) + ) + ) + + def test_single_locale_activation(self): + """ + Simple baseline behavior with one locale for all the supported i18n + constructs. + """ + with translation.override('fr'): + self.assertEqual( + self.get_template("{% load i18n %}{% blocktrans %}Yes{% endblocktrans %}").render(Context({})), + 'Oui' + ) + + def test_multiple_locale_btrans(self): + with translation.override('de'): + t = self.get_template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") + with translation.override(self._old_language), translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + def test_multiple_locale_deactivate_btrans(self): + with translation.override('de', deactivate=True): + t = self.get_template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") + with translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + def test_multiple_locale_direct_switch_btrans(self): + with translation.override('de'): + t = self.get_template("{% load i18n %}{% blocktrans %}No{% endblocktrans %}") + with translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + +class MultipleLocaleActivationBlockTranslationTests(MultipleLocaleActivationBlockTransTests): + tag_name = 'blocktranslation' + + +class MiscTests(SimpleTestCase): + tag_name = 'blocktranslate' + + def get_template(self, template_string): + return Template( + template_string.replace( + '{{% blocktrans ', + '{{% {}'.format(self.tag_name) + ).replace( + '{{% endblocktrans %}}', + '{{% end{} %}}'.format(self.tag_name) + ) + ) + + @override_settings(LOCALE_PATHS=extended_locale_paths) + def test_percent_in_translatable_block(self): + t_sing = self.get_template("{% load i18n %}{% blocktrans %}The result was {{ percent }}%{% endblocktrans %}") + t_plur = self.get_template( + "{% load i18n %}{% blocktrans count num as number %}" + "{{ percent }}% represents {{ num }} object{% plural %}" + "{{ percent }}% represents {{ num }} objects{% endblocktrans %}" + ) + with translation.override('de'): + self.assertEqual(t_sing.render(Context({'percent': 42})), 'Das Ergebnis war 42%') + self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 1})), '42% stellt 1 Objekt dar') + self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 4})), '42% stellt 4 Objekte dar') + + @override_settings(LOCALE_PATHS=extended_locale_paths) + def test_percent_formatting_in_blocktranslate(self): + """ + Python's %-formatting is properly escaped in blocktranslate, singular, + or plural. + """ + t_sing = self.get_template( + "{% load i18n %}{% blocktrans %}There are %(num_comments)s comments{% endblocktrans %}" + ) + t_plur = self.get_template( + "{% load i18n %}{% blocktrans count num as number %}" + "%(percent)s% represents {{ num }} object{% plural %}" + "%(percent)s% represents {{ num }} objects{% endblocktrans %}" + ) + with translation.override('de'): + # Strings won't get translated as they don't match after escaping % + self.assertEqual(t_sing.render(Context({'num_comments': 42})), 'There are %(num_comments)s comments') + self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 1})), '%(percent)s% represents 1 object') + self.assertEqual(t_plur.render(Context({'percent': 42, 'num': 4})), '%(percent)s% represents 4 objects') + + +class MiscBlockTranslationTests(MiscTests): + tag_name = 'blocktrans' diff --git a/tests/template_tests/syntax_tests/i18n/test_trans.py b/tests/template_tests/syntax_tests/i18n/test_trans.py deleted file mode 100644 index 47a79ff74d..0000000000 --- a/tests/template_tests/syntax_tests/i18n/test_trans.py +++ /dev/null @@ -1,212 +0,0 @@ -from asgiref.local import Local - -from django.template import Context, Template, TemplateSyntaxError -from django.templatetags.l10n import LocalizeNode -from django.test import SimpleTestCase, override_settings -from django.utils import translation -from django.utils.safestring import mark_safe -from django.utils.translation import trans_real - -from ...utils import setup -from .base import MultipleLocaleActivationTestCase, extended_locale_paths - - -class I18nTransTagTests(SimpleTestCase): - libraries = {'i18n': 'django.templatetags.i18n'} - - @setup({'i18n01': '{% load i18n %}{% trans \'xxxyyyxxx\' %}'}) - def test_i18n01(self): - """simple translation of a string delimited by '.""" - output = self.engine.render_to_string('i18n01') - self.assertEqual(output, 'xxxyyyxxx') - - @setup({'i18n02': '{% load i18n %}{% trans "xxxyyyxxx" %}'}) - def test_i18n02(self): - """simple translation of a string delimited by ".""" - output = self.engine.render_to_string('i18n02') - self.assertEqual(output, 'xxxyyyxxx') - - @setup({'i18n06': '{% load i18n %}{% trans "Page not found" %}'}) - def test_i18n06(self): - """simple translation of a string to German""" - with translation.override('de'): - output = self.engine.render_to_string('i18n06') - self.assertEqual(output, 'Seite nicht gefunden') - - @setup({'i18n09': '{% load i18n %}{% trans "Page not found" noop %}'}) - def test_i18n09(self): - """simple non-translation (only marking) of a string to German""" - with translation.override('de'): - output = self.engine.render_to_string('i18n09') - self.assertEqual(output, 'Page not found') - - @setup({'i18n20': '{% load i18n %}{% trans andrew %}'}) - def test_i18n20(self): - output = self.engine.render_to_string('i18n20', {'andrew': 'a & b'}) - self.assertEqual(output, 'a & b') - - @setup({'i18n22': '{% load i18n %}{% trans andrew %}'}) - def test_i18n22(self): - output = self.engine.render_to_string('i18n22', {'andrew': mark_safe('a & b')}) - self.assertEqual(output, 'a & b') - - @setup({'i18n23': '{% load i18n %}{% trans "Page not found"|capfirst|slice:"6:" %}'}) - def test_i18n23(self): - """Using filters with the {% trans %} tag (#5972).""" - with translation.override('de'): - output = self.engine.render_to_string('i18n23') - self.assertEqual(output, 'nicht gefunden') - - @setup({'i18n24': '{% load i18n %}{% trans \'Page not found\'|upper %}'}) - def test_i18n24(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n24') - self.assertEqual(output, 'SEITE NICHT GEFUNDEN') - - @setup({'i18n25': '{% load i18n %}{% trans somevar|upper %}'}) - def test_i18n25(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n25', {'somevar': 'Page not found'}) - self.assertEqual(output, 'SEITE NICHT GEFUNDEN') - - # trans tag with as var - @setup({'i18n35': '{% load i18n %}{% trans "Page not found" as page_not_found %}{{ page_not_found }}'}) - def test_i18n35(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n35') - self.assertEqual(output, 'Seite nicht gefunden') - - @setup({'i18n36': '{% load i18n %}' - '{% trans "Page not found" noop as page_not_found %}{{ page_not_found }}'}) - def test_i18n36(self): - with translation.override('de'): - output = self.engine.render_to_string('i18n36') - self.assertEqual(output, 'Page not found') - - @setup({'template': '{% load i18n %}{% trans %}A}'}) - def test_syntax_error_no_arguments(self): - msg = "'trans' takes at least one argument" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" badoption %}'}) - def test_syntax_error_bad_option(self): - msg = "Unknown argument for 'trans' tag: 'badoption'" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" as %}'}) - def test_syntax_error_missing_assignment(self): - msg = "No argument provided to the 'trans' tag for the as option." - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" as var context %}'}) - def test_syntax_error_missing_context(self): - msg = "No argument provided to the 'trans' tag for the context option." - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" context as var %}'}) - def test_syntax_error_context_as(self): - msg = "Invalid argument 'as' provided to the 'trans' tag for the context option" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" context noop %}'}) - def test_syntax_error_context_noop(self): - msg = "Invalid argument 'noop' provided to the 'trans' tag for the context option" - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "Yes" noop noop %}'}) - def test_syntax_error_duplicate_option(self): - msg = "The 'noop' option was specified more than once." - with self.assertRaisesMessage(TemplateSyntaxError, msg): - self.engine.render_to_string('template') - - @setup({'template': '{% load i18n %}{% trans "%s" %}'}) - def test_trans_tag_using_a_string_that_looks_like_str_fmt(self): - output = self.engine.render_to_string('template') - self.assertEqual(output, '%s') - - -class TranslationTransTagTests(SimpleTestCase): - - @override_settings(LOCALE_PATHS=extended_locale_paths) - def test_template_tags_pgettext(self): - """{% trans %} takes message contexts into account (#14806).""" - trans_real._active = Local() - trans_real._translations = {} - with translation.override('de'): - # Nonexistent context... - t = Template('{% load i18n %}{% trans "May" context "nonexistent" %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'May') - - # Existing context... using a literal - t = Template('{% load i18n %}{% trans "May" context "month name" %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% trans "May" context "verb" %}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Kann') - - # Using a variable - t = Template('{% load i18n %}{% trans "May" context message_context %}') - rendered = t.render(Context({'message_context': 'month name'})) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% trans "May" context message_context %}') - rendered = t.render(Context({'message_context': 'verb'})) - self.assertEqual(rendered, 'Kann') - - # Using a filter - t = Template('{% load i18n %}{% trans "May" context message_context|lower %}') - rendered = t.render(Context({'message_context': 'MONTH NAME'})) - self.assertEqual(rendered, 'Mai') - t = Template('{% load i18n %}{% trans "May" context message_context|lower %}') - rendered = t.render(Context({'message_context': 'VERB'})) - self.assertEqual(rendered, 'Kann') - - # Using 'as' - t = Template('{% load i18n %}{% trans "May" context "month name" as var %}Value: {{ var }}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Value: Mai') - t = Template('{% load i18n %}{% trans "May" as var context "verb" %}Value: {{ var }}') - rendered = t.render(Context()) - self.assertEqual(rendered, 'Value: Kann') - - -class MultipleLocaleActivationTransTagTests(MultipleLocaleActivationTestCase): - - def test_single_locale_activation(self): - """ - Simple baseline behavior with one locale for all the supported i18n - constructs. - """ - with translation.override('fr'): - self.assertEqual(Template("{% load i18n %}{% trans 'Yes' %}").render(Context({})), 'Oui') - - def test_multiple_locale_trans(self): - with translation.override('de'): - t = Template("{% load i18n %}{% trans 'No' %}") - with translation.override(self._old_language), translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - def test_multiple_locale_deactivate_trans(self): - with translation.override('de', deactivate=True): - t = Template("{% load i18n %}{% trans 'No' %}") - with translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - def test_multiple_locale_direct_switch_trans(self): - with translation.override('de'): - t = Template("{% load i18n %}{% trans 'No' %}") - with translation.override('nl'): - self.assertEqual(t.render(Context({})), 'Nee') - - -class LocalizeNodeTests(SimpleTestCase): - def test_repr(self): - node = LocalizeNode(nodelist=[], use_l10n=True) - self.assertEqual(repr(node), '') diff --git a/tests/template_tests/syntax_tests/i18n/test_translate.py b/tests/template_tests/syntax_tests/i18n/test_translate.py new file mode 100644 index 0000000000..6011153a2d --- /dev/null +++ b/tests/template_tests/syntax_tests/i18n/test_translate.py @@ -0,0 +1,269 @@ +import inspect +from functools import partial, wraps + +from asgiref.local import Local + +from django.template import Context, Template, TemplateSyntaxError +from django.templatetags.l10n import LocalizeNode +from django.test import SimpleTestCase, override_settings +from django.utils import translation +from django.utils.safestring import mark_safe +from django.utils.translation import trans_real + +from ...utils import setup as base_setup +from .base import MultipleLocaleActivationTestCase, extended_locale_paths + + +def setup(templates, *args, **kwargs): + trans_setup = base_setup(templates, *args, **kwargs) + translate_setup = base_setup({ + name: template.replace('{% trans ', '{% translate ') + for name, template in templates.items() + }) + + tags = { + 'trans': trans_setup, + 'translate': translate_setup, + } + + def decorator(func): + @wraps(func) + def inner(self, *args): + signature = inspect.signature(func) + for tag_name, setup_func in tags.items(): + if 'tag_name' in signature.parameters: + setup_func(partial(func, tag_name=tag_name))(self) + else: + setup_func(func)(self) + return inner + return decorator + + +class I18nTransTagTests(SimpleTestCase): + libraries = {'i18n': 'django.templatetags.i18n'} + + @setup({'i18n01': '{% load i18n %}{% trans \'xxxyyyxxx\' %}'}) + def test_i18n01(self): + """simple translation of a string delimited by '.""" + output = self.engine.render_to_string('i18n01') + self.assertEqual(output, 'xxxyyyxxx') + + @setup({'i18n02': '{% load i18n %}{% trans "xxxyyyxxx" %}'}) + def test_i18n02(self): + """simple translation of a string delimited by ".""" + output = self.engine.render_to_string('i18n02') + self.assertEqual(output, 'xxxyyyxxx') + + @setup({'i18n06': '{% load i18n %}{% trans "Page not found" %}'}) + def test_i18n06(self): + """simple translation of a string to German""" + with translation.override('de'): + output = self.engine.render_to_string('i18n06') + self.assertEqual(output, 'Seite nicht gefunden') + + @setup({'i18n09': '{% load i18n %}{% trans "Page not found" noop %}'}) + def test_i18n09(self): + """simple non-translation (only marking) of a string to German""" + with translation.override('de'): + output = self.engine.render_to_string('i18n09') + self.assertEqual(output, 'Page not found') + + @setup({'i18n20': '{% load i18n %}{% trans andrew %}'}) + def test_i18n20(self): + output = self.engine.render_to_string('i18n20', {'andrew': 'a & b'}) + self.assertEqual(output, 'a & b') + + @setup({'i18n22': '{% load i18n %}{% trans andrew %}'}) + def test_i18n22(self): + output = self.engine.render_to_string('i18n22', {'andrew': mark_safe('a & b')}) + self.assertEqual(output, 'a & b') + + @setup({'i18n23': '{% load i18n %}{% trans "Page not found"|capfirst|slice:"6:" %}'}) + def test_i18n23(self): + """Using filters with the {% trans %} tag (#5972).""" + with translation.override('de'): + output = self.engine.render_to_string('i18n23') + self.assertEqual(output, 'nicht gefunden') + + @setup({'i18n24': '{% load i18n %}{% trans \'Page not found\'|upper %}'}) + def test_i18n24(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n24') + self.assertEqual(output, 'SEITE NICHT GEFUNDEN') + + @setup({'i18n25': '{% load i18n %}{% trans somevar|upper %}'}) + def test_i18n25(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n25', {'somevar': 'Page not found'}) + self.assertEqual(output, 'SEITE NICHT GEFUNDEN') + + # trans tag with as var + @setup({'i18n35': '{% load i18n %}{% trans "Page not found" as page_not_found %}{{ page_not_found }}'}) + def test_i18n35(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n35') + self.assertEqual(output, 'Seite nicht gefunden') + + @setup({'i18n36': '{% load i18n %}' + '{% trans "Page not found" noop as page_not_found %}{{ page_not_found }}'}) + def test_i18n36(self): + with translation.override('de'): + output = self.engine.render_to_string('i18n36') + self.assertEqual(output, 'Page not found') + + @setup({'template': '{% load i18n %}{% trans %}A}'}) + def test_syntax_error_no_arguments(self, tag_name): + msg = "'{}' takes at least one argument".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" badoption %}'}) + def test_syntax_error_bad_option(self, tag_name): + msg = "Unknown argument for '{}' tag: 'badoption'".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" as %}'}) + def test_syntax_error_missing_assignment(self, tag_name): + msg = "No argument provided to the '{}' tag for the as option.".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" as var context %}'}) + def test_syntax_error_missing_context(self, tag_name): + msg = "No argument provided to the '{}' tag for the context option.".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" context as var %}'}) + def test_syntax_error_context_as(self, tag_name): + msg = "Invalid argument 'as' provided to the '{}' tag for the context option".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" context noop %}'}) + def test_syntax_error_context_noop(self, tag_name): + msg = "Invalid argument 'noop' provided to the '{}' tag for the context option".format(tag_name) + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "Yes" noop noop %}'}) + def test_syntax_error_duplicate_option(self): + msg = "The 'noop' option was specified more than once." + with self.assertRaisesMessage(TemplateSyntaxError, msg): + self.engine.render_to_string('template') + + @setup({'template': '{% load i18n %}{% trans "%s" %}'}) + def test_trans_tag_using_a_string_that_looks_like_str_fmt(self): + output = self.engine.render_to_string('template') + self.assertEqual(output, '%s') + + +class TranslationTransTagTests(SimpleTestCase): + tag_name = 'trans' + + def get_template(self, template_string): + return Template( + template_string.replace( + '{{% trans ', + '{{% {}'.format(self.tag_name) + ) + ) + + @override_settings(LOCALE_PATHS=extended_locale_paths) + def test_template_tags_pgettext(self): + """{% trans %} takes message contexts into account (#14806).""" + trans_real._active = Local() + trans_real._translations = {} + with translation.override('de'): + # Nonexistent context... + t = self.get_template('{% load i18n %}{% trans "May" context "nonexistent" %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'May') + + # Existing context... using a literal + t = self.get_template('{% load i18n %}{% trans "May" context "month name" %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Mai') + t = self.get_template('{% load i18n %}{% trans "May" context "verb" %}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Kann') + + # Using a variable + t = self.get_template('{% load i18n %}{% trans "May" context message_context %}') + rendered = t.render(Context({'message_context': 'month name'})) + self.assertEqual(rendered, 'Mai') + t = self.get_template('{% load i18n %}{% trans "May" context message_context %}') + rendered = t.render(Context({'message_context': 'verb'})) + self.assertEqual(rendered, 'Kann') + + # Using a filter + t = self.get_template('{% load i18n %}{% trans "May" context message_context|lower %}') + rendered = t.render(Context({'message_context': 'MONTH NAME'})) + self.assertEqual(rendered, 'Mai') + t = self.get_template('{% load i18n %}{% trans "May" context message_context|lower %}') + rendered = t.render(Context({'message_context': 'VERB'})) + self.assertEqual(rendered, 'Kann') + + # Using 'as' + t = self.get_template('{% load i18n %}{% trans "May" context "month name" as var %}Value: {{ var }}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Value: Mai') + t = self.get_template('{% load i18n %}{% trans "May" as var context "verb" %}Value: {{ var }}') + rendered = t.render(Context()) + self.assertEqual(rendered, 'Value: Kann') + + +class TranslationTranslateTagTests(TranslationTransTagTests): + tag_name = 'translate' + + +class MultipleLocaleActivationTransTagTests(MultipleLocaleActivationTestCase): + tag_name = 'trans' + + def get_template(self, template_string): + return Template( + template_string.replace( + '{{% trans ', + '{{% {}'.format(self.tag_name) + ) + ) + + def test_single_locale_activation(self): + """ + Simple baseline behavior with one locale for all the supported i18n + constructs. + """ + with translation.override('fr'): + self.assertEqual( + self.get_template("{% load i18n %}{% trans 'Yes' %}").render(Context({})), + 'Oui' + ) + + def test_multiple_locale_trans(self): + with translation.override('de'): + t = self.get_template("{% load i18n %}{% trans 'No' %}") + with translation.override(self._old_language), translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + def test_multiple_locale_deactivate_trans(self): + with translation.override('de', deactivate=True): + t = self.get_template("{% load i18n %}{% trans 'No' %}") + with translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + def test_multiple_locale_direct_switch_trans(self): + with translation.override('de'): + t = self.get_template("{% load i18n %}{% trans 'No' %}") + with translation.override('nl'): + self.assertEqual(t.render(Context({})), 'Nee') + + +class MultipleLocaleActivationTranslateTagTests(MultipleLocaleActivationTransTagTests): + tag_name = 'translate' + + +class LocalizeNodeTests(SimpleTestCase): + def test_repr(self): + node = LocalizeNode(nodelist=[], use_l10n=True) + self.assertEqual(repr(node), '') -- cgit v1.3