]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
gh-129011: Update docs for Raw I/O read, readinto, and write (#135328)
authorCody Maloney <cmaloney@users.noreply.github.com>
Fri, 5 Jun 2026 12:00:59 +0000 (05:00 -0700)
committerGitHub <noreply@github.com>
Fri, 5 Jun 2026 12:00:59 +0000 (14:00 +0200)
commite4db68b9c990ed1bb7562094bee2e73f4450d42b
treeac180af98ebe7aa4042e7931ef784b6fa6a1fbbf
parent2f064fbc0b427f0e1c83fe9b9036531ed16e95e8
gh-129011: Update docs for Raw I/O read, readinto, and write (#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"

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