blob: 9d60dd8aefebb5773dbea86dc7993c8fb5a4e58f [file] [log] [blame]
Fred Drakebd3090d2001-05-18 15:32:59 +00001"""Tests for HTMLParser.py."""
2
3import HTMLParser
Fred Drake029acfb2001-08-20 21:24:19 +00004import pprint
Fred Drakebd3090d2001-05-18 15:32:59 +00005import sys
6import test_support
7import unittest
8
9
10class EventCollector(HTMLParser.HTMLParser):
11
12 def __init__(self):
13 self.events = []
14 self.append = self.events.append
15 HTMLParser.HTMLParser.__init__(self)
16
17 def get_events(self):
18 # Normalize the list of events so that buffer artefacts don't
19 # separate runs of contiguous characters.
20 L = []
21 prevtype = None
22 for event in self.events:
23 type = event[0]
24 if type == prevtype == "data":
25 L[-1] = ("data", L[-1][1] + event[1])
26 else:
27 L.append(event)
28 prevtype = type
29 self.events = L
30 return L
31
32 # structure markup
33
34 def handle_starttag(self, tag, attrs):
35 self.append(("starttag", tag, attrs))
36
37 def handle_startendtag(self, tag, attrs):
38 self.append(("startendtag", tag, attrs))
39
40 def handle_endtag(self, tag):
41 self.append(("endtag", tag))
42
43 # all other markup
44
45 def handle_comment(self, data):
46 self.append(("comment", data))
47
48 def handle_charref(self, data):
49 self.append(("charref", data))
50
51 def handle_data(self, data):
52 self.append(("data", data))
53
54 def handle_decl(self, data):
55 self.append(("decl", data))
56
57 def handle_entityref(self, data):
58 self.append(("entityref", data))
59
60 def handle_pi(self, data):
61 self.append(("pi", data))
62
Fred Drakec20a6982001-09-04 15:13:04 +000063 def unknown_decl(self, decl):
64 self.append(("unknown decl", decl))
65
Fred Drakebd3090d2001-05-18 15:32:59 +000066
67class EventCollectorExtra(EventCollector):
68
69 def handle_starttag(self, tag, attrs):
70 EventCollector.handle_starttag(self, tag, attrs)
71 self.append(("starttag_text", self.get_starttag_text()))
72
73
74class TestCaseBase(unittest.TestCase):
75
Fred Drakec20a6982001-09-04 15:13:04 +000076 def _run_check(self, source, expected_events, collector=EventCollector):
Fred Drakebd3090d2001-05-18 15:32:59 +000077 parser = collector()
Fred Drakebd3090d2001-05-18 15:32:59 +000078 for s in source:
79 parser.feed(s)
Fred Drakebd3090d2001-05-18 15:32:59 +000080 parser.close()
Fred Drake029acfb2001-08-20 21:24:19 +000081 events = parser.get_events()
Fred Drakec20a6982001-09-04 15:13:04 +000082 if events != expected_events:
83 self.fail("received events did not match expected events\n"
84 "Expected:\n" + pprint.pformat(expected_events) +
85 "\nReceived:\n" + pprint.pformat(events))
Fred Drakebd3090d2001-05-18 15:32:59 +000086
87 def _run_check_extra(self, source, events):
88 self._run_check(source, events, EventCollectorExtra)
89
90 def _parse_error(self, source):
91 def parse(source=source):
92 parser = HTMLParser.HTMLParser()
93 parser.feed(source)
94 parser.close()
95 self.assertRaises(HTMLParser.HTMLParseError, parse)
96
97
98class HTMLParserTestCase(TestCaseBase):
99
Fred Drake84bb9d82001-08-03 19:53:01 +0000100 def test_processing_instruction_only(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000101 self._run_check("<?processing instruction>", [
102 ("pi", "processing instruction"),
103 ])
104
Fred Drake84bb9d82001-08-03 19:53:01 +0000105 def test_simple_html(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000106 self._run_check("""
107<!DOCTYPE html PUBLIC 'foo'>
108<HTML>&entity;&#32;
109<!--comment1a
110-></foo><bar>&lt;<?pi?></foo<bar
111comment1b-->
112<Img sRc='Bar' isMAP>sample
113text
Fred Drake84bb9d82001-08-03 19:53:01 +0000114&#x201C;
Fred Drakebd3090d2001-05-18 15:32:59 +0000115<!--comment2a-- --comment2b-->
116</Html>
117""", [
118 ("data", "\n"),
119 ("decl", "DOCTYPE html PUBLIC 'foo'"),
120 ("data", "\n"),
121 ("starttag", "html", []),
122 ("entityref", "entity"),
123 ("charref", "32"),
124 ("data", "\n"),
125 ("comment", "comment1a\n-></foo><bar>&lt;<?pi?></foo<bar\ncomment1b"),
126 ("data", "\n"),
127 ("starttag", "img", [("src", "Bar"), ("ismap", None)]),
128 ("data", "sample\ntext\n"),
Fred Drake84bb9d82001-08-03 19:53:01 +0000129 ("charref", "x201C"),
130 ("data", "\n"),
Fred Drakebd3090d2001-05-18 15:32:59 +0000131 ("comment", "comment2a-- --comment2b"),
132 ("data", "\n"),
133 ("endtag", "html"),
134 ("data", "\n"),
135 ])
136
Fred Drake073148c2001-12-03 16:44:09 +0000137 def test_unclosed_entityref(self):
138 self._run_check("&entityref foo", [
139 ("entityref", "entityref"),
140 ("data", " foo"),
141 ])
142
Fred Drake029acfb2001-08-20 21:24:19 +0000143 def test_doctype_decl(self):
144 inside = """\
145DOCTYPE html [
146 <!ELEMENT html - O EMPTY>
147 <!ATTLIST html
Fred Drakec20a6982001-09-04 15:13:04 +0000148 version CDATA #IMPLIED
149 profile CDATA 'DublinCore'>
150 <!NOTATION datatype SYSTEM 'http://xml.python.org/notations/python-module'>
151 <!ENTITY myEntity 'internal parsed entity'>
152 <!ENTITY anEntity SYSTEM 'http://xml.python.org/entities/something.xml'>
153 <!ENTITY % paramEntity 'name|name|name'>
154 %paramEntity;
Fred Drake029acfb2001-08-20 21:24:19 +0000155 <!-- comment -->
156]"""
157 self._run_check("<!%s>" % inside, [
158 ("decl", inside),
159 ])
160
Fred Drake84bb9d82001-08-03 19:53:01 +0000161 def test_bad_nesting(self):
162 # Strangely, this *is* supposed to test that overlapping
163 # elements are allowed. HTMLParser is more geared toward
164 # lexing the input that parsing the structure.
Fred Drakebd3090d2001-05-18 15:32:59 +0000165 self._run_check("<a><b></a></b>", [
166 ("starttag", "a", []),
167 ("starttag", "b", []),
168 ("endtag", "a"),
169 ("endtag", "b"),
170 ])
171
Fred Drake029acfb2001-08-20 21:24:19 +0000172 def test_bare_ampersands(self):
173 self._run_check("this text & contains & ampersands &", [
174 ("data", "this text & contains & ampersands &"),
175 ])
176
177 def test_bare_pointy_brackets(self):
178 self._run_check("this < text > contains < bare>pointy< brackets", [
179 ("data", "this < text > contains < bare>pointy< brackets"),
180 ])
181
Fred Drake84bb9d82001-08-03 19:53:01 +0000182 def test_attr_syntax(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000183 output = [
184 ("starttag", "a", [("b", "v"), ("c", "v"), ("d", "v"), ("e", None)])
185 ]
186 self._run_check("""<a b='v' c="v" d=v e>""", output)
187 self._run_check("""<a b = 'v' c = "v" d = v e>""", output)
188 self._run_check("""<a\nb\n=\n'v'\nc\n=\n"v"\nd\n=\nv\ne>""", output)
189 self._run_check("""<a\tb\t=\t'v'\tc\t=\t"v"\td\t=\tv\te>""", output)
190
Fred Drake84bb9d82001-08-03 19:53:01 +0000191 def test_attr_values(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000192 self._run_check("""<a b='xxx\n\txxx' c="yyy\t\nyyy" d='\txyz\n'>""",
193 [("starttag", "a", [("b", "xxx\n\txxx"),
194 ("c", "yyy\t\nyyy"),
195 ("d", "\txyz\n")])
196 ])
197 self._run_check("""<a b='' c="">""", [
198 ("starttag", "a", [("b", ""), ("c", "")]),
199 ])
200
Fred Drake84bb9d82001-08-03 19:53:01 +0000201 def test_attr_entity_replacement(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000202 self._run_check("""<a b='&amp;&gt;&lt;&quot;&apos;'>""", [
203 ("starttag", "a", [("b", "&><\"'")]),
204 ])
205
Fred Drake84bb9d82001-08-03 19:53:01 +0000206 def test_attr_funky_names(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000207 self._run_check("""<a a.b='v' c:d=v e-f=v>""", [
208 ("starttag", "a", [("a.b", "v"), ("c:d", "v"), ("e-f", "v")]),
209 ])
210
Fred Drakec20a6982001-09-04 15:13:04 +0000211 def test_illegal_declarations(self):
Fred Drake7cf613d2001-09-04 16:26:03 +0000212 self._parse_error('<!spacer type="block" height="25">')
Fred Drakec20a6982001-09-04 15:13:04 +0000213
Fred Drake84bb9d82001-08-03 19:53:01 +0000214 def test_starttag_end_boundary(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000215 self._run_check("""<a b='<'>""", [("starttag", "a", [("b", "<")])])
216 self._run_check("""<a b='>'>""", [("starttag", "a", [("b", ">")])])
217
Fred Drake84bb9d82001-08-03 19:53:01 +0000218 def test_buffer_artefacts(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000219 output = [("starttag", "a", [("b", "<")])]
220 self._run_check(["<a b='<'>"], output)
221 self._run_check(["<a ", "b='<'>"], output)
222 self._run_check(["<a b", "='<'>"], output)
223 self._run_check(["<a b=", "'<'>"], output)
224 self._run_check(["<a b='<", "'>"], output)
225 self._run_check(["<a b='<'", ">"], output)
226
227 output = [("starttag", "a", [("b", ">")])]
228 self._run_check(["<a b='>'>"], output)
229 self._run_check(["<a ", "b='>'>"], output)
230 self._run_check(["<a b", "='>'>"], output)
231 self._run_check(["<a b=", "'>'>"], output)
232 self._run_check(["<a b='>", "'>"], output)
233 self._run_check(["<a b='>'", ">"], output)
234
Fred Drake84bb9d82001-08-03 19:53:01 +0000235 def test_starttag_junk_chars(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000236 self._parse_error("</>")
237 self._parse_error("</$>")
238 self._parse_error("</")
239 self._parse_error("</a")
Fred Drakebd3090d2001-05-18 15:32:59 +0000240 self._parse_error("<a<a>")
241 self._parse_error("</a<a>")
Fred Drakebd3090d2001-05-18 15:32:59 +0000242 self._parse_error("<!")
243 self._parse_error("<a $>")
244 self._parse_error("<a")
245 self._parse_error("<a foo='bar'")
246 self._parse_error("<a foo='bar")
247 self._parse_error("<a foo='>'")
248 self._parse_error("<a foo='>")
249 self._parse_error("<a foo=>")
250
Fred Drake84bb9d82001-08-03 19:53:01 +0000251 def test_declaration_junk_chars(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000252 self._parse_error("<!DOCTYPE foo $ >")
253
Fred Drake84bb9d82001-08-03 19:53:01 +0000254 def test_startendtag(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000255 self._run_check("<p/>", [
256 ("startendtag", "p", []),
257 ])
258 self._run_check("<p></p>", [
259 ("starttag", "p", []),
260 ("endtag", "p"),
261 ])
262 self._run_check("<p><img src='foo' /></p>", [
263 ("starttag", "p", []),
264 ("startendtag", "img", [("src", "foo")]),
265 ("endtag", "p"),
266 ])
267
Fred Drake84bb9d82001-08-03 19:53:01 +0000268 def test_get_starttag_text(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000269 s = """<foo:bar \n one="1"\ttwo=2 >"""
270 self._run_check_extra(s, [
271 ("starttag", "foo:bar", [("one", "1"), ("two", "2")]),
272 ("starttag_text", s)])
273
Fred Drake84bb9d82001-08-03 19:53:01 +0000274 def test_cdata_content(self):
Fred Drakebd3090d2001-05-18 15:32:59 +0000275 s = """<script> <!-- not a comment --> &not-an-entity-ref; </script>"""
276 self._run_check(s, [
277 ("starttag", "script", []),
278 ("data", " <!-- not a comment --> &not-an-entity-ref; "),
279 ("endtag", "script"),
280 ])
281 s = """<script> <not a='start tag'> </script>"""
282 self._run_check(s, [
283 ("starttag", "script", []),
284 ("data", " <not a='start tag'> "),
285 ("endtag", "script"),
286 ])
287
288
Fred Drakee8220492001-09-24 20:19:08 +0000289def test_main():
290 test_support.run_unittest(HTMLParserTestCase)
291
292
293if __name__ == "__main__":
294 test_main()