From e552882960e4caa26ec80465ee501da17bc29e51 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Thu, 11 Oct 2001 15:43:00 +0000 Subject: [PATCH] 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. --- Lib/email/Parser.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Lib/email/Parser.py b/Lib/email/Parser.py index 81763dc0068..44a0ca2bdd6 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())