[Python-checkins] [3.9] gh-85864: Mark positional-only args in io docs (GH-91683). (#91848)
JelleZijlstra
webhook-mailer at python.org
Sat Apr 23 13:30:04 EDT 2022
https://github.com/python/cpython/commit/e4f5bff14018ac79409f57c7a9ecbe9b1ffd4975
commit: e4f5bff14018ac79409f57c7a9ecbe9b1ffd4975
branch: 3.9
author: Jelle Zijlstra <jelle.zijlstra at gmail.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2022-04-23T10:29:45-07:00
summary:
[3.9] gh-85864: Mark positional-only args in io docs (GH-91683). (#91848)
(cherry picked from commit a3f2cf3ced378db2569df4e7389ec1f79c85d55c)
Co-authored-by: slateny <46876382+slateny at users.noreply.github.com>
files:
M Doc/library/io.rst
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 9f62dd21afbea..28ad8dfd13126 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -299,7 +299,7 @@ I/O Base Classes
Return ``True`` if the stream can be read from. If ``False``, :meth:`read`
will raise :exc:`OSError`.
- .. method:: readline(size=-1)
+ .. method:: readline(size=-1, /)
Read and return one line from the stream. If *size* is specified, at
most *size* bytes will be read.
@@ -308,7 +308,7 @@ I/O Base Classes
the *newline* argument to :func:`open` can be used to select the line
terminator(s) recognized.
- .. method:: readlines(hint=-1)
+ .. method:: readlines(hint=-1, /)
Read and return a list of lines from the stream. *hint* can be specified
to control the number of lines read: no more lines will be read if the
@@ -394,7 +394,7 @@ I/O Base Classes
:class:`RawIOBase` provides these methods in addition to those from
:class:`IOBase`:
- .. method:: read(size=-1)
+ .. method:: read(size=-1, /)
Read up to *size* bytes from the object and return them. As a convenience,
if *size* is unspecified or -1, all bytes until EOF are returned.
@@ -504,7 +504,7 @@ I/O Base Classes
If *size* is ``-1`` (the default), an arbitrary number of bytes are
returned (more than zero unless EOF is reached).
- .. method:: readinto(b)
+ .. method:: readinto(b, /)
Read bytes into a pre-allocated, writable
:term:`bytes-like object` *b* and return the number of bytes read.
@@ -516,7 +516,7 @@ I/O Base Classes
A :exc:`BlockingIOError` is raised if the underlying raw stream is in non
blocking-mode, and has no data available at the moment.
- .. method:: readinto1(b)
+ .. method:: readinto1(b, /)
Read bytes into a pre-allocated, writable
:term:`bytes-like object` *b*, using at most one call to
@@ -646,7 +646,7 @@ than raw I/O does.
Return :class:`bytes` containing the entire contents of the buffer.
- .. method:: read1([size])
+ .. method:: read1([size], /)
In :class:`BytesIO`, this is the same as :meth:`~BufferedIOBase.read`.
@@ -724,7 +724,7 @@ than raw I/O does.
Force bytes held in the buffer into the raw stream. A
:exc:`BlockingIOError` should be raised if the raw stream blocks.
- .. method:: write(b)
+ .. method:: write(b, /)
Write the :term:`bytes-like object`, *b*, and return the
number of bytes written. When in non-blocking mode, a
@@ -747,7 +747,7 @@ than raw I/O does.
are guaranteed to be implemented.
-.. class:: BufferedRWPair(reader, writer, buffer_size=DEFAULT_BUFFER_SIZE)
+.. class:: BufferedRWPair(reader, writer, buffer_size=DEFAULT_BUFFER_SIZE, /)
A buffered binary stream providing higher-level access to two non seekable
:class:`RawIOBase` raw binary streams---one readable, the other writeable.
@@ -814,7 +814,7 @@ Text I/O
.. versionadded:: 3.1
- .. method:: read(size=-1)
+ .. method:: read(size=-1, /)
Read and return at most *size* characters from the stream as a single
:class:`str`. If *size* is negative or ``None``, reads until EOF.
More information about the Python-checkins
mailing list