35 | """The io module provides the Python interfaces to stream handling. The
36 | builtin open function is defined in this module.
37 |
38 | At the top of the I/O hierarchy is the abstract base class IOBase. It
39 | defines the basic interface to a stream. Note, however, that there is no
40 | separation between reading and writing to streams; implementations are
41 | allowed to raise an OSError if they do not support a given operation.
42 |
43 | Extending IOBase is RawIOBase which deals simply with the reading and
44 | writing of raw bytes to a stream. FileIO subclasses RawIOBase to provide
45 | an interface to OS files.
46 |
47 | BufferedIOBase deals with buffering on a raw byte stream (RawIOBase). Its
48 | subclasses, BufferedWriter, BufferedReader, and BufferedRWPair buffer
49 | streams that are readable, writable, and both respectively.
50 | BufferedRandom provides a buffered interface to random access
51 | streams. BytesIO is a simple stream of in-memory bytes.
52 |
53 | Another IOBase subclass, TextIOBase, deals with the encoding and decoding
54 | of streams into text. TextIOWrapper, which extends it, is a buffered text
55 | interface to a buffered raw stream (`BufferedIOBase`). Finally, StringIO
56 | is an in-memory stream for text.
57 |
58 | Argument names are not part of the specification, and only the arguments
59 | of open() are intended to be used as keyword arguments.
60 |
61 | data:
62 |
63 | DEFAULT_BUFFER_SIZE
64 |
65 | An int containing the default buffer size used by the module's buffered
66 | I/O classes. open() uses the file's blksize (as obtained by os.stat) if
67 | possible.
68 | """
69 | # New I/O library conforming to PEP 3116.
70 |
71 | __author__ = ("Guido van Rossum <guido@python.org>, "
72 | "Mike Verdone <mike.verdone@gmail.com>, "
73 | "Mark Russell <mark.russell@zen.co.uk>, "
74 | "Antoine Pitrou <solipsis@pitrou.net>, "
75 | "Amaury Forgeot d'Arc <amauryfa@gmail.com>, "
76 | "Benjamin Peterson <benjamin@python.org>")
77 |
78 | __all__ = ["BlockingIOError", "open", "IOBase", "RawIOBase", "FileIO",
79 | "BytesIO", "StringIO", "BufferedIOBase",
80 | "BufferedReader", "BufferedWriter", "BufferedRWPair",
81 | "BufferedRandom", "TextIOBase", "TextIOWrapper",
82 | "UnsupportedOperation", "SEEK_SET", "SEEK_CUR", "SEEK_END"]
83 |
84 |
85 | import _io
86 | import abc
87 |
88 | from _io import (DEFAULT_BUFFER_SIZE, BlockingIOError, UnsupportedOperation,
89 | open, FileIO, BytesIO, StringIO, BufferedReader,
90 | BufferedWriter, BufferedRWPair, BufferedRandom,
91 | IncrementalNewlineDecoder, TextIOWrapper)
92 |
93 | OpenWrapper = _io.open # for compatibility with _pyio
94 |
95 | # Pretend this exception was created here.
96 | UnsupportedOperation.__module__ = "io"
97 |
98 | # for seek()
99 | SEEK_SET = 0
100 | SEEK_CUR = 1
101 | SEEK_END = 2
102 |
103 | # Declaring ABCs in C is tricky so we do it here.
104 | # Method descriptions and default implementations are inherited from the C
105 | # version however.
106 | [docs]class IOBase(_io._IOBase, metaclass=abc.ABCMeta):
107 |
__doc__ = _io._IOBase.__doc__
108 |
109 | [docs]class RawIOBase(_io._RawIOBase, IOBase):
110 |
__doc__ = _io._RawIOBase.__doc__
111 |
112 | [docs]class BufferedIOBase(_io._BufferedIOBase, IOBase):
113 |
__doc__ = _io._BufferedIOBase.__doc__
114 |
115 | [docs]class TextIOBase(_io._TextIOBase, IOBase):
116 |
__doc__ = _io._TextIOBase.__doc__
117 |
118 | RawIOBase.register(FileIO)
119 |
120 | for klass in (BytesIO, BufferedReader, BufferedWriter, BufferedRandom,
121 | BufferedRWPair):
122 | BufferedIOBase.register(klass)
123 |
124 | for klass in (StringIO, TextIOWrapper):
125 | TextIOBase.register(klass)
126 | del klass
127 |
128 | try:
129 | from _io import _WindowsConsoleIO
130 | except ImportError:
131 | pass
132 | else:
133 | RawIOBase.register(_WindowsConsoleIO)
134 | 
46 | 
43 | 
74 | 
81 | 
3 |