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 martin.panter
Recipients docs@python, martin.panter, steverpalmer
Date 2019-02-01.08:36:10
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1549010171.14.0.306231721234.issue35869@roundup.psfhosted.org>
In-reply-to
Content
This is covered by Issue 13322. There are a few other BufferedReader methods that contradict the documentation for non-blocking mode.

A while ago I posted a patch to change the implementation to match the documentation, but nobody reviewed it or gave their opinion. These days I would prefer to just documentat the reality: the methods might raise an exception rather than returning None, or perhaps no particular behaviour at all is expected in general in the non-blocking case. But I don’t spend much time on Python now, so you might have to find someone else to move this forward.

Regarding the entry for “BufferedReader.read”, it would make more sense to remove the last “if”: “if ‘size’ is not given . . ., until EOF, or the ‘read’ call would block”. But I don’t think even that is complete, because it should also say the read stops and returns short in the non-blocking case even when “size” is positive.
History
Date User Action Args
2019-02-01 08:36:12martin.pantersetrecipients: + martin.panter, docs@python, steverpalmer
2019-02-01 08:36:11martin.pantersetmessageid: <1549010171.14.0.306231721234.issue35869@roundup.psfhosted.org>
2019-02-01 08:36:11martin.panterlinkissue35869 messages
2019-02-01 08:36:10martin.pantercreate