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 gvanrossum
Recipients aymeric.augustin, gvanrossum, vstinner, yselivanov
Date 2015-10-19.20:12:04
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1445285526.77.0.723745264893.issue24885@psf.upfronthosting.co.za>
In-reply-to
Content
I just re-read the docs here (which came straight from the open_connection() docstring). The parenthetical remark is confusing -- I meant something more like

"""
If you want to use different classes than StreamReader, StreamReaderProtocol and StreamWriter, just copy the code of open_connection() and substitute your own classes.
"""

That is, the customization it is trying to refer to is open_connection(), not the classes.

FWIW I think subclassing implementation classes is a dangerous practice and shouldn't be encouraged.

Because the same reasoning applies to all the top-level functions here (but not to the classes), I think I'll delete the offending paragraph and replace it with something like the following at the top of the docs for this module:

"""
The top-level functions in this module are meant convenience wrappers only; there's really nothing special there, and if they don't do what you want feel free to copy their code.
"""
History
Date User Action Args
2015-10-19 20:12:06gvanrossumsetrecipients: + gvanrossum, vstinner, aymeric.augustin, yselivanov
2015-10-19 20:12:06gvanrossumsetmessageid: <1445285526.77.0.723745264893.issue24885@psf.upfronthosting.co.za>
2015-10-19 20:12:06gvanrossumlinkissue24885 messages
2015-10-19 20:12:04gvanrossumcreate