+++ /dev/null
-"""The io module provides the Python interfaces to stream handling. The\r
-builtin open function is defined in this module.\r
-\r
-At the top of the I/O hierarchy is the abstract base class IOBase. It\r
-defines the basic interface to a stream. Note, however, that there is no\r
-separation between reading and writing to streams; implementations are\r
-allowed to throw an IOError if they do not support a given operation.\r
-\r
-Extending IOBase is RawIOBase which deals simply with the reading and\r
-writing of raw bytes to a stream. FileIO subclasses RawIOBase to provide\r
-an interface to OS files.\r
-\r
-BufferedIOBase deals with buffering on a raw byte stream (RawIOBase). Its\r
-subclasses, BufferedWriter, BufferedReader, and BufferedRWPair buffer\r
-streams that are readable, writable, and both respectively.\r
-BufferedRandom provides a buffered interface to random access\r
-streams. BytesIO is a simple stream of in-memory bytes.\r
-\r
-Another IOBase subclass, TextIOBase, deals with the encoding and decoding\r
-of streams into text. TextIOWrapper, which extends it, is a buffered text\r
-interface to a buffered raw stream (`BufferedIOBase`). Finally, StringIO\r
-is a in-memory stream for text.\r
-\r
-Argument names are not part of the specification, and only the arguments\r
-of open() are intended to be used as keyword arguments.\r
-\r
-data:\r
-\r
-DEFAULT_BUFFER_SIZE\r
-\r
- An int containing the default buffer size used by the module's buffered\r
- I/O classes. open() uses the file's blksize (as obtained by os.stat) if\r
- possible.\r
-"""\r
-# New I/O library conforming to PEP 3116.\r
-\r
-# XXX edge cases when switching between reading/writing\r
-# XXX need to support 1 meaning line-buffered\r
-# XXX whenever an argument is None, use the default value\r
-# XXX read/write ops should check readable/writable\r
-# XXX buffered readinto should work with arbitrary buffer objects\r
-# XXX use incremental encoder for text output, at least for UTF-16 and UTF-8-SIG\r
-# XXX check writable, readable and seekable in appropriate places\r
-\r
-\r
-__author__ = ("Guido van Rossum <guido@python.org>, "\r
- "Mike Verdone <mike.verdone@gmail.com>, "\r
- "Mark Russell <mark.russell@zen.co.uk>, "\r
- "Antoine Pitrou <solipsis@pitrou.net>, "\r
- "Amaury Forgeot d'Arc <amauryfa@gmail.com>, "\r
- "Benjamin Peterson <benjamin@python.org>")\r
-\r
-__all__ = ["BlockingIOError", "open", "IOBase", "RawIOBase", "FileIO",\r
- "BytesIO", "StringIO", "BufferedIOBase",\r
- "BufferedReader", "BufferedWriter", "BufferedRWPair",\r
- "BufferedRandom", "TextIOBase", "TextIOWrapper",\r
- "UnsupportedOperation", "SEEK_SET", "SEEK_CUR", "SEEK_END"]\r
-\r
-\r
-import _io\r
-import abc\r
-\r
-from _io import (DEFAULT_BUFFER_SIZE, BlockingIOError, UnsupportedOperation,\r
- open, FileIO, BytesIO, StringIO, BufferedReader,\r
- BufferedWriter, BufferedRWPair, BufferedRandom,\r
- IncrementalNewlineDecoder, TextIOWrapper)\r
-\r
-OpenWrapper = _io.open # for compatibility with _pyio\r
-\r
-# for seek()\r
-SEEK_SET = 0\r
-SEEK_CUR = 1\r
-SEEK_END = 2\r
-\r
-# Declaring ABCs in C is tricky so we do it here.\r
-# Method descriptions and default implementations are inherited from the C\r
-# version however.\r
-class IOBase(_io._IOBase):\r
- __metaclass__ = abc.ABCMeta\r
-\r
-class RawIOBase(_io._RawIOBase, IOBase):\r
- pass\r
-\r
-class BufferedIOBase(_io._BufferedIOBase, IOBase):\r
- pass\r
-\r
-class TextIOBase(_io._TextIOBase, IOBase):\r
- pass\r
-\r
-RawIOBase.register(FileIO)\r
-\r
-for klass in (BytesIO, BufferedReader, BufferedWriter, BufferedRandom,\r
- BufferedRWPair):\r
- BufferedIOBase.register(klass)\r
-\r
-for klass in (StringIO, TextIOWrapper):\r
- TextIOBase.register(klass)\r
-del klass\r
projects / mirror_edk2.git / blobdiff