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 aymeric.augustin
Recipients aymeric.augustin, gvanrossum, vstinner, yselivanov
Date 2015-08-18.09:48:29
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1439891310.64.0.826592232629.issue24885@psf.upfronthosting.co.za>
In-reply-to
Content
https://docs.python.org/3/library/asyncio-stream.html?highlight=streamreaderprotocol#stream-functions says:

> (If you want to customize the StreamReader and/or StreamReaderProtocol classes, just copy the code – there’s really nothing special here except some convenience.)

StreamReaderProtocol inherits from streams.FlowControlMixin which isn't documented. Applying this advice means, instead of inheriting from StreamReaderProtocol, inheriting from streams.FlowControlMixin -- in order to obtain the _drain_helper method, which StreamWriter.drain must wait for.

At this point inheriting StreamReaderProtocol appears to be the lesser evil.

I suggest to remove this paragraph from the documentation.
History
Date User Action Args
2015-08-18 09:48:30aymeric.augustinsetrecipients: + aymeric.augustin, gvanrossum, vstinner, yselivanov
2015-08-18 09:48:30aymeric.augustinsetmessageid: <1439891310.64.0.826592232629.issue24885@psf.upfronthosting.co.za>
2015-08-18 09:48:30aymeric.augustinlinkissue24885 messages
2015-08-18 09:48:29aymeric.augustincreate