Commit graph

13927 commits

Author SHA1 Message Date
Miss Islington (bot)
823b50e1d0
[3.13] gh-115634: document ProcessPoolExecutor max_tasks_per_child bug (GH-140897) (#143303)
gh-115634: document ProcessPoolExecutor max_tasks_per_child bug (GH-140897)
(cherry picked from commit 04899b8539)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2025-12-30 23:32:08 +00:00
Bénédikt Tran
6c9aa94459
[3.13] gh-142994, gh-142996: document missing async generator and coroutine field entries in inspect (GH-142997) (#143287)
(cherry picked from commit 0efbad60e1)

Co-authored-by: wangxiaolei <fatelei@gmail.com>
2025-12-30 10:46:44 +00:00
Miss Islington (bot)
750c3efe82
[3.13] gh-143241: Fix infinite loop in zoneinfo._common.load_data (GH-143243) (#143252)
gh-143241: Fix infinite loop in `zoneinfo._common.load_data` (GH-143243)

Correctly reject truncated TZif files in `ZoneInfo.from_file`.

---------
(cherry picked from commit 3ca1f2a370)

Co-authored-by: Fatih Çelik <fcelik.ft@gmail.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-12-28 15:11:32 +00:00
Miss Islington (bot)
833fbe9ea0
[3.13] no-issue: Fix override value in os.rst (gh-123522) (gh-143212) 2025-12-27 10:55:15 +00:00
Miss Islington (bot)
80f7d493bf
[3.13] gh-140717: Add exc_text to LogRecord attributes table (GH-140718) (GH-143151)
Co-authored-by: Tom Kuson <mail@tjkuson.me>
2025-12-25 12:41:24 +00:00
Gregory P. Smith
9b7a628632
[3.13] gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179) (#143038)
* gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179)

* gh-70647: Better promote how to safely parse yearless dates in datetime.

Every four years people encounter this because it just isn't obvious.
This moves the footnote up to a note with a code example.

We'd love to change the default year value for datetime but doing
that could have other consequences for existing code.  This documented
workaround *always* works.

* doctest code within note is bad, dedent.

* Update to match the error message.

* remove no longer referenced footnote

* ignore the warning in the doctest

* use Petr's suggestion for the docs to hide the warning processing

* cover date.strptime (3.14) as well

* remove date.strptime mentions from 3.14
2025-12-21 07:03:24 +00:00
Miss Islington (bot)
20c3015e85
[3.13] gh-142527: Docs: Clarify that random.seed() discards the sign of an integer input (GH-142483) (#142971)
gh-142527: Docs: Clarify that random.seed() discards the sign of an integer input (GH-142483)

If *a* is an integer, the sign of *a* is discarded in the C source code. Clarify this behavior to prevent foot guns, where a common use case might naively assume that flipping the sign will produce different sequences (e.g. for a train/test split of a synthetic data generator in machine learning).
(cherry picked from commit 610aabfef2)

Co-authored-by: Andrej <andrej.karpathy@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-19 08:35:34 +00:00
Miss Islington (bot)
b5a29553d9
[3.13] gh-118342: [Enum] update docs (GH-137290) (GH-142954)
gh-118342: [Enum] update docs (GH-137290)

(cherry picked from commit e79c39101a)

Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-12-18 11:19:00 -08:00
Miss Islington (bot)
42513a237f
[3.13] gh-142876: remove reference to thread in documentation of asyncio.Queue.shutdown (GH-142888) (#142892)
gh-142876: remove reference to thread in documentation of `asyncio.Queue.shutdown` (GH-142888)
(cherry picked from commit 77c8e6a2b8)

Co-authored-by: Damian Birchler <damian@damianbirchler.net>
2025-12-17 16:53:14 +00:00
Miss Islington (bot)
e5fd7373b8
[3.13] decimal docs: specification link and examples (GH-128698) (#142805)
decimal docs: specification link and examples (GH-128698)
(cherry picked from commit 2450be607c)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: RUANG (James Roy) <longjinyii@outlook.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-12-17 21:42:35 +05:30
Miss Islington (bot)
e4ca817155
[3.13] gh-139320: Cover exception chaining in the docs of contextmanager.__exit__ (GH-140169) (GH-142793)
(cherry picked from commit a44509ea87)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
2025-12-17 11:28:37 +01:00
Miss Islington (bot)
bce4a20195
[3.13] gh-130536: Add details to os.path documentation (GH-130557) (#142801)
Co-authored-by: Arthur Wigo <arthur.l.wigo@gmail.com>
2025-12-16 14:50:58 +00:00
Miss Islington (bot)
3b5c7ba76f
[3.13] gh-83926: BlockingIOError characters_written is byte count (GH-141215) (#142815)
gh-83926: BlockingIOError characters_written is byte count (GH-141215)
(cherry picked from commit e12c744b0a)

Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
2025-12-16 12:04:13 +00:00
Miss Islington (bot)
8f25661ed9
[3.13] gh-142019: Add description about the exponent of result formatted with presentation type 'e' (GH-142084) (#142814)
Co-authored-by: 1nftf <QfxZ11@proton.me>
2025-12-16 12:02:07 +00:00
Miss Islington (bot)
c2d34a1396
[3.13] gh-141218: Fix inaccurate object comparison documentation (GH-141221) (#142811)
Co-authored-by: Mohsin Mehmood <55545648+mohsinm-dev@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-12-16 11:52:38 +00:00
Miss Islington (bot)
11629e0a8c
[3.13] Remove duplicate content in Mapping types - dict documentation (GH-141036) (#142809)
Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
2025-12-16 11:52:07 +00:00
Miss Islington (bot)
2818224ef3
[3.13] gh-106318: Add examples for str.ljust() method (GH-142719) (#142803)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-12-16 11:45:31 +00:00
Miss Islington (bot)
4ad9844f72
[3.13] gh-85204: Improve locale.setlocale example (GH-132683) (#142799)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-12-16 11:32:19 +00:00
Miss Islington (bot)
10738f19cc
[3.13] gh-124864: Extends smtplib documentation on ESMTP options format (GH-132547) (#142797)
Co-authored-by: Patrick R <codeZeilen@users.noreply.github.com>
2025-12-16 11:27:42 +00:00
Miss Islington (bot)
c32a4c14fd
[3.13] gh-142020: ctypes docs: Note that find_library relies on the programs it runs (GH-142134) (GH-142749)
gh-142020: ctypes docs: Note that find_library relies on the programs it runs (GH-142134)
(cherry picked from commit e4d32a3ef9)
2025-12-16 10:56:32 +01:00
Miss Islington (bot)
4a49a11c62
[3.13] gh-85222: Document the global start method side effect in multiprocessing (GH-136426) (#142771)
gh-85222: Document the global start method side effect in multiprocessing (GH-136426)

* Document the ctx parameter in some types in multiprocessing.
* Reduce duplication while still linking to the central explanation from API points with the side effect.
(cherry picked from commit 0978b9a7d5)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: R Chintan Meher <meherrihaan@gmail.com>
2025-12-15 22:18:57 +00:00
Miss Islington (bot)
e72ee65adf
[3.13] gh-106318: Add examples for str.isnumeric() (GH-142680) (#142716)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-12-14 18:57:38 +00:00
decorator-factory
d2ba756912
[3.13] gh-142411: Change documentation to reflect the new docstring adjustments in 3.13 (GH-142413) (#142690) 2025-12-14 14:22:33 +02:00
Miss Islington (bot)
16ce69eab7
[3.13] gh-141938: document treatment of OSError raised by HTTPConnection.getresponse (GH-142339) (#142705)
gh-141938: document treatment of `OSError` raised by `HTTPConnection.getresponse` (GH-142339)
(cherry picked from commit 11aef219f5)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-12-14 10:18:08 +00:00
Miss Islington (bot)
2b7b485c8d
[3.13] gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (#142670)
gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644)
(cherry picked from commit c865ab3781)

Co-authored-by: Joshua Ward <joshie@flewognetworks.wales>
2025-12-13 16:15:21 +00:00
Miss Islington (bot)
60980eeded
[3.13] Use subcommand over sub-command in argparse docs (GH-142488) (#142588)
Use subcommand over sub-command in argparse docs (GH-142488)
(cherry picked from commit 387f88cac1)

Co-authored-by: Savannah Ostrowski <savannah@python.org>
2025-12-11 17:48:30 +00:00
Miss Islington (bot)
3e48fbef98
[3.13] [Docs] Fix typo in bdb: is_skipped_line to is_skipped_module (GH-141771) (#142548)
[Docs] Fix typo in bdb: `is_skipped_line` to `is_skipped_module` (GH-141771)
(cherry picked from commit e5adaafc52)

Co-authored-by: Guo Ci <zguoci@gmail.com>
2025-12-10 22:46:50 +00:00
dr-carlos
d768900ca4
[3.13] gh-141732: Fix ExceptionGroup repr changing when original exception sequence is mutated (GH-141736) (#142391)
* [3.13] gh-141732: Fix `ExceptionGroup` repr changing when original exception sequence is mutated (GH-141736)
(cherry picked from commit ff2577f56e)

Co-authored-by: dr-carlos <77367421+dr-carlos@users.noreply.github.com>
2025-12-08 18:46:55 +00:00
Stan Ulbrych
a12841c197
[3.13] gh-101100: Fix references to the set methods (GH-141857) (GH-142345)
(cherry picked from commit 1d8f3ed2eb)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-12-08 09:50:43 +02:00
Thomas Wouters
03cceb1a51 Merge branch '3.13' of https://github.com/python/cpython into 3.13 2025-12-02 17:44:32 +01:00
Miss Islington (bot)
caf1794b88
[3.13] Document None for timeout argument of select.select (GH-142177)
cherry picked from commit 82274c491a (GH-142182)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-12-02 14:32:04 +01:00
Thomas Wouters
4fd884356d Python 3.13.10 2025-12-02 13:49:50 +01:00
Hugo van Kemenade
5d7cacb1db
[3.13] GH-101100: Remove some entries from `nitpick_ignore` (GH-138464) (#141827)
(cherry picked from commit 22cb9ba8f9)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-01 23:26:32 +01:00
Miss Islington (bot)
6871aa160f
[3.13] gh-141473: Document not calling Popen.wait after Popen.communicate times out. (GH-142101) (#142125)
gh-141473: Document not calling Popen.wait after Popen.communicate times out. (GH-142101)

Document not calling Popen.wait after Popen.communicate times out.

Closes GH-141473
(cherry picked from commit 3e2c557493)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2025-12-01 02:56:30 +00:00
Miss Islington (bot)
bb8984f895
[3.13] Docs: Prepare for Sphinx 9 (GH-142057) (#142092) 2025-11-29 15:52:05 +00:00
Miss Islington (bot)
342c9e0287
[3.13] GH-121970: Remove Docutils list monkeypatch (GH-142056) (#142089) 2025-11-29 14:56:41 +00:00
Miss Islington (bot)
09ceaa606a
[3.13] GH-141963: Clarify argparse documentation (GH-141964) (#142077)
GH-141963: Clarify argparse documentation (GH-141964)

Clarify argparse documentation

Tightens the phrasing for several argparse actions.
(cherry picked from commit cfcd52490d)

Co-authored-by: Moshe Kaplan <mosheekaplan@gmail.com>
2025-11-29 07:29:50 +00:00
Miss Islington (bot)
e76192f260
[3.13] Docs: multi-disk ZIP files -> multipart ZIP files (GH-141962) (#142075)
Docs: multi-disk ZIP files -> multipart ZIP files (GH-141962)

* Remove some old currentlies
* multi-disk -> multipart
* Sentence case headings
(cherry picked from commit 890fe5aad5)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-29 07:18:06 +00:00
Miss Islington (bot)
599093e2e9
[3.13] gh-141994: Warn of XXE vulnerability in documentation of SAX feature xml.sax.handler.feature_external_ges (GH-141996) (#142073)
gh-141994: Warn of XXE vulnerability in documentation of SAX feature `xml.sax.handler.feature_external_ges` (GH-141996)

Doc/library/xml.sax.handler.rst: Warn of XXE with feature_external_ges

Related to commit baa9f33897
(cherry picked from commit 440bcb9456)

Co-authored-by: Sebastian Pipping <sebastian@pipping.org>
2025-11-29 07:14:23 +00:00
Miss Islington (bot)
2f3024f066
[3.13] gh-141473: Fix subprocess.Popen.communicate to send input to stdin upon a subsequent post-timeout call (GH-141477) (#142060)
* gh-141473: Fix subprocess.Popen.communicate to send input to stdin upon a subsequent post-timeout call (GH-141477)

* gh-141473: Fix subprocess.Popen.communicate to send input to stdin
* Docs: Clarify that `input` is one time only on `communicate()`
* NEWS entry
* Add a regression test.

---------
(cherry picked from commit 526d7a8bb4)

Co-authored-by: Artur Jamro <artur.jamro@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

* no assertStartsWith

---------

Co-authored-by: Artur Jamro <artur.jamro@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-11-29 06:53:00 +00:00
Miss Islington (bot)
b2e4234af6
[3.13] gh-106318: Add examples for str.join() (GH-140315) (#141905)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-24 14:59:30 +00:00
Miss Islington (bot)
06db02ff1e
[3.13] gh-106318: Add example for str.format() (GH-137018) (#141903)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2025-11-24 14:57:50 +00:00
Hugo van Kemenade
a676b2e00f
[3.13] gh-106318: Add example for str.isalpha() (GH-137557) (#141902)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-11-24 14:29:49 +00:00
Miss Islington (bot)
e2188c7e5e
[3.13] gh-106318: Add example for str.isascii() (GH-137558) (#141899)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-24 14:08:14 +00:00
Miss Islington (bot)
ce40ad0909
[3.13] gh-106318: Add example for str.isdecimal() (GH-137559) (#141894)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-24 15:19:53 +02:00
Miss Islington (bot)
66576c2be8
[3.13] gh-101100: Fix sphinx warnings in library/unittest.rst (GH-140109) (#141854)
Co-authored-by: Weilin Du <108666168+LamentXU123@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-22 19:22:14 +00:00
Miss Islington (bot)
616117b018
[3.13] gh-101100: Fix all Sphinx warnings in Doc/library/subprocess.rst (GH-139576) (#139788)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-22 19:18:55 +02:00
Miss Islington (bot)
5285ccc19e
[3.13] Docs: Fix typo in socketserver documentation (GH-140956) (#141798)
Co-authored-by: Thomas Ballard <thomasballard0503@gmail.com>
2025-11-20 16:35:54 +00:00
Miss Islington (bot)
26d831327d
[3.13] Correct class name from PullDom to PullDOM (GH-141207) (#141742)
Co-authored-by: Guo Ci <zguoci@gmail.com>
2025-11-19 13:07:07 +02:00
Miss Islington (bot)
8f7188847f
[3.13] gh-140873: Fix the singledispatchmethod documentation (GH-141523) (GH-141710)
It does not support non-descriptor callables yet.
(cherry picked from commit d89eb2f984)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-11-18 11:38:38 +00:00