New submission from Pablo:

I used the IMAP library and I feel it lacks a lot of documentation regarding 
types and encoding.

Example:
IMAP4.list([directory[, pattern]]):
It doesn't state if it expects the directory argument to be an string (unicode) 
or a imap_utf7 encoded string or bytes.
It also expects names with spaces to be between double quotation marks and it 
doesn't state that it returns a bytes raw output.

This is valid for every function that receives a directory or mailbox argument. 
Also for most return values.

Documentation aside, I think it would be a nice improvement in the 
implementation to add an imap_utf7 convertion function, and check every 
directory or mailbox argument to see if it has characters outside the imap_utf7 
charset and attempts to convert them automatically.

----------
assignee: docs@python
components: Documentation
messages: 241812
nosy: docs@python, pmoleri
priority: normal
severity: normal
status: open
title: IMAP library lacks documentation about expected parameter types
type: enhancement
versions: Python 3.4

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue24027>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to