[docs] [issue9715] io doc improvements

Benjamin Peterson report at bugs.python.org
Mon Aug 30 15:32:34 CEST 2010

Benjamin Peterson <benjamin at python.org> added the comment:

2010/8/30 Skip Montanaro <report at bugs.python.org>:
> Skip Montanaro <skip at pobox.com> added the comment:
> A couple wording comments:
> "All streams are careful about the type of data you give to them"
> would read better as "All streams accept specific types of data".
> "The default mode is ``'r'`` (open for reading text, synonym of
> ``'rt'``)".  I liked the original wording better.

Feel free to change it; it's been committed.

> Finally, not specific to this change, but I wonder if rather than
> having distinct io.StringIO and io.BytesIO classes it would be better
> to have a single io.MemoryIO class which takes mode arguments just
> like io.FileIO?  The correspondence between file-based and memory-
> based i/o would be more one-to-one.  Such a class could be added
> without breaking existing code by using the StringIO and BytesIO
> classes as the back-end for a MemoryIO class.

What advantage would that have?


Python tracker <report at bugs.python.org>

More information about the docs mailing list