summaryrefslogtreecommitdiffstats
path: root/Doc/library/io.rst
Commit message (Collapse)AuthorAgeFilesLines
* gh-91485: Avoid unnecessary use of non-Python syntax in io docs (GH-101177)Miss Islington (bot)2023-01-201-2/+2
| | | | | (cherry picked from commit 783d1bc51b886b6135e6a4effb91be207df5f50a) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [3.10] gh-95691: Doc BufferedWriter and BufferedReader (GH-95703) (#97948)Miss Islington (bot)2022-10-061-1/+1
| | | | | | | | gh-95691: Doc BufferedWriter and BufferedReader (GH-95703) (cherry picked from commit 0d68879104dfb392d31e52e25dcb0661801a0249) Co-authored-by: 180909 <734461790@qq.com> Co-authored-by: 180909 <734461790@qq.com>
* gh-86986: Drop compatibility support for Sphinx 2 (GH-93737)Miss Islington (bot)2022-06-211-1/+1
| | | | | | | | | | | | * Revert "bpo-42843: Keep Sphinx 1.8 and Sphinx 2 compatibility (GH-24282)" This reverts commit 5c1f15b4b1024cbf0acc85832f0c623d1a4605fd * Revert "bpo-42579: Make workaround for various versions of Sphinx more robust (GH-23662)" This reverts commit b63a620014b67a6e63d10783149c41baaf59def8. (cherry picked from commit 0efe3a1636c143fe0694a8e4d25d6eae19e0d618) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* gh-85864: io docs: Add missing position-only parameters (GH-91950)Miss Islington (bot)2022-04-301-17/+17
| | | | | (cherry picked from commit 3a8e2b6e65fea1252477f6e29a384fa9a492ed06) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-85864: Mark positional-only args in io docs (GH-91683)Miss Islington (bot)2022-04-231-10/+10
| | | | | (cherry picked from commit a3f2cf3ced378db2569df4e7389ec1f79c85d55c) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* bpo-25415: Remove confusing sentence from IOBase docstrings (PR-31631)Miss Islington (bot)2022-03-041-7/+4
| | | | | (cherry picked from commit cedd2473a9bebe07f3ced4f341cf58a2fef07b03) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* Fix typo in io.rst (GH-30218)Miss Islington (bot)2021-12-261-1/+1
| | | | | (cherry picked from commit f9a4352056175d96195d4cb54c97c1334ea5150c) Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>
* bpo-43126: Expand docs on io.IOBase.readlines() method (GH-27061) (GH-27113)Miss Islington (bot)2021-07-131-0/+3
| | | | | | Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 3b5b99da4b256a31933112f4a2385386149c19e1) Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* bpo-43510: Implement PEP 597 opt-in EncodingWarning. (GH-19481)Inada Naoki2021-03-291-0/+81
| | | | | | | | | | | See [PEP 597](https://www.python.org/dev/peps/pep-0597/). * Add `-X warn_default_encoding` and `PYTHONWARNDEFAULTENCODING`. * Add EncodingWarning * Add io.text_encoding() * open(), TextIOWrapper() emits EncodingWarning when encoding is omitted and warn_default_encoding is enabled. * _pyio.TextIOWrapper() uses UTF-8 as fallback default encoding used when failed to import locale module. (used during building Python) * bz2, configparser, gzip, lzma, pathlib, tempfile modules use io.text_encoding(). * What's new entry
* Doc: io: Remove "In-memory streams" section (GH-24927)Inada Naoki2021-03-251-10/+0
|
* bpo-42843: Keep Sphinx 1.8 and Sphinx 2 compatibility (GH-24282)Julien Palard2021-01-251-1/+1
|
* [doc] Fix erroneous backslashes in signatures and names (GH-23658)Andre Delfino2020-12-171-1/+1
| | | | | The issue being resolved is shown in the 3.10 docs (if you select docs for older versions you won't see a visual glitch). The newer sphinx version that produces the 3.10 docs doesn't treat the backslash to escape things in some situations it previously did.
* bpo-39691: Clarify io.open_code behavior (GH-19824)Shantanu2020-05-011-4/+5
|
* Improve the io module documentation (GH-15099)Géry Ogam2019-09-111-55/+61
| | | | | | | | | | * Update io.rst * Apply suggestions from code review Co-Authored-By: Ashwin Ramaswami <aramaswamis@gmail.com> Co-Authored-By: Carol Willing <carolcode@willingconsulting.com>
* Document default parameter of .seek() in the signature. (GH-14691)Benjamin Peterson2019-07-111-2/+2
|
* bpo-37390: Add audit event table to documentations (GH-14406)Steve Dower2019-06-271-1/+1
| | | Also updates some (unreleased) event names to be consistent with the others.
* bpo-37363: Add audit events for a range of modules (GH-14301)Steve Dower2019-06-241-1/+1
|
* Add missing single quote in io.TextIOWrapper.reconfigure documentation ↵Harmon2019-06-191-1/+1
| | | | | (GH-14246) Add a missing single quote character in the documentation for `io.TextIOWrapper.reconfigure`.
* bpo-36842: Implement PEP 578 (GH-12613)Steve Dower2019-05-231-0/+21
| | | Adds sys.audit, sys.addaudithook, io.open_code, and associated C APIs.
* Indicate that seek and tell are mandatory on BufferedRandom. (GH-11216)Christopher Head2019-04-121-3/+3
| | | | | | | For BufferedReader and BufferedWriter, seek and tell operations are optional (they may or may not exist based on the underlying stream). For BufferedRandom, they are mandatory: a BufferedRandom should not be constructed over an unseekable underlying stream. Document this.
* closes bpo-35848: Move all documentation regarding the readinto out of ↵Steve Palmer2019-04-091-8/+6
| | | | | | | IOBase. (GH-11893) Move all documentation regarding the readinto method into either io.RawIOBase or io.BufferedIOBase. Corresponding changes to documentation in the _pyio.py module.
* bpo-36006: Fix versionchanged directive alignment in io module documentation ↵Emmanuel Arias2019-02-151-2/+2
| | | | | (GH-11881) https://bugs.python.org/issue36006
* bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)Serhiy Storchaka2018-12-191-1/+1
|
* Minor grammar improvement to io documentation. (GH-10329)Srinivas Thatiparthy (శ్రీనివాస్ తాటిపర్తి)2018-11-121-1/+1
| | | Independently of -> Independent of
* bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037)Stéphane Wirtel2018-10-261-1/+1
|
* bpo-33804: Document that the argument for io.TextIOBase.read() is optional ↵Andrés Delfino2018-07-071-1/+1
| | | | (GH-7510)
* bpo-22069: Update TextIO documentation (GH-6609)Elena Oat2018-05-141-1/+1
| | | Clarify that flush is implied when the call to write contains a newline character.
* bpo-15216: io: TextIOWrapper.reconfigure() accepts encoding, errors and ↵INADA Naoki2017-12-211-5/+13
| | | | newline (GH-2343)
* bpo-22671: Clarify and test default read method implementations (#4568)Sanyam Khurana2017-12-111-5/+8
| | | Original patch written by Martin Panter, enhanced by Sanyam Khurana.
* Fix bpo-30526: Add TextIOWrapper.reconfigure() and a ↵Antoine Pitrou2017-06-031-0/+18
| | | | | | | | | | TextIOWrapper.write_through attribute (#1922) * Fix bpo-30526: Add TextIOWrapper.reconfigure() * Apply Nick's improved wording * Update Misc/NEWS
* Issue #23214: Fix formatting of -1Martin Panter2016-10-211-1/+1
|
* Issue #23214: Implement optional BufferedReader, BytesIO read1() argumentMartin Panter2016-10-201-6/+15
|
* Issue #19795: Improved more markups of True/False.Serhiy Storchaka2016-10-191-1/+1
|
* Issue #22558: Add remaining doc links to source code for Python-coded modules.Terry Jan Reedy2016-06-111-0/+5
| | | | | Reformat header above separator line (added if missing) to a common format. Patch by Yoni Lavi.
* Issue #20699: Document that “io” methods accept bytes-like objectsMartin Panter2016-05-281-16/+27
| | | | | | | | This matches the usage of ZipFile and BufferedWriter. This still requires return values to be bytes() objects. Also document and test that the write() methods should only access their argument before they return.
* Issue #27036: Fixed formatting references to "bytes-like object" in plural.Serhiy Storchaka2016-05-181-1/+1
|
* Issue #22413: Merge StringIO doc from 3.4 into 3.5Martin Panter2015-10-101-4/+12
|\
| * Issue #22413: Document newline effect on StringIO initializer and getvalueMartin Panter2015-10-101-4/+12
| | | | | | | | Also add to comment in the C code.
* | whatsnew/3.5: Sync whatsnew with versionadded/versionchanged doc tagsYury Selivanov2015-09-111-1/+1
| |
* | Issue #25030: Merge seek() doc fixes from 3.4 into 3.5Martin Panter2015-09-111-6/+7
|\ \ | |/
| * Issue #25030: Do not document seek() as if it accepts keyword argumentsMartin Panter2015-09-111-6/+7
| | | | | | | | Patch from Shiyao Ma.
* | Issue #23668: Adds support for os.truncate and os.ftruncate on WindowsSteve Dower2015-03-211-2/+5
| |
* | Issue #23099: Closing io.BytesIO with exported buffer is rejected now toSerhiy Storchaka2015-02-031-6/+7
|\ \ | |/ | | | | prevent corrupting exported buffer.
| * Issue #23099: Closing io.BytesIO with exported buffer is rejected now toSerhiy Storchaka2015-02-031-6/+7
| | | | | | | | prevent corrupting exported buffer.
* | Issue #22286: The "backslashreplace" error handlers now works withSerhiy Storchaka2015-01-251-5/+6
| | | | | | | | decoding and translating.
* | Issue #19676: Added the "namereplace" error handler.Serhiy Storchaka2014-11-251-3/+4
| |
* | Issue #17401: document closefd in io.FileIO docs and add to reprRobert Collins2014-10-181-2/+5
| | | | | | | | | | | | | | | | | | | | closefd was documented in the open docs but not the matching FileIO class documented. Further, closefd, part of the core state for the object was not shown. In review it was noted that the open docs are a little confusing about the interaction between closefd and paths, so tweaked them at the same time.
* | Closes #22004: Merge with 3.4Zachary Ware2014-07-181-1/+1
|\ \ | |/
| * Issue #22004: Correct an argument name.Zachary Ware2014-07-181-1/+1
| |
* | reflow to 80 charsBenjamin Peterson2014-06-221-13/+12
| |