diff options
author | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2021-01-14 10:14:57 +0100 |
---|---|---|
committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2021-01-14 17:50:04 +0100 |
commit | e7208f13c0448387e56c340eed46e1ed9ef9997e (patch) | |
tree | 93afdd52adc4d38a1e98c68d3f63f024384205d0 | |
parent | 2dd6a83d2d7c61321ac4a9b10fbf3c379cb305c3 (diff) | |
download | django-e7208f13c0448387e56c340eed46e1ed9ef9997e.tar.gz |
Refs #25236 -- Removed {% ifequal %} and {% ifnotequal %} template tags per deprecation timeline.
-rw-r--r-- | django/template/defaulttags.py | 77 | ||||
-rw-r--r-- | docs/ref/templates/builtins.txt | 9 | ||||
-rw-r--r-- | docs/releases/4.0.txt | 2 | ||||
-rw-r--r-- | tests/template_tests/syntax_tests/test_autoescape.py | 12 | ||||
-rw-r--r-- | tests/template_tests/syntax_tests/test_if_equal.py | 257 | ||||
-rw-r--r-- | tests/template_tests/test_nodelist.py | 9 |
6 files changed, 4 insertions, 362 deletions
diff --git a/django/template/defaulttags.py b/django/template/defaulttags.py index 4084189cf0..cb1f1e91f1 100644 --- a/django/template/defaulttags.py +++ b/django/template/defaulttags.py @@ -8,7 +8,6 @@ from itertools import cycle as itertools_cycle, groupby from django.conf import settings from django.utils import timezone -from django.utils.deprecation import RemovedInDjango40Warning from django.utils.html import conditional_escape, format_html from django.utils.lorem_ipsum import paragraphs, words from django.utils.safestring import mark_safe @@ -261,26 +260,6 @@ class IfChangedNode(Node): return context.render_context -class IfEqualNode(Node): - # RemovedInDjango40Warning. - child_nodelists = ('nodelist_true', 'nodelist_false') - - def __init__(self, var1, var2, nodelist_true, nodelist_false, negate): - self.var1, self.var2 = var1, var2 - self.nodelist_true, self.nodelist_false = nodelist_true, nodelist_false - self.negate = negate - - def __repr__(self): - return '<%s>' % self.__class__.__name__ - - def render(self, context): - val1 = self.var1.resolve(context, ignore_failures=True) - val2 = self.var2.resolve(context, ignore_failures=True) - if (self.negate and val1 != val2) or (not self.negate and val1 == val2): - return self.nodelist_true.render(context) - return self.nodelist_false.render(context) - - class IfNode(Node): def __init__(self, conditions_nodelists): @@ -821,62 +800,6 @@ def do_for(parser, token): return ForNode(loopvars, sequence, is_reversed, nodelist_loop, nodelist_empty) -def do_ifequal(parser, token, negate): - # RemovedInDjango40Warning. - bits = list(token.split_contents()) - if len(bits) != 3: - raise TemplateSyntaxError("%r takes two arguments" % bits[0]) - end_tag = 'end' + bits[0] - nodelist_true = parser.parse(('else', end_tag)) - token = parser.next_token() - if token.contents == 'else': - nodelist_false = parser.parse((end_tag,)) - parser.delete_first_token() - else: - nodelist_false = NodeList() - val1 = parser.compile_filter(bits[1]) - val2 = parser.compile_filter(bits[2]) - return IfEqualNode(val1, val2, nodelist_true, nodelist_false, negate) - - -@register.tag -def ifequal(parser, token): - """ - Output the contents of the block if the two arguments equal each other. - - Examples:: - - {% ifequal user.id comment.user_id %} - ... - {% endifequal %} - - {% ifnotequal user.id comment.user_id %} - ... - {% else %} - ... - {% endifnotequal %} - """ - warnings.warn( - 'The {% ifequal %} template tag is deprecated in favor of {% if %}.', - RemovedInDjango40Warning, - ) - return do_ifequal(parser, token, False) - - -@register.tag -def ifnotequal(parser, token): - """ - Output the contents of the block if the two arguments are not equal. - See ifequal. - """ - warnings.warn( - 'The {% ifnotequal %} template tag is deprecated in favor of ' - '{% if %}.', - RemovedInDjango40Warning, - ) - return do_ifequal(parser, token, True) - - class TemplateLiteral(Literal): def __init__(self, value, text): self.value = value diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index d431a9bc42..1dd554aa13 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -608,15 +608,6 @@ you should use:: {% if a > b and b > c %} -``ifequal`` and ``ifnotequal`` ------------------------------- - -.. deprecated:: 3.1 - -``{% ifequal a b %} ... {% endifequal %}`` is an obsolete way to write -``{% if a == b %} ... {% endif %}``. Likewise, ``{% ifnotequal a b %} ... -{% endifnotequal %}`` is superseded by ``{% if a != b %} ... {% endif %}``. - .. templatetag:: ifchanged ``ifchanged`` diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt index c8b3f0332f..0dd1a3d91a 100644 --- a/docs/releases/4.0.txt +++ b/docs/releases/4.0.txt @@ -321,3 +321,5 @@ to remove usage of these features. ``django.contrib.postgres.fields.jsonb.KeyTextTransform`` are removed. * ``django.contrib.postgres.forms.JSONField`` is removed. + +* The ``{% ifequal %}`` and ``{% ifnotequal %}`` template tags are removed. diff --git a/tests/template_tests/syntax_tests/test_autoescape.py b/tests/template_tests/syntax_tests/test_autoescape.py index 84af2baf5f..13968537a6 100644 --- a/tests/template_tests/syntax_tests/test_autoescape.py +++ b/tests/template_tests/syntax_tests/test_autoescape.py @@ -1,6 +1,5 @@ from django.template import TemplateSyntaxError -from django.test import SimpleTestCase, ignore_warnings -from django.utils.deprecation import RemovedInDjango40Warning +from django.test import SimpleTestCase from django.utils.safestring import mark_safe from ..utils import SafeClass, UnsafeClass, setup @@ -82,15 +81,6 @@ class AutoescapeTagTests(SimpleTestCase): with self.assertRaises(TemplateSyntaxError): self.engine.render_to_string('autoescape-filtertag01', {'first': '<a>'}) - @ignore_warnings(category=RemovedInDjango40Warning) - @setup({'autoescape-ifequal01': '{% ifequal var "this & that" %}yes{% endifequal %}'}) - def test_autoescape_ifequal01(self): - """ - ifequal compares unescaped vales. - """ - output = self.engine.render_to_string('autoescape-ifequal01', {'var': 'this & that'}) - self.assertEqual(output, 'yes') - # Arguments to filters are 'safe' and manipulate their input unescaped. @setup({'autoescape-filters01': '{{ var|cut:"&" }}'}) def test_autoescape_filters01(self): diff --git a/tests/template_tests/syntax_tests/test_if_equal.py b/tests/template_tests/syntax_tests/test_if_equal.py deleted file mode 100644 index 29ad00de8d..0000000000 --- a/tests/template_tests/syntax_tests/test_if_equal.py +++ /dev/null @@ -1,257 +0,0 @@ -from django.template import TemplateSyntaxError -from django.template.defaulttags import IfEqualNode -from django.test import SimpleTestCase, ignore_warnings -from django.utils.deprecation import RemovedInDjango40Warning - -from ..utils import setup - - -@ignore_warnings(category=RemovedInDjango40Warning) -class IfEqualTagTests(SimpleTestCase): - - @setup({'ifequal01': '{% ifequal a b %}yes{% endifequal %}'}) - def test_ifequal01(self): - output = self.engine.render_to_string('ifequal01', {'a': 1, 'b': 2}) - self.assertEqual(output, '') - - @setup({'ifequal02': '{% ifequal a b %}yes{% endifequal %}'}) - def test_ifequal02(self): - output = self.engine.render_to_string('ifequal02', {'a': 1, 'b': 1}) - self.assertEqual(output, 'yes') - - @setup({'ifequal03': '{% ifequal a b %}yes{% else %}no{% endifequal %}'}) - def test_ifequal03(self): - output = self.engine.render_to_string('ifequal03', {'a': 1, 'b': 2}) - self.assertEqual(output, 'no') - - @setup({'ifequal04': '{% ifequal a b %}yes{% else %}no{% endifequal %}'}) - def test_ifequal04(self): - output = self.engine.render_to_string('ifequal04', {'a': 1, 'b': 1}) - self.assertEqual(output, 'yes') - - @setup({'ifequal05': '{% ifequal a \'test\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal05(self): - output = self.engine.render_to_string('ifequal05', {'a': 'test'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal06': '{% ifequal a \'test\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal06(self): - output = self.engine.render_to_string('ifequal06', {'a': 'no'}) - self.assertEqual(output, 'no') - - @setup({'ifequal07': '{% ifequal a "test" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal07(self): - output = self.engine.render_to_string('ifequal07', {'a': 'test'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal08': '{% ifequal a "test" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal08(self): - output = self.engine.render_to_string('ifequal08', {'a': 'no'}) - self.assertEqual(output, 'no') - - @setup({'ifequal09': '{% ifequal a "test" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal09(self): - output = self.engine.render_to_string('ifequal09') - self.assertEqual(output, 'no') - - @setup({'ifequal10': '{% ifequal a b %}yes{% else %}no{% endifequal %}'}) - def test_ifequal10(self): - output = self.engine.render_to_string('ifequal10') - self.assertEqual(output, 'yes') - - # SMART SPLITTING - @setup({'ifequal-split01': '{% ifequal a "test man" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split01(self): - output = self.engine.render_to_string('ifequal-split01') - self.assertEqual(output, 'no') - - @setup({'ifequal-split02': '{% ifequal a "test man" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split02(self): - output = self.engine.render_to_string('ifequal-split02', {'a': 'foo'}) - self.assertEqual(output, 'no') - - @setup({'ifequal-split03': '{% ifequal a "test man" %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split03(self): - output = self.engine.render_to_string('ifequal-split03', {'a': 'test man'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-split04': '{% ifequal a \'test man\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split04(self): - output = self.engine.render_to_string('ifequal-split04', {'a': 'test man'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-split05': '{% ifequal a \'i "love" you\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split05(self): - output = self.engine.render_to_string('ifequal-split05', {'a': ''}) - self.assertEqual(output, 'no') - - @setup({'ifequal-split06': '{% ifequal a \'i "love" you\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split06(self): - output = self.engine.render_to_string('ifequal-split06', {'a': 'i "love" you'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-split07': '{% ifequal a \'i "love" you\' %}yes{% else %}no{% endifequal %}'}) - def test_ifequal_split07(self): - output = self.engine.render_to_string('ifequal-split07', {'a': 'i love you'}) - self.assertEqual(output, 'no') - - @setup({'ifequal-split08': r"{% ifequal a 'I\'m happy' %}yes{% else %}no{% endifequal %}"}) - def test_ifequal_split08(self): - output = self.engine.render_to_string('ifequal-split08', {'a': "I'm happy"}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-split09': r"{% ifequal a 'slash\man' %}yes{% else %}no{% endifequal %}"}) - def test_ifequal_split09(self): - output = self.engine.render_to_string('ifequal-split09', {'a': r'slash\man'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-split10': r"{% ifequal a 'slash\man' %}yes{% else %}no{% endifequal %}"}) - def test_ifequal_split10(self): - output = self.engine.render_to_string('ifequal-split10', {'a': 'slashman'}) - self.assertEqual(output, 'no') - - # NUMERIC RESOLUTION - @setup({'ifequal-numeric01': '{% ifequal x 5 %}yes{% endifequal %}'}) - def test_ifequal_numeric01(self): - output = self.engine.render_to_string('ifequal-numeric01', {'x': '5'}) - self.assertEqual(output, '') - - @setup({'ifequal-numeric02': '{% ifequal x 5 %}yes{% endifequal %}'}) - def test_ifequal_numeric02(self): - output = self.engine.render_to_string('ifequal-numeric02', {'x': 5}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric03': '{% ifequal x 5.2 %}yes{% endifequal %}'}) - def test_ifequal_numeric03(self): - output = self.engine.render_to_string('ifequal-numeric03', {'x': 5}) - self.assertEqual(output, '') - - @setup({'ifequal-numeric04': '{% ifequal x 5.2 %}yes{% endifequal %}'}) - def test_ifequal_numeric04(self): - output = self.engine.render_to_string('ifequal-numeric04', {'x': 5.2}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric05': '{% ifequal x 0.2 %}yes{% endifequal %}'}) - def test_ifequal_numeric05(self): - output = self.engine.render_to_string('ifequal-numeric05', {'x': 0.2}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric06': '{% ifequal x .2 %}yes{% endifequal %}'}) - def test_ifequal_numeric06(self): - output = self.engine.render_to_string('ifequal-numeric06', {'x': 0.2}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric07': '{% ifequal x 2. %}yes{% endifequal %}'}) - def test_ifequal_numeric07(self): - output = self.engine.render_to_string('ifequal-numeric07', {'x': 2}) - self.assertEqual(output, '') - - @setup({'ifequal-numeric08': '{% ifequal x "5" %}yes{% endifequal %}'}) - def test_ifequal_numeric08(self): - output = self.engine.render_to_string('ifequal-numeric08', {'x': 5}) - self.assertEqual(output, '') - - @setup({'ifequal-numeric09': '{% ifequal x "5" %}yes{% endifequal %}'}) - def test_ifequal_numeric09(self): - output = self.engine.render_to_string('ifequal-numeric09', {'x': '5'}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric10': '{% ifequal x -5 %}yes{% endifequal %}'}) - def test_ifequal_numeric10(self): - output = self.engine.render_to_string('ifequal-numeric10', {'x': -5}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric11': '{% ifequal x -5.2 %}yes{% endifequal %}'}) - def test_ifequal_numeric11(self): - output = self.engine.render_to_string('ifequal-numeric11', {'x': -5.2}) - self.assertEqual(output, 'yes') - - @setup({'ifequal-numeric12': '{% ifequal x +5 %}yes{% endifequal %}'}) - def test_ifequal_numeric12(self): - output = self.engine.render_to_string('ifequal-numeric12', {'x': 5}) - self.assertEqual(output, 'yes') - - # FILTER EXPRESSIONS AS ARGUMENTS - @setup({'ifequal-filter01': '{% ifequal a|upper "A" %}x{% endifequal %}'}) - def test_ifequal_filter01(self): - output = self.engine.render_to_string('ifequal-filter01', {'a': 'a'}) - self.assertEqual(output, 'x') - - @setup({'ifequal-filter02': '{% ifequal "A" a|upper %}x{% endifequal %}'}) - def test_ifequal_filter02(self): - output = self.engine.render_to_string('ifequal-filter02', {'a': 'a'}) - self.assertEqual(output, 'x') - - @setup({'ifequal-filter03': '{% ifequal a|upper b|upper %}x{% endifequal %}'}) - def test_ifequal_filter03(self): - output = self.engine.render_to_string('ifequal-filter03', {'a': 'x', 'b': 'X'}) - self.assertEqual(output, 'x') - - @setup({'ifequal-filter04': '{% ifequal x|slice:"1" "a" %}x{% endifequal %}'}) - def test_ifequal_filter04(self): - output = self.engine.render_to_string('ifequal-filter04', {'x': 'aaa'}) - self.assertEqual(output, 'x') - - @setup({'ifequal-filter05': '{% ifequal x|slice:"1"|upper "A" %}x{% endifequal %}'}) - def test_ifequal_filter05(self): - output = self.engine.render_to_string('ifequal-filter05', {'x': 'aaa'}) - self.assertEqual(output, 'x') - - -@ignore_warnings(category=RemovedInDjango40Warning) -class IfNotEqualTagTests(SimpleTestCase): - - @setup({'ifnotequal01': '{% ifnotequal a b %}yes{% endifnotequal %}'}) - def test_ifnotequal01(self): - output = self.engine.render_to_string('ifnotequal01', {'a': 1, 'b': 2}) - self.assertEqual(output, 'yes') - - @setup({'ifnotequal02': '{% ifnotequal a b %}yes{% endifnotequal %}'}) - def test_ifnotequal02(self): - output = self.engine.render_to_string('ifnotequal02', {'a': 1, 'b': 1}) - self.assertEqual(output, '') - - @setup({'ifnotequal03': '{% ifnotequal a b %}yes{% else %}no{% endifnotequal %}'}) - def test_ifnotequal03(self): - output = self.engine.render_to_string('ifnotequal03', {'a': 1, 'b': 2}) - self.assertEqual(output, 'yes') - - @setup({'ifnotequal04': '{% ifnotequal a b %}yes{% else %}no{% endifnotequal %}'}) - def test_ifnotequal04(self): - output = self.engine.render_to_string('ifnotequal04', {'a': 1, 'b': 1}) - self.assertEqual(output, 'no') - - @setup({'one_var': '{% ifnotequal a %}yes{% endifnotequal %}'}) - def test_one_var(self): - with self.assertRaisesMessage(TemplateSyntaxError, "'ifnotequal' takes two arguments"): - self.engine.render_to_string('one_var', {'a': 1}) - - -class DeprecationTests(SimpleTestCase): - @setup( - {'ifequal_warning': '{% ifequal a b %}yes{% endifequal %}'}, - test_once=True, - ) - def test_ifequal_warning(self): - msg = ( - 'The {% ifequal %} template tag is deprecated in favor of ' - '{% if %}.' - ) - with self.assertRaisesMessage(RemovedInDjango40Warning, msg): - self.engine.render_to_string('ifequal_warning', {'a': 1, 'b': 2}) - - @setup( - {'ifnotequal_warning': '{% ifnotequal a b %}yes{% endifnoequal %}'}, - test_once=True, - ) - def test_ifnotequal_warning(self): - msg = ( - 'The {% ifnotequal %} template tag is deprecated in favor of ' - '{% if %}.' - ) - with self.assertRaisesMessage(RemovedInDjango40Warning, msg): - self.engine.render_to_string('ifnotequal_warning', {'a': 1, 'b': 2}) - - def test_repr(self): - node = IfEqualNode(var1='a', var2='b', nodelist_true=[], nodelist_false=[], negate=False) - self.assertEqual(repr(node), '<IfEqualNode>') diff --git a/tests/template_tests/test_nodelist.py b/tests/template_tests/test_nodelist.py index b0e97b88da..03c0d99651 100644 --- a/tests/template_tests/test_nodelist.py +++ b/tests/template_tests/test_nodelist.py @@ -1,7 +1,6 @@ from django.template import Context, Engine from django.template.base import TextNode, VariableNode -from django.test import SimpleTestCase, ignore_warnings -from django.utils.deprecation import RemovedInDjango40Warning +from django.test import SimpleTestCase class NodelistTest(SimpleTestCase): @@ -21,12 +20,6 @@ class NodelistTest(SimpleTestCase): vars = template.nodelist.get_nodes_by_type(VariableNode) self.assertEqual(len(vars), 1) - @ignore_warnings(category=RemovedInDjango40Warning) - def test_ifequal(self): - template = self.engine.from_string('{% ifequal x y %}{{ a }}{% endifequal %}') - vars = template.nodelist.get_nodes_by_type(VariableNode) - self.assertEqual(len(vars), 1) - def test_ifchanged(self): template = self.engine.from_string('{% ifchanged x %}{{ a }}{% endifchanged %}') vars = template.nodelist.get_nodes_by_type(VariableNode) |