[New-bugs-announce] [issue35783] incorrect example of fetching messages in imaplib documentation

Макс Вернер report at bugs.python.org
Sat Jan 19 03:40:17 EST 2019

New submission from Макс Вернер <mvarnar at gmail.com>:

An example of fetching messages from the mailbox given in "IMAP4 Example" section is incorrect:

typ, data = M.fetch(num, '(RFC822)')
print('Message %s\n%s\n' % (num, data[0][1]))

"fetch" may return server data that was not requested (see "7.4.2.  FETCH Response" section of RFC 3501). In that case "data[0][1]" won't return what user expects.
This is a bad example, that many people repeat and advise to other developers:

I guess, this peculiarity should be clarified in the documentation. I offer to mark this fetching method is not safe and requests careful fetch result parsing.

assignee: docs at python
components: Documentation, email
messages: 334048
nosy: barry, docs at python, r.david.murray, Макс Вернер
priority: normal
severity: normal
status: open
title: incorrect example of fetching messages in imaplib documentation
type: enhancement
versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list