This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author beazley
Recipients beazley, georg.brandl
Date 2008-12-29.15:21:46
SpamBayes Score 6.6099974e-09
Marked as misclassified No
Message-id <1230564109.29.0.851125901537.issue4766@psf.upfronthosting.co.za>
In-reply-to
Content
Documentation for the email package needs to be more clear about the 
usage of strings and bytes.  In particular:

1.  All operations that parse email messages such as message_from_file()
    or message_from_string() operate on *text*, not binary data.  So,
    the file must be opened in text mode.  Strings must be text strings,
    not binary strings.

2.  All operations that set/get the payload of a message operate on
    byte strings.   For example, using m.get_payload() on a Message
    object returns binary data as a byte string.

Opinion:  There might be other bug reports about this, but I'm not 
advocating that the email module should support reading messages from 
binary mode files or byte strings.  Email and MIME were originally 
developed with the assumption that messages would always be handled as 
text. Minimally, this assumed that messages would stay intact even if 
processed as 7-bit ASCII.   By extension, everything should still work 
if processed as Unicode.  So, I think the use of text-mode files is 
entirely consistent with this if you wanted to keep the module "as is." 

There may be some confusion on this matter because if you're reading or 
writing email messages (or sending them across a socket), you may 
encounter messages stored in the form of bytes strings instead of text.   
People will then wonder why a byte string can't be parsed by this module 
(especially given that email messages only use character values in the 
range of 0-127).
History
Date User Action Args
2008-12-29 15:21:49beazleysetrecipients: + beazley, georg.brandl
2008-12-29 15:21:49beazleysetmessageid: <1230564109.29.0.851125901537.issue4766@psf.upfronthosting.co.za>
2008-12-29 15:21:48beazleylinkissue4766 messages
2008-12-29 15:21:46beazleycreate