Issue #10899: No function type annotations in the standard library.
Removed function type annotations from _pyio.py.
This commit is contained in:
parent
1e28513d25
commit
3c94024c3e
62
Lib/_pyio.py
62
Lib/_pyio.py
|
@ -34,9 +34,9 @@ class BlockingIOError(IOError):
|
||||||
self.characters_written = characters_written
|
self.characters_written = characters_written
|
||||||
|
|
||||||
|
|
||||||
def open(file: (str, bytes), mode: str = "r", buffering: int = -1,
|
def open(file, mode = "r", buffering = -1,
|
||||||
encoding: str = None, errors: str = None,
|
encoding = None, errors = None,
|
||||||
newline: str = None, closefd: bool = True) -> "IOBase":
|
newline = None, closefd = True):
|
||||||
|
|
||||||
r"""Open file and return a stream. Raise IOError upon failure.
|
r"""Open file and return a stream. Raise IOError upon failure.
|
||||||
|
|
||||||
|
@ -287,14 +287,14 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
### Internal ###
|
### Internal ###
|
||||||
|
|
||||||
def _unsupported(self, name: str) -> IOError:
|
def _unsupported(self, name):
|
||||||
"""Internal: raise an exception for unsupported operations."""
|
"""Internal: raise an exception for unsupported operations."""
|
||||||
raise UnsupportedOperation("%s.%s() not supported" %
|
raise UnsupportedOperation("%s.%s() not supported" %
|
||||||
(self.__class__.__name__, name))
|
(self.__class__.__name__, name))
|
||||||
|
|
||||||
### Positioning ###
|
### Positioning ###
|
||||||
|
|
||||||
def seek(self, pos: int, whence: int = 0) -> int:
|
def seek(self, pos, whence = 0):
|
||||||
"""Change stream position.
|
"""Change stream position.
|
||||||
|
|
||||||
Change the stream position to byte offset offset. offset is
|
Change the stream position to byte offset offset. offset is
|
||||||
|
@ -309,11 +309,11 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
"""
|
"""
|
||||||
self._unsupported("seek")
|
self._unsupported("seek")
|
||||||
|
|
||||||
def tell(self) -> int:
|
def tell(self):
|
||||||
"""Return current stream position."""
|
"""Return current stream position."""
|
||||||
return self.seek(0, 1)
|
return self.seek(0, 1)
|
||||||
|
|
||||||
def truncate(self, pos: int = None) -> int:
|
def truncate(self, pos = None):
|
||||||
"""Truncate file to size bytes.
|
"""Truncate file to size bytes.
|
||||||
|
|
||||||
Size defaults to the current IO position as reported by tell(). Return
|
Size defaults to the current IO position as reported by tell(). Return
|
||||||
|
@ -323,7 +323,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
### Flush and close ###
|
### Flush and close ###
|
||||||
|
|
||||||
def flush(self) -> None:
|
def flush(self):
|
||||||
"""Flush write buffers, if applicable.
|
"""Flush write buffers, if applicable.
|
||||||
|
|
||||||
This is not implemented for read-only and non-blocking streams.
|
This is not implemented for read-only and non-blocking streams.
|
||||||
|
@ -333,7 +333,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
__closed = False
|
__closed = False
|
||||||
|
|
||||||
def close(self) -> None:
|
def close(self):
|
||||||
"""Flush and close the IO object.
|
"""Flush and close the IO object.
|
||||||
|
|
||||||
This method has no effect if the file is already closed.
|
This method has no effect if the file is already closed.
|
||||||
|
@ -342,7 +342,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
self.flush()
|
self.flush()
|
||||||
self.__closed = True
|
self.__closed = True
|
||||||
|
|
||||||
def __del__(self) -> None:
|
def __del__(self):
|
||||||
"""Destructor. Calls close()."""
|
"""Destructor. Calls close()."""
|
||||||
# The try/except block is in case this is called at program
|
# The try/except block is in case this is called at program
|
||||||
# exit time, when it's possible that globals have already been
|
# exit time, when it's possible that globals have already been
|
||||||
|
@ -356,7 +356,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
### Inquiries ###
|
### Inquiries ###
|
||||||
|
|
||||||
def seekable(self) -> bool:
|
def seekable(self):
|
||||||
"""Return whether object supports random access.
|
"""Return whether object supports random access.
|
||||||
|
|
||||||
If False, seek(), tell() and truncate() will raise UnsupportedOperation.
|
If False, seek(), tell() and truncate() will raise UnsupportedOperation.
|
||||||
|
@ -371,7 +371,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
raise UnsupportedOperation("File or stream is not seekable."
|
raise UnsupportedOperation("File or stream is not seekable."
|
||||||
if msg is None else msg)
|
if msg is None else msg)
|
||||||
|
|
||||||
def readable(self) -> bool:
|
def readable(self):
|
||||||
"""Return whether object was opened for reading.
|
"""Return whether object was opened for reading.
|
||||||
|
|
||||||
If False, read() will raise UnsupportedOperation.
|
If False, read() will raise UnsupportedOperation.
|
||||||
|
@ -385,7 +385,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
raise UnsupportedOperation("File or stream is not readable."
|
raise UnsupportedOperation("File or stream is not readable."
|
||||||
if msg is None else msg)
|
if msg is None else msg)
|
||||||
|
|
||||||
def writable(self) -> bool:
|
def writable(self):
|
||||||
"""Return whether object was opened for writing.
|
"""Return whether object was opened for writing.
|
||||||
|
|
||||||
If False, write() and truncate() will raise UnsupportedOperation.
|
If False, write() and truncate() will raise UnsupportedOperation.
|
||||||
|
@ -416,12 +416,12 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
### Context manager ###
|
### Context manager ###
|
||||||
|
|
||||||
def __enter__(self) -> "IOBase": # That's a forward reference
|
def __enter__(self): # That's a forward reference
|
||||||
"""Context management protocol. Returns self."""
|
"""Context management protocol. Returns self."""
|
||||||
self._checkClosed()
|
self._checkClosed()
|
||||||
return self
|
return self
|
||||||
|
|
||||||
def __exit__(self, *args) -> None:
|
def __exit__(self, *args):
|
||||||
"""Context management protocol. Calls close()"""
|
"""Context management protocol. Calls close()"""
|
||||||
self.close()
|
self.close()
|
||||||
|
|
||||||
|
@ -429,14 +429,14 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
# XXX Should these be present even if unimplemented?
|
# XXX Should these be present even if unimplemented?
|
||||||
|
|
||||||
def fileno(self) -> int:
|
def fileno(self):
|
||||||
"""Returns underlying file descriptor if one exists.
|
"""Returns underlying file descriptor if one exists.
|
||||||
|
|
||||||
An IOError is raised if the IO object does not use a file descriptor.
|
An IOError is raised if the IO object does not use a file descriptor.
|
||||||
"""
|
"""
|
||||||
self._unsupported("fileno")
|
self._unsupported("fileno")
|
||||||
|
|
||||||
def isatty(self) -> bool:
|
def isatty(self):
|
||||||
"""Return whether this is an 'interactive' stream.
|
"""Return whether this is an 'interactive' stream.
|
||||||
|
|
||||||
Return False if it can't be determined.
|
Return False if it can't be determined.
|
||||||
|
@ -446,7 +446,7 @@ class IOBase(metaclass=abc.ABCMeta):
|
||||||
|
|
||||||
### Readline[s] and writelines ###
|
### Readline[s] and writelines ###
|
||||||
|
|
||||||
def readline(self, limit: int = -1) -> bytes:
|
def readline(self, limit = -1):
|
||||||
r"""Read and return a line from the stream.
|
r"""Read and return a line from the stream.
|
||||||
|
|
||||||
If limit is specified, at most limit bytes will be read.
|
If limit is specified, at most limit bytes will be read.
|
||||||
|
@ -532,7 +532,7 @@ class RawIOBase(IOBase):
|
||||||
# primitive operation, but that would lead to nasty recursion in case
|
# primitive operation, but that would lead to nasty recursion in case
|
||||||
# a subclass doesn't implement either.)
|
# a subclass doesn't implement either.)
|
||||||
|
|
||||||
def read(self, n: int = -1) -> bytes:
|
def read(self, n = -1):
|
||||||
"""Read and return up to n bytes.
|
"""Read and return up to n bytes.
|
||||||
|
|
||||||
Returns an empty bytes object on EOF, or None if the object is
|
Returns an empty bytes object on EOF, or None if the object is
|
||||||
|
@ -559,7 +559,7 @@ class RawIOBase(IOBase):
|
||||||
res += data
|
res += data
|
||||||
return bytes(res)
|
return bytes(res)
|
||||||
|
|
||||||
def readinto(self, b: bytearray) -> int:
|
def readinto(self, b):
|
||||||
"""Read up to len(b) bytes into b.
|
"""Read up to len(b) bytes into b.
|
||||||
|
|
||||||
Returns number of bytes read (0 for EOF), or None if the object
|
Returns number of bytes read (0 for EOF), or None if the object
|
||||||
|
@ -567,7 +567,7 @@ class RawIOBase(IOBase):
|
||||||
"""
|
"""
|
||||||
self._unsupported("readinto")
|
self._unsupported("readinto")
|
||||||
|
|
||||||
def write(self, b: bytes) -> int:
|
def write(self, b):
|
||||||
"""Write the given buffer to the IO stream.
|
"""Write the given buffer to the IO stream.
|
||||||
|
|
||||||
Returns the number of bytes written, which may be less than len(b).
|
Returns the number of bytes written, which may be less than len(b).
|
||||||
|
@ -596,7 +596,7 @@ class BufferedIOBase(IOBase):
|
||||||
implementation, but wrap one.
|
implementation, but wrap one.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
def read(self, n: int = None) -> bytes:
|
def read(self, n = None):
|
||||||
"""Read and return up to n bytes.
|
"""Read and return up to n bytes.
|
||||||
|
|
||||||
If the argument is omitted, None, or negative, reads and
|
If the argument is omitted, None, or negative, reads and
|
||||||
|
@ -616,11 +616,11 @@ class BufferedIOBase(IOBase):
|
||||||
"""
|
"""
|
||||||
self._unsupported("read")
|
self._unsupported("read")
|
||||||
|
|
||||||
def read1(self, n: int=None) -> bytes:
|
def read1(self, n = None):
|
||||||
"""Read up to n bytes with at most one read() system call."""
|
"""Read up to n bytes with at most one read() system call."""
|
||||||
self._unsupported("read1")
|
self._unsupported("read1")
|
||||||
|
|
||||||
def readinto(self, b: bytearray) -> int:
|
def readinto(self, b):
|
||||||
"""Read up to len(b) bytes into b.
|
"""Read up to len(b) bytes into b.
|
||||||
|
|
||||||
Like read(), this may issue multiple reads to the underlying raw
|
Like read(), this may issue multiple reads to the underlying raw
|
||||||
|
@ -643,7 +643,7 @@ class BufferedIOBase(IOBase):
|
||||||
b[:n] = array.array('b', data)
|
b[:n] = array.array('b', data)
|
||||||
return n
|
return n
|
||||||
|
|
||||||
def write(self, b: bytes) -> int:
|
def write(self, b):
|
||||||
"""Write the given buffer to the IO stream.
|
"""Write the given buffer to the IO stream.
|
||||||
|
|
||||||
Return the number of bytes written, which is never less than
|
Return the number of bytes written, which is never less than
|
||||||
|
@ -654,7 +654,7 @@ class BufferedIOBase(IOBase):
|
||||||
"""
|
"""
|
||||||
self._unsupported("write")
|
self._unsupported("write")
|
||||||
|
|
||||||
def detach(self) -> None:
|
def detach(self):
|
||||||
"""
|
"""
|
||||||
Separate the underlying raw stream from the buffer and return it.
|
Separate the underlying raw stream from the buffer and return it.
|
||||||
|
|
||||||
|
@ -1272,7 +1272,7 @@ class TextIOBase(IOBase):
|
||||||
are immutable. There is no public constructor.
|
are immutable. There is no public constructor.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
def read(self, n: int = -1) -> str:
|
def read(self, n = -1):
|
||||||
"""Read at most n characters from stream.
|
"""Read at most n characters from stream.
|
||||||
|
|
||||||
Read from underlying buffer until we have n characters or we hit EOF.
|
Read from underlying buffer until we have n characters or we hit EOF.
|
||||||
|
@ -1280,22 +1280,22 @@ class TextIOBase(IOBase):
|
||||||
"""
|
"""
|
||||||
self._unsupported("read")
|
self._unsupported("read")
|
||||||
|
|
||||||
def write(self, s: str) -> int:
|
def write(self, s):
|
||||||
"""Write string s to stream."""
|
"""Write string s to stream."""
|
||||||
self._unsupported("write")
|
self._unsupported("write")
|
||||||
|
|
||||||
def truncate(self, pos: int = None) -> int:
|
def truncate(self, pos = None):
|
||||||
"""Truncate size to pos."""
|
"""Truncate size to pos."""
|
||||||
self._unsupported("truncate")
|
self._unsupported("truncate")
|
||||||
|
|
||||||
def readline(self) -> str:
|
def readline(self):
|
||||||
"""Read until newline or EOF.
|
"""Read until newline or EOF.
|
||||||
|
|
||||||
Returns an empty string if EOF is hit immediately.
|
Returns an empty string if EOF is hit immediately.
|
||||||
"""
|
"""
|
||||||
self._unsupported("readline")
|
self._unsupported("readline")
|
||||||
|
|
||||||
def detach(self) -> None:
|
def detach(self):
|
||||||
"""
|
"""
|
||||||
Separate the underlying buffer from the TextIOBase and return it.
|
Separate the underlying buffer from the TextIOBase and return it.
|
||||||
|
|
||||||
|
|
|
@ -43,6 +43,9 @@ Core and Builtins
|
||||||
Library
|
Library
|
||||||
-------
|
-------
|
||||||
|
|
||||||
|
- Issue #10899: No function type annotations in the standard library.
|
||||||
|
Removed function type annotations from _pyio.py.
|
||||||
|
|
||||||
- Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'.
|
- Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'.
|
||||||
|
|
||||||
- Issue #10872: The repr() of TextIOWrapper objects now includes the mode
|
- Issue #10872: The repr() of TextIOWrapper objects now includes the mode
|
||||||
|
|
Loading…
Reference in New Issue