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 stutzbach
Recipients stutzbach
Date 2010-11-30.19:05:51
SpamBayes Score 0.004964575
Marked as misclassified No
Message-id <1291143953.85.0.0204032538698.issue10589@psf.upfronthosting.co.za>
In-reply-to
Content
The I/O ABC documentation has a blanket disclaimer at the top:

    "The abstract base classes also provide default implementations of some methods in order to help implementation of concrete stream classes. For example, BufferedIOBase provides unoptimized implementations of readinto() and readline()."

Which effectively means that to subclass one of them requires digging into Lib/_pyio.py to figure out which methods provide useful implementations.

It would be handy to have a table, similar to the one for the collections ABCs [1], that spells out which methods are provided.

[1]: http://docs.python.org/py3k/library/collections.html#abcs-abstract-base-classes

I hope to have a patch ready sometime within the next week.
History
Date User Action Args
2010-11-30 19:05:53stutzbachsetrecipients: + stutzbach
2010-11-30 19:05:53stutzbachsetmessageid: <1291143953.85.0.0204032538698.issue10589@psf.upfronthosting.co.za>
2010-11-30 19:05:51stutzbachlinkissue10589 messages
2010-11-30 19:05:51stutzbachcreate