12.16.1 Mailbox Objects

All implementations of Mailbox objects have one externally visible method:

next ()

Return the next message in the mailbox, as a rfc822.Message object. Depending on the mailbox implementation the fp attribute of this object may be a true file object or a class instance simulating a file object, taking care of things like message boundaries if multiple mail messages are contained in a single file, etc.