summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2021-01-14 10:14:57 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2021-01-14 17:50:04 +0100
commite7208f13c0448387e56c340eed46e1ed9ef9997e (patch)
tree93afdd52adc4d38a1e98c68d3f63f024384205d0
parent2dd6a83d2d7c61321ac4a9b10fbf3c379cb305c3 (diff)
downloaddjango-e7208f13c0448387e56c340eed46e1ed9ef9997e.tar.gz
Refs #25236 -- Removed {% ifequal %} and {% ifnotequal %} template tags per deprecation timeline.
-rw-r--r--django/template/defaulttags.py77
-rw-r--r--docs/ref/templates/builtins.txt9
-rw-r--r--docs/releases/4.0.txt2
-rw-r--r--tests/template_tests/syntax_tests/test_autoescape.py12
-rw-r--r--tests/template_tests/syntax_tests/test_if_equal.py257
-rw-r--r--tests/template_tests/test_nodelist.py9
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)