[docs] [issue9715] io doc improvements
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