From: Barry Warsaw Date: Thu, 11 Oct 2001 15:43:00 +0000 (+0000) Subject: HeaderParser: A new subclass of Parser which only parses the message X-Git-Tag: v2.2.1c1~1342 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e552882960e4caa26ec80465ee501da17bc29e51;p=python HeaderParser: A new subclass of Parser which only parses the message headers. It does not parse the body of the message, instead simply assigning it as a string to the container's payload. This can be much faster when you're only interested in a message's header. --- diff --git a/Lib/email/Parser.py b/Lib/email/Parser.py index 81763dc006..44a0ca2bdd 100644 --- a/Lib/email/Parser.py +++ b/Lib/email/Parser.py @@ -158,3 +158,19 @@ class Parser: container.add_payload(msg) else: container.add_payload(fp.read()) + + + +class HeaderParser(Parser): + """A subclass of Parser, this one only meaningfully parses message headers. + + This class can be used if all you're interested in is the headers of a + message. While it consumes the message body, it does not parse it, but + simply makes it available as a string payload. + + Parsing with this subclass can be considerably faster if all you're + interested in is the message headers. + """ + def _parsebody(self, container, fp): + # Consume but do not parse, the body + container.set_payload(fp.read())