Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Merge HTMLParser doc changes from 3.2.

This commit is contained in:
Ezio Melotti 2011-10-28 14:36:11 +03:00
parent 91ec2e8a31 f99e4b5dbe
commit ac73b0c95e
1 changed files with 18 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Doc/library/html.parser.rst
View File

@ -101,9 +101,9 @@ An exception is defined as well:
.. method:: HTMLParser.handle_startendtag(tag, attrs) .. method:: HTMLParser.handle_startendtag(tag, attrs)
Similar to :meth:`handle_starttag`, but called when the parser encounters an Similar to :meth:`handle_starttag`, but called when the parser encounters an
XHTML-style empty tag (``<a .../>``). This method may be overridden by XHTML-style empty tag (``<img ... />``). This method may be overridden by
subclasses which require this particular lexical information; the default subclasses which require this particular lexical information; the default
implementation simple calls :meth:`handle_starttag` and :meth:`handle_endtag`. implementation simply calls :meth:`handle_starttag` and :meth:`handle_endtag`.
.. method:: HTMLParser.handle_endtag(tag) .. method:: HTMLParser.handle_endtag(tag)
@ -178,27 +178,23 @@ An exception is defined as well:
Example HTML Parser Application Example HTML Parser Application
------------------------------- -------------------------------
As a basic example, below is a very basic HTML parser that uses the As a basic example, below is a simple HTML parser that uses the
:class:`HTMLParser` class to print out tags as they are encountered:: :class:`HTMLParser` class to print out start tags, end tags, and data
as they are encountered::
>>> from html.parser import HTMLParser from html.parser import HTMLParser
>>>
>>> class MyHTMLParser(HTMLParser): class MyHTMLParser(HTMLParser):
... def handle_starttag(self, tag, attrs): def handle_starttag(self, tag, attrs):
... print("Encountered a {} start tag".format(tag)) print("Encountered a start tag:", tag)
... def handle_endtag(self, tag): def handle_endtag(self, tag):
... print("Encountered a {} end tag".format(tag)) print("Encountered an end tag:", tag)
... def handle_data(self, data):
>>> page = """<html><h1>Title</h1><p>I'm a paragraph!</p></html>""" print("Encountered some data:", data)
>>>
>>> myparser = MyHTMLParser() parser = MyHTMLParser()
>>> myparser.feed(page) parser.feed('<html><head><title>Test</title></head>'
Encountered a html start tag '<body><h1>Parse me!</h1></body></html>')
Encountered a h1 start tag
Encountered a h1 end tag
Encountered a p start tag
Encountered a p end tag
Encountered a html end tag
.. rubric:: Footnotes .. rubric:: Footnotes