]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
[3.13] gh-129011: Update docs for Raw I/O read, readinto, and write (GH-135328) ...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Fri, 5 Jun 2026 12:07:39 +0000 (14:07 +0200)
committerGitHub <noreply@github.com>
Fri, 5 Jun 2026 12:07:39 +0000 (12:07 +0000)
commit0918ad4b0fb8cb5058e499095b54b0e23ac76bbb
tree5ffd081b2de01b917f0ccaef16d3dd4071c6c518
parent68250323fcd5e432988aa1547be0049e517e8786
[3.13] gh-129011: Update docs for Raw I/O read, readinto, and write (GH-135328) (#150959)

gh-129011: Update docs for Raw I/O read, readinto, and write (GH-135328)

Update `RawIOBase` and `FileIO` documentation to match implementation
behavior around `.read`, `.readinto`, `.readall` and `.write`.

In particular:

 - They may make more than one system call (PEP-475)
 - Add warnings if `.write()` requires a wrapping retry loop (see: gh-126606)
    - "Raw I/O" `.write`` may not write all bytes
    - `buffering=0` example results in a "Raw I/O"
(cherry picked from commit e4db68b9c990ed1bb7562094bee2e73f4450d42b)

Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Doc/library/io.rst