Mercurial > cpython-lru_cache-weakref
annotate Doc/lib/libhtmlparser.tex @ 25838:8540887bcec6 2.2
Backport of 2.183:
Fix memory leak in add_subclass() found by NealN with valgrind.
| author | Guido van Rossum <guido@python.org> |
|---|---|
| date | Fri, 18 Oct 2002 13:42:21 +0000 |
| parents | 7de5c376232c |
| children | ee6df2c668ea |
| rev | line source |
|---|---|
|
18005
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
1 \section{\module{HTMLParser} --- |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
2 Simple HTML and XHTML parser} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
3 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
4 \declaremodule{standard}{HTMLParser} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
5 \modulesynopsis{A simple parser that can handle HTML and XHTML.} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
6 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
7 This module defines a class \class{HTMLParser} which serves as the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
8 basis for parsing text files formatted in HTML\index{HTML} (HyperText |
|
18396
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
9 Mark-up Language) and XHTML.\index{XHTML} Unlike the parser in |
|
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
10 \refmodule{htmllib}, this parser is not based on the SGML parser in |
|
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
11 \refmodule{sgmllib}. |
|
18005
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
12 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
13 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
14 \begin{classdesc}{HTMLParser}{} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
15 The \class{HTMLParser} class is instantiated without arguments. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
16 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
17 An HTMLParser instance is fed HTML data and calls handler functions |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
18 when tags begin and end. The \class{HTMLParser} class is meant to be |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
19 overridden by the user to provide a desired behavior. |
|
18396
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
20 |
|
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
21 Unlike the parser in \refmodule{htmllib}, this parser does not check |
|
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
22 that end tags match start tags or call the end-tag handler for |
|
7de5c376232c
Added more information on the differences between the htmllib and HTMLParser
Fred Drake <fdrake@acm.org>
parents:
18005
diff
changeset
|
23 elements which are closed implicitly by closing an outer element. |
|
18005
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
24 \end{classdesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
25 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
26 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
27 \class{HTMLParser} instances have the following methods: |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
28 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
29 \begin{methoddesc}{reset}{} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
30 Reset the instance. Loses all unprocessed data. This is called |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
31 implicitly at instantiation time. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
32 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
33 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
34 \begin{methoddesc}{feed}{data} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
35 Feed some text to the parser. It is processed insofar as it consists |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
36 of complete elements; incomplete data is buffered until more data is |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
37 fed or \method{close()} is called. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
38 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
39 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
40 \begin{methoddesc}{close}{} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
41 Force processing of all buffered data as if it were followed by an |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
42 end-of-file mark. This method may be redefined by a derived class to |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
43 define additional processing at the end of the input, but the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
44 redefined version should always call the \class{HTMLParser} base class |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
45 method \method{close()}. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
46 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
47 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
48 \begin{methoddesc}{getpos}{} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
49 Return current line number and offset. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
50 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
51 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
52 \begin{methoddesc}{get_starttag_text}{} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
53 Return the text of the most recently opened start tag. This should |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
54 not normally be needed for structured processing, but may be useful in |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
55 dealing with HTML ``as deployed'' or for re-generating input with |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
56 minimal changes (whitespace between attributes can be preserved, |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
57 etc.). |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
58 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
59 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
60 \begin{methoddesc}{handle_starttag}{tag, attrs} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
61 This method is called to handle the start of a tag. It is intended to |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
62 be overridden by a derived class; the base class implementation does |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
63 nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
64 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
65 The \var{tag} argument is the name of the tag converted to |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
66 lower case. The \var{attrs} argument is a list of \code{(\var{name}, |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
67 \var{value})} pairs containing the attributes found inside the tag's |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
68 \code{<>} brackets. The \var{name} will be translated to lower case |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
69 and double quotes and backslashes in the \var{value} have been |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
70 interpreted. For instance, for the tag \code{<A |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
71 HREF="http://www.cwi.nl/">}, this method would be called as |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
72 \samp{handle_starttag('a', [('href', 'http://www.cwi.nl/')])}. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
73 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
74 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
75 \begin{methoddesc}{handle_startendtag}{tag, attrs} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
76 Similar to \method{handle_starttag()}, but called when the parser |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
77 encounters an XHTML-style empty tag (\code{<a .../>}). This method |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
78 may be overridden by subclasses which require this particular lexical |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
79 information; the default implementation simple calls |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
80 \method{handle_starttag()} and \method{handle_endtag()}. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
81 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
82 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
83 \begin{methoddesc}{handle_endtag}{tag} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
84 This method is called to handle the end tag of an element. It is |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
85 intended to be overridden by a derived class; the base class |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
86 implementation does nothing. The \var{tag} argument is the name of |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
87 the tag converted to lower case. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
88 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
89 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
90 \begin{methoddesc}{handle_data}{data} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
91 This method is called to process arbitrary data. It is intended to be |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
92 overridden by a derived class; the base class implementation does |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
93 nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
94 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
95 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
96 \begin{methoddesc}{handle_charref}{name} This method is called to |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
97 process a character reference of the form \samp{\&\#\var{ref};}. It |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
98 is intended to be overridden by a derived class; the base class |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
99 implementation does nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
100 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
101 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
102 \begin{methoddesc}{handle_entityref}{name} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
103 This method is called to process a general entity reference of the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
104 form \samp{\&\var{name};} where \var{name} is an general entity |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
105 reference. It is intended to be overridden by a derived class; the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
106 base class implementation does nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
107 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
108 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
109 \begin{methoddesc}{handle_comment}{data} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
110 This method is called when a comment is encountered. The |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
111 \var{comment} argument is a string containing the text between the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
112 \samp{<!--} and \samp{-->} delimiters, but not the delimiters |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
113 themselves. For example, the comment \samp{<!--text-->} will cause |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
114 this method to be called with the argument \code{'text'}. It is |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
115 intended to be overridden by a derived class; the base class |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
116 implementation does nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
117 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
118 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
119 \begin{methoddesc}{handle_decl}{decl} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
120 Method called when an SGML declaration is read by the parser. The |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
121 \var{decl} parameter will be the entire contents of the declaration |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
122 inside the \code{<!}...\code{>} markup.It is intended to be overridden |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
123 by a derived class; the base class implementation does nothing. |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
124 \end{methoddesc} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
125 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
126 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
127 \subsection{Example HTML Parser \label{htmlparser-example}} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
128 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
129 As a basic example, below is a very basic HTML parser that uses the |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
130 \class{HTMLParser} class to print out tags as they are encountered: |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
131 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
132 \begin{verbatim} |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
133 from HTMLParser import HTMLParser |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
134 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
135 class MyHTMLParser(HTMLParser): |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
136 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
137 def handle_starttag(self, tag, attrs): |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
138 print "Encountered the beginning of a %s tag" % tag |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
139 |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
140 def handle_endtag(self, tag): |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
141 print "Encountered the end of a %s tag" % tag |
|
baf2137e9676
Michel Pelletier <michel@digicool.com>:
Fred Drake <fdrake@acm.org>
parents:
diff
changeset
|
142 \end{verbatim} |
