Commit graph

29373 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
Miss Islington (bot)
4d42e1c282
[3.13] gh-143284: Temporarily install Sphinx<9 to fix Chinese search (GH-143286) (#143291)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-12-30 12:37:47 +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)
7fc3aa5575
[3.13] gh-69686: Remove untrue part of __import__ replacement docs (GH-143261) (#143282)
gh-69686: Remove untrue part of `__import__` replacement docs (GH-143261)

Remove untrue part of `__import__` replacement docs

The original statement effectively says that replacing `__import__` at global scope affects import statements, and not only that, but only import statements within the rest of the executing module. None of that has been true since at least Python 2.7, I think.

This was likely missed in python/cpython#69686.
(cherry picked from commit 79c03ac001)

Co-authored-by: Thanos <111999343+Sachaa-Thanasius@users.noreply.github.com>
2025-12-30 05:22:47 +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
Pablo Galindo Salgado
de34f6d404
[3.13] gh-143228: Fix UAF in perf trampoline during finalization (GH-143233) (#143248) 2025-12-28 14:32:16 +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
Hugo van Kemenade
c5852c27c1
[3.13] Update pre-commit with zizmor and Ruff fixes (GH-143095) (GH-143102) (#143113) 2025-12-23 21:28:00 +02:00
Hugo van Kemenade
7dc6acc1e9
[3.13] gh-84232: Fix pydoc docs.python.org link generation (GH-139995) (#143099)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Éric <merwok@netwok.org>
2025-12-23 18:29:28 +02: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
Lysandros Nikolaou
90285941d8
[3.13] gh-140374: Add glossary entries related to multithreading (GH-140375) (#142869)
---------
(cherry picked from commit 1e9a0ee682)

Co-authored-by: Daniele Parmeggiani <8658291+dpdani@users.noreply.github.com>
2025-12-17 12:22:33 +01:00
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)
1baa315222
[3.13] Correct Glossary key function example to use str.casefold instead of str.lower (GH-140316) (#142806)
Co-authored-by: Cameron Beck <94604154+cbkinase@users.noreply.github.com>
2025-12-16 11:50:02 +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)
aa07232c6a
[3.13] Add 'Show translation source' to docs sidebar (GH-130355) (#142687)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Maciej Olko <maciej.olko@affirm.com>
2025-12-13 23:09:13 +00:00
Miss Islington (bot)
450f863ea6
[3.13] Add missing comma to tuple in except* docs (GH-142395) (#142684)
Co-authored-by: dr-carlos <77367421+dr-carlos@users.noreply.github.com>
2025-12-13 22:57:22 +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
Miss Islington (bot)
2c3e3ef6a2
[3.13] gh-123241: Document restrictions for tp_traverse implementations (gh-142272) (#142422)
(cherry picked from commit 37988c57ea)

Co-authored-by: Sam Gross <colesbury@gmail.com>
2025-12-08 17:28:21 +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
Stan Ulbrych
8d920ac1a5
[3.13] GH-138562: Remove `sort()` from the common sequence methods in the data model (GH-138563) (#140676)
(cherry picked from commit d0c9943869)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-01 23:29:13 +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)
f61e9fcdb6
[3.13] gh-141004: Document descriptor and dict proxy type objects (GH-141803) (GH-142148)
gh-141004: Document descriptor and dict proxy type objects (GH-141803)
(cherry picked from commit 52f9b5f580)

Co-authored-by: Yashraj <yashrajpala8@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-12-01 15:57:53 +00:00
Miss Islington (bot)
69fbef0d60
[3.13] Docs: Upgrade Sphinx to 9.0 (GH-142114) (#142129)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-01 11:23:13 +00: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)
42c6e75ba1
[3.13] Improve clarity in tutorial introduction (GH-140669) (#142113)
Co-authored-by: Thierry Martos <81799048+ThierryMT@users.noreply.github.com>
2025-11-30 12:53:10 +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