FeedParser - An email feed parser.
 
The feed parser implements an interface for incrementally parsing an email
message, line by line.  This has advantages for certain applications, such as
those reading email messages off a socket.
 
FeedParser.feed() is the primary interface for pushing new data into the
parser.  It returns when there's nothing more it can do with the available
data.  When you have no more data to push into the parser, call .close().
This completes the parsing and returns the root message object.
 
The other advantage of this parser is that it will never throw a parsing
exception.  Instead, when it finds something unexpected, it adds a 'defect' to
the current message.  Defects are just instances that live on the message
object's .defects attribute.

Modules
		email.Errors email.Message re

Classes
		__builtin__.object BufferedSubFile FeedParser   class BufferedSubFile(__builtin__.object)     A file-ish object that can have new data loaded into it.   You can also push and pop line-matching predicates onto a stack.  When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead.  This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message.     Methods defined here: __init__(self) __iter__(self) close(self) is_closed(self) next(self) pop_eof_matcher(self) push(self, data) Push some new data into this object. push_eof_matcher(self, pred) pushlines(self, lines) readline(self) unreadline(self, line) Data descriptors defined here: __dict__ dictionary for instance variables (if defined) __weakref__ list of weak references to the object (if defined)   class FeedParser     A feed-style parser of email.     Methods defined here: __init__(self, _factory=<class email.Message.Message>) _factory is called with no arguments to create a new message obj close(self) Parse all remaining data and return the root message object. feed(self, data) Push more data into the parser.

Data
		EMPTYSTRING = '' NL = '\n' NLCRE = <_sre.SRE_Pattern object> NLCRE_bol = <_sre.SRE_Pattern object> NLCRE_crack = <_sre.SRE_Pattern object> NLCRE_eol = <_sre.SRE_Pattern object> NeedMoreData = <object object> headerRE = <_sre.SRE_Pattern object>