add (overwrite with) mypy stubs, if available

stdlib/3/io.pyi

@@ -0,0 +1,150 @@
+# Stubs for io
+
+# Based on http://docs.python.org/3.2/library/io.html
+
+from typing import List, BinaryIO, TextIO, IO, overload, Iterator, Iterable, Any
+import builtins
+import codecs
+import _io
+
+DEFAULT_BUFFER_SIZE = 0  # type: int
+SEEK_SET = ...  # type: int
+SEEK_CUR = ...  # type: int
+SEEK_END = ...  # type: int
+
+open = builtins.open
+
+class BlockingIOError(OSError): ...
+class UnsupportedOperation(ValueError, OSError): ...
+
+class IncrementalNewlineDecoder(codecs.IncrementalDecoder):
+    newlines = ...  # type: Any
+    def __init__(self, *args, **kwargs): ...
+    def decode(self, input, final=False): ...
+    def getstate(self): ...
+    def reset(self): ...
+    def setstate(self, state): ...
+
+class IOBase(_io._IOBase): ...
+class RawIOBase(_io._RawIOBase, IOBase): ...
+class BufferedIOBase(_io._BufferedIOBase, IOBase): ...
+class TextIOBase(_io._TextIOBase, IOBase): ...
+
+class FileIO(_io._RawIOBase):
+    closefd = ...  # type: Any
+    mode = ...  # type: Any
+    def __init__(self, name, mode=..., closefd=..., opener=...): ...
+    def readinto(self, b): ...
+    def write(self, b): ...
+
+class BufferedReader(_io._BufferedIOBase):
+    mode = ...  # type: Any
+    name = ...  # type: Any
+    raw = ...  # type: Any
+    def __init__(self, raw, buffer_size=...): ...
+    def peek(self, size: int = -1): ...
+
+class BufferedWriter(_io._BufferedIOBase):
+    mode = ...  # type: Any
+    name = ...  # type: Any
+    raw = ...  # type: Any
+    def __init__(self, raw, buffer_size=...): ...
+
+class BufferedRWPair(_io._BufferedIOBase):
+    def __init__(self, reader, writer, buffer_size=...): ...
+    def peek(self, size: int = -1): ...
+
+class BufferedRandom(_io._BufferedIOBase):
+    mode = ...  # type: Any
+    name = ...  # type: Any
+    raw = ...  # type: Any
+    def __init__(self, raw, buffer_size=...): ...
+    def peek(self, size: int = -1): ...
+
+class BytesIO(BinaryIO):
+    def __init__(self, initial_bytes: bytes = b'') -> None: ...
+    # TODO getbuffer
+    # TODO see comments in BinaryIO for missing functionality
+    def close(self) -> None: ...
+    @property
+    def closed(self) -> bool: ...
+    def fileno(self) -> int: ...
+    def flush(self) -> None: ...
+    def isatty(self) -> bool: ...
+    def read(self, n: int = -1) -> bytes: ...
+    def readable(self) -> bool: ...
+    def readline(self, limit: int = -1) -> bytes: ...
+    def readlines(self, hint: int = -1) -> List[bytes]: ...
+    def seek(self, offset: int, whence: int = 0) -> int: ...
+    def seekable(self) -> bool: ...
+    def tell(self) -> int: ...
+    def truncate(self, size: int = None) -> int: ...
+    def writable(self) -> bool: ...
+    @overload
+    def write(self, s: bytes) -> int: ...
+    @overload
+    def write(self, s: bytearray) -> int: ...
+    def writelines(self, lines: Iterable[bytes]) -> None: ...
+    def getvalue(self) -> bytes: ...
+    def read1(self) -> str: ...
+
+    def __iter__(self) -> Iterator[bytes]: ...
+    def __enter__(self) -> 'BytesIO': ...
+    def __exit__(self, type, value, traceback) -> bool: ...
+
+class StringIO(TextIO):
+    def __init__(self, initial_value: str = '',
+                 newline: str = None) -> None: ...
+    # TODO see comments in BinaryIO for missing functionality
+    def close(self) -> None: ...
+    @property
+    def closed(self) -> bool: ...
+    def fileno(self) -> int: ...
+    def flush(self) -> None: ...
+    def isatty(self) -> bool: ...
+    def read(self, n: int = -1) -> str: ...
+    def readable(self) -> bool: ...
+    def readline(self, limit: int = -1) -> str: ...
+    def readlines(self, hint: int = -1) -> List[str]: ...
+    def seek(self, offset: int, whence: int = 0) -> int: ...
+    def seekable(self) -> bool: ...
+    def tell(self) -> int: ...
+    def truncate(self, size: int = None) -> int: ...
+    def writable(self) -> bool: ...
+    def write(self, s: str) -> int: ...
+    def writelines(self, lines: Iterable[str]) -> None: ...
+    def getvalue(self) -> str: ...
+
+    def __iter__(self) -> Iterator[str]: ...
+    def __enter__(self) -> 'StringIO': ...
+    def __exit__(self, type, value, traceback) -> bool: ...
+
+class TextIOWrapper(TextIO):
+    # TODO: This is actually a base class of _io._TextIOBase.
+    # write_through is undocumented but used by subprocess
+    def __init__(self, buffer: IO[bytes], encoding: str = None,
+                 errors: str = None, newline: str = None,
+                 line_buffering: bool = False,
+                 write_through: bool = True) -> None: ...
+    # TODO see comments in BinaryIO for missing functionality
+    def close(self) -> None: ...
+    @property
+    def closed(self) -> bool: ...
+    def fileno(self) -> int: ...
+    def flush(self) -> None: ...
+    def isatty(self) -> bool: ...
+    def read(self, n: int = -1) -> str: ...
+    def readable(self) -> bool: ...
+    def readline(self, limit: int = -1) -> str: ...
+    def readlines(self, hint: int = -1) -> List[str]: ...
+    def seek(self, offset: int, whence: int = 0) -> int: ...
+    def seekable(self) -> bool: ...
+    def tell(self) -> int: ...
+    def truncate(self, size: int = None) -> int: ...
+    def writable(self) -> bool: ...
+    def write(self, s: str) -> int: ...
+    def writelines(self, lines: Iterable[str]) -> None: ...
+
+    def __iter__(self) -> Iterator[str]: ...
+    def __enter__(self) -> StringIO: ...
+    def __exit__(self, type, value, traceback) -> bool: ...