Message180298
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. |
|
Date |
User |
Action |
Args |
2013-01-20 16:13:14 | serhiy.storchaka | set | recipients:
+ serhiy.storchaka, pitrou, christian.heimes, benjamin.peterson, stutzbach, docs@python, hynek |
2013-01-20 16:13:14 | serhiy.storchaka | set | messageid: <1358698394.54.0.180835263252.issue17003@psf.upfronthosting.co.za> |
2013-01-20 16:13:14 | serhiy.storchaka | link | issue17003 messages |
2013-01-20 16:13:14 | serhiy.storchaka | create | |
|