Author serhiy.storchaka
Recipients benjamin.peterson, christian.heimes, docs@python, hynek, pitrou, serhiy.storchaka, stutzbach
Date 2013-01-20.16:13:14
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1358698394.54.0.180835263252.issue17003@psf.upfronthosting.co.za>
In-reply-to
Content
read() and readline() optional parameter which limit the amount of read data has different names in different classes. All this classes mimic (less or more) io classes. Keyword parameter name is a part of method specification. Therefore it will be good made all read() arguments names the same and all readline() arguments names the same (and be consistent with documentation and C implementation). At least we should choose most consistent name for new implementations. If existent C implementation of some method doesn't support keyword argument (all _io classes) or argument names in C and Python implementations are different then we are free to change this name without breaking existing code.

For example, read()'s parameter named as:

"n" in _pyio, zipfile, and io documentation;
"size" in gzip, bz2, imaplib, tarfile, codecs, mailbox;
"len" in ssl;
"wtd" or "totalwtd" in binhex;
"amt" in http/client;
"chars" in codecs;
"buffersize" in os.

readline()'s parameter named as:

"limit" in _pyio, zipfile, and io documentation;
"size" in gzip, bz2, codecs, mailbox, lzma.
History
Date User Action Args
2013-01-20 16:13:14serhiy.storchakasetrecipients: + serhiy.storchaka, pitrou, christian.heimes, benjamin.peterson, stutzbach, docs@python, hynek
2013-01-20 16:13:14serhiy.storchakasetmessageid: <1358698394.54.0.180835263252.issue17003@psf.upfronthosting.co.za>
2013-01-20 16:13:14serhiy.storchakalinkissue17003 messages
2013-01-20 16:13:14serhiy.storchakacreate