One of the most common tasks is to generate the flat text of the
email message represented by a message object tree. You will
need to do this if you want to send your message via the smtplib
module or the nntplib module, or print the message on the
console. Taking a message object tree and producing a flat text
document is the job of the Generator class. Again, as with the
email.Parser module, you aren't limited to the functionality of
the bundled generator; you could write one from scratch
yourself. However the bundled generator knows how to generate
most email in a standards-compliant way, should handle MIME and
non-MIME email messages just fine, and is designed so that the
transformation from flat text, to an object tree via the Parser
class, and back to flat text, is idempotent (the input is
identical to the output). Here are the public methods of the
Generator class: Optional mangle_from_ is a flag that, when
true, puts a ">"character in front of any line in the body that
starts exactly as "From " (i.e.