import os import sys from datetime import datetime from django.core.exceptions import SuspiciousOperation from django.core.serializers.json import DjangoJSONEncoder from django.test import SimpleTestCase from django.utils.deprecation import RemovedInDjango60Warning from django.utils.functional import lazystr from django.utils.html import ( conditional_escape, escape, escapejs, format_html, format_html_join, html_safe, json_script, linebreaks, smart_urlquote, strip_spaces_between_tags, strip_tags, urlize, ) from django.utils.safestring import mark_safe class TestUtilsHtml(SimpleTestCase): def check_output(self, function, value, output=None): """ function(value) equals output. If output is None, function(value) equals value. """ if output is None: output = value self.assertEqual(function(value), output) def test_escape(self): items = ( ("&", "&"), ("<", "<"), (">", ">"), ('"', """), ("'", "'"), ) # Substitution patterns for testing the above items. patterns = ("%s", "asdf%sfdsa", "%s1", "1%sb") for value, output in items: with self.subTest(value=value, output=output): for pattern in patterns: with self.subTest(value=value, output=output, pattern=pattern): self.check_output(escape, pattern % value, pattern % output) self.check_output( escape, lazystr(pattern % value), pattern % output ) # Check repeated values. self.check_output(escape, value * 2, output * 2) # Verify it doesn't double replace &. self.check_output(escape, "<&", "<&") def test_format_html(self): self.assertEqual( format_html( "{} {} {third} {fourth}", "< Dangerous >", mark_safe("safe"), third="< dangerous again", fourth=mark_safe("safe again"), ), "< Dangerous > safe < dangerous again safe again", ) def test_format_html_no_params(self): msg = "Calling format_html() without passing args or kwargs is deprecated." # RemovedInDjango60Warning: when the deprecation ends, replace with: # msg = "args or kwargs must be provided." # with self.assertRaisesMessage(TypeError, msg): with self.assertWarnsMessage(RemovedInDjango60Warning, msg) as ctx: name = "Adam" self.assertEqual(format_html(f"{name}"), "Adam") self.assertEqual(ctx.filename, __file__) def test_format_html_join_with_positional_arguments(self): self.assertEqual( format_html_join( "\n", "
para1
\n\npara2
\n\npara3
"), ( "para1\nsub1\rsub2\n\npara2", "para1
sub1
sub2
para2
", ), ( "para1\r\n\r\npara2\rsub1\r\rpara4", "para1
\n\npara2
sub1
para4
", ), ("para1\tmore\n\npara2", "para1\tmore
\n\npara2
"), ) for value, output in items: with self.subTest(value=value, output=output): self.check_output(linebreaks, value, output) self.check_output(linebreaks, lazystr(value), output) def test_strip_tags(self): # Python fixed a quadratic-time issue in HTMLParser in 3.13.6, 3.12.12, # 3.11.14, 3.10.19, and 3.9.24. The fix slightly changes HTMLParser's # output, so tests for particularly malformed input must handle both # old and new results. The check below is temporary until all supported # Python versions and CI workers include the fix. See: # https://github.com/python/cpython/commit/6eb6c5db min_fixed = { (3, 14): (3, 14), (3, 13): (3, 13, 6), (3, 12): (3, 12, 12), (3, 11): (3, 11, 14), (3, 10): (3, 10, 19), (3, 9): (3, 9, 24), } htmlparser_fixed = sys.version_info >= min_fixed[sys.version_info[:2]] items = ( ( "See: 'é is an apostrophe followed by e acute
", "See: 'é is an apostrophe followed by e acute", ), ( "See: 'é is an apostrophe followed by e acute
", "See: 'é is an apostrophe followed by e acute", ), ("')\">b
c", "abc"), ("ab
c", "abc"), ("dhello
\nworld
", "hello
world
"), ("\n\t
\n\n", "\n\n"), ) for value, output in items: with self.subTest(value=value, output=output): self.check_output(strip_spaces_between_tags, value, output) self.check_output(strip_spaces_between_tags, lazystr(value), output) def test_escapejs(self): items = ( ( "\"double quotes\" and 'single quotes'", "\\u0022double quotes\\u0022 and \\u0027single quotes\\u0027", ), (r"\ : backslashes, too", "\\u005C : backslashes, too"), ( "and lots of whitespace: \r\n\t\v\f\b", "and lots of whitespace: \\u000D\\u000A\\u0009\\u000B\\u000C\\u0008", ), ( r"", "\\u003Cscript\\u003Eand this\\u003C/script\\u003E", ), ( "paragraph separator:\u2029and line separator:\u2028", "paragraph separator:\\u2029and line separator:\\u2028", ), ("`", "\\u0060"), ) for value, output in items: with self.subTest(value=value, output=output): self.check_output(escapejs, value, output) self.check_output(escapejs, lazystr(value), output) def test_json_script(self): tests = ( # "<", ">" and "&" are quoted inside JSON strings ( ( "&<>", '', ) ), # "<", ">" and "&" are quoted inside JSON objects ( {"a": ""}, '", ), # Lazy strings are quoted ( lazystr("&<>"), '", ), ( {"a": lazystr("")}, '", ), ) for arg, expected in tests: with self.subTest(arg=arg): self.assertEqual(json_script(arg, "test_id"), expected) def test_json_script_custom_encoder(self): class CustomDjangoJSONEncoder(DjangoJSONEncoder): def encode(self, o): return '{"hello": "world"}' self.assertHTMLEqual( json_script({}, encoder=CustomDjangoJSONEncoder), '', ) def test_json_script_without_id(self): self.assertHTMLEqual( json_script({"key": "value"}), '', ) def test_smart_urlquote(self): items = ( # IDN is encoded as percent-encoded ("quoted") UTF-8 (#36013). ("http://öäü.com/", "http://%C3%B6%C3%A4%C3%BC.com/"), ("https://faß.example.com", "https://fa%C3%9F.example.com"), ( "http://öäü.com/öäü/", "http://%C3%B6%C3%A4%C3%BC.com/%C3%B6%C3%A4%C3%BC/", ), ( # Valid under IDNA 2008, but was invalid in IDNA 2003. "https://މިހާރު.com", "https://%DE%89%DE%A8%DE%80%DE%A7%DE%83%DE%AA.com", ), ( # Valid under WHATWG URL Specification but not IDNA 2008. "http://👓.ws", "http://%F0%9F%91%93.ws", ), # Pre-encoded IDNA is left unchanged. ("http://xn--iny-zx5a.com/idna2003", "http://xn--iny-zx5a.com/idna2003"), ("http://xn--fa-hia.com/idna2008", "http://xn--fa-hia.com/idna2008"), # Everything unsafe is quoted, !*'();:@&=+$,/?#[]~ is considered # safe as per RFC. ( "http://example.com/path/öäü/", "http://example.com/path/%C3%B6%C3%A4%C3%BC/", ), ("http://example.com/%C3%B6/ä/", "http://example.com/%C3%B6/%C3%A4/"), ("http://example.com/?x=1&y=2+3&z=", "http://example.com/?x=1&y=2+3&z="), ("http://example.com/?x=<>\"'", "http://example.com/?x=%3C%3E%22%27"), ( "http://example.com/?q=http://example.com/?x=1%26q=django", "http://example.com/?q=http%3A%2F%2Fexample.com%2F%3Fx%3D1%26q%3D" "django", ), ( "http://example.com/?q=http%3A%2F%2Fexample.com%2F%3Fx%3D1%26q%3D" "django", "http://example.com/?q=http%3A%2F%2Fexample.com%2F%3Fx%3D1%26q%3D" "django", ), ("http://.www.f oo.bar/", "http://.www.f%20oo.bar/"), ('http://example.com">', "http://example.com%22%3E"), ("http://10.22.1.1/", "http://10.22.1.1/"), ("http://[fd00::1]/", "http://[fd00::1]/"), ) for value, output in items: with self.subTest(value=value, output=output): self.assertEqual(smart_urlquote(value), output) def test_conditional_escape(self): s = "