Message253190
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.
""" |
|
Date |
User |
Action |
Args |
2015-10-19 20:12:06 | gvanrossum | set | recipients:
+ gvanrossum, vstinner, aymeric.augustin, yselivanov |
2015-10-19 20:12:06 | gvanrossum | set | messageid: <1445285526.77.0.723745264893.issue24885@psf.upfronthosting.co.za> |
2015-10-19 20:12:06 | gvanrossum | link | issue24885 messages |
2015-10-19 20:12:04 | gvanrossum | create | |
|