Commit graph

29480 commits

Author SHA1 Message Date
Miss Islington (bot)
2bb1ac2162
[3.13] gh-144837: Improve documentation for more collection methods (GH-144841) (GH-146484)
Use uniform standard signature syntax in the tutorial and in
the array and collections modules documentation.
(cherry picked from commit 17070f41d4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-03-26 19:52:07 +00:00
Miss Islington (bot)
7d565d6ae8
[3.13] gh-146318: Document that signal.SIGSTOP is Unix-only (GH-146319) (#146469)
gh-146318: Document that signal.SIGSTOP is Unix-only (GH-146319)
(cherry picked from commit e44993a665)

Co-authored-by: Jonathan Dung <jonathandung@yahoo.com>
2026-03-26 16:49:46 +01:00
Miss Islington (bot)
f17ed5e9bf
[3.13] gh-74955: Document that __all__ must contain strings in normalization form NFKC (GH-144504) (GH-144520)
(cherry picked from commit c81e1843d4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-03-24 02:01:06 +00:00
Miss Islington (bot)
dbe2500e0e
[3.13] gh-145305: Update ocert.org URLs in docs from http to https (GH-145304) (GH-145323)
(cherry picked from commit 11eec7a492)

Co-authored-by: indoor47 <indoor47@gmail.com>
Co-authored-by: Adam (indoor47) <adamai@agentmail.to>
2026-03-24 02:51:43 +01:00
Łukasz Langa
14b8655cc3
[3.13] gh-140196: Add constructor behavior changes in ast.rst for python 3.13 (GH-140243) (GH-146354)
(cherry picked from commit fae5761a76)

Co-authored-by: Parman Mohammadalizadeh <prmma23@gmail.com>
2026-03-24 02:49:45 +01:00
T. Wouters
684e7af8cd
[3.13] gh-142183: Cache one datachunk per tstate to prevent alloc/dealloc thrashing (GH-145789) (#146123)
* gh-142183: Cache one datachunk per tstate to prevent alloc/dealloc thrashing (GH-145789) (#145828)

Cache one datachunk per tstate to prevent alloc/dealloc thrashing when repeatedly hitting the same call depth at exactly the wrong boundary.

Move new _ts member to the end to not mess up remote debuggers' ideas of the
struct's layout. (The struct is only created by the runtime, and the new
field only used by the runtime, so it should be safe.)

(cherry picked from commit 706fd4ec08)
(cherry picked from commit 19cbcc0f85)
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
2026-03-24 02:27:57 +01:00
Miss Islington (bot)
daa4106426
[3.13] docs: fix f-string in ExceptionGroup example (GH-146108) (GH-146127)
(cherry picked from commit 2c6afb935a)

Co-authored-by: Bartosz Grabowski <58475557+bartosz-grabowski@users.noreply.github.com>
2026-03-24 00:08:07 +01:00
Miss Islington (bot)
ec8e33b99a
[3.13] gh-136672: Docs: Move parts of Enum HOWTO to API Docs (GH-139176) (GH-144803)
To avoid duplicate content in the Enum HOWTO and
API documentation which is not automatically synced,
the section about supported __dunder__ and _sunder
names is moved from HOWTO to API docs.

See also https://github.com/python/cpython/pull/136791
(cherry picked from commit 629a363ddd)

Co-authored-by: Rafael Weingartner-Ortner <38643099+RafaelWO@users.noreply.github.com>
2026-03-23 21:26:01 +01:00
Serhiy Storchaka
fab82679d3
[3.13] gh-146056: Fix repr() for lists containing NULLs (GH-146129) (GH-146155) (GH-146271)
(cherry picked from commit 0f2246b155)
(cherry picked from commit 796513306f)

Co-authored-by: Victor Stinner <vstinner@python.org>
2026-03-22 08:06:17 +00:00
Miss Islington (bot)
5d71935bb3
[3.13] Docs: replace all datetime imports with import datetime as dt (GH-145640) (#146259)
Docs: replace all `datetime` imports with `import datetime as dt` (GH-145640)
(cherry picked from commit 83360b5869)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2026-03-21 18:41:50 +00:00
Miss Islington (bot)
29303db78c
[3.13] gh-138234: clarify returncode behavior for subprocesses created with shell=True (GH-138536) (#146255)
gh-138234: clarify returncode behavior for subprocesses created with `shell=True` (GH-138536)
(cherry picked from commit 8a531f89df)

Co-authored-by: andreuu-tsai <32549555+andreuu-tsai@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2026-03-21 12:38:56 +00:00
Miss Islington (bot)
84c1fa3bcc
[3.13] GH-100108: Add async generators best practices section (GH-141885) (#146253)
GH-100108: Add async generators best practices section (GH-141885)
(cherry picked from commit 897fa231a7)

Co-authored-by: Sergey Miryanov <sergey.miryanov@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2026-03-21 12:06:05 +00:00
Miss Islington (bot)
2705364de2
[3.13] Docs: a brief note in the sets tutorial about order (GH-145984) (#146050)
Docs: a brief note in the sets tutorial about order (GH-145984)
(cherry picked from commit 4f5e79805e)


Docs: a brief note in the sets tut about order

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-17 05:18:16 -04:00
Miss Islington (bot)
e3a2d99f98
[3.13] Docs: remove unmatched parenthesis for asyncio.TaskGroup note (GH-146035) (#146038)
Docs: remove unmatched parenthesis for `asyncio.TaskGroup` note (GH-146035)
(cherry picked from commit 4e96282ee4)

Co-authored-by: trag1c <dev@jakubr.me>
2026-03-16 21:59:03 +01:00
Miss Islington (bot)
8469402083
[3.13] gh-69223: Document that add_argument() returns an Action object (GH-145538) (#145596)
Co-authored-by: Andrew Barnes <bortstheboat@gmail.com>
2026-03-15 14:08:23 +00:00
Miss Islington (bot)
c31903b92e
[3.13] gh-141004: Document PyDTrace* (GH-141856) (GH-145958)
gh-141004: Document `PyDTrace*` (GH-141856)
(cherry picked from commit 1dfe99ae3b)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-03-15 03:05:38 +00:00
Miss Islington (bot)
e11166cda0
[3.13] Docs: fix missing period in Doc/library/stdtypes.rst (GH-145935) (#145937)
Docs: fix missing period in `Doc/library/stdtypes.rst` (GH-145935)
(cherry picked from commit 51e8acf8de)

Co-authored-by: Connor Gibson <connor@nextdoortech.net>
2026-03-14 09:25:21 +00:00
Miss Islington (bot)
17a9c2691e
[3.13] gh-99875: Document rounding mode for old-style formatting (GH-126382) (#145812)
gh-99875: Document rounding mode for old-style formatting (GH-126382)
(cherry picked from commit ce1abaf9b8)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2026-03-11 13:31:51 +00:00
Miss Islington (bot)
3b5c4a2c13
[3.13] Warn that overriding __builtins__ for eval is not a security mechanism (GH-145773) (GH-145807)
(cherry picked from commit eb9ae65e5b)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-11 13:43:12 +01:00
Miss Islington (bot)
eec26ea925
[3.13] gh-101100: Fix sphinx reference warnings around I/O (GH-139592) (#145795)
Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2026-03-11 08:08:51 +00:00
Miss Islington (bot)
973323e6f7
[3.13] gh-106318: Add examples for str.isspace() docs (GH-145399) (#145753)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-03-10 14:26:18 +00:00
Miss Islington (bot)
d12aed1bff
[3.13] Docs: Update programming FAQ (GH-144573) (#145696)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Savannah Ostrowski <savannah@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <stan@ulbrych.org>
2026-03-10 16:17:18 +02:00
Hugo van Kemenade
80204f763c
[3.13] gh-140715: Improve class reference links on datetime.rst (GH-123980) (#145389)
Co-authored-by: edson duarte <eduarte.uatach@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-03-10 13:38:34 +02:00
Miss Islington (bot)
f10a1d80f2
[3.13] Document that PyType_GetModule returns a borrowed ref (GH-145612) (GH-145732)
(cherry picked from commit 44855458a4 via 30bcdcd379)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-03-10 10:32:06 +01:00
Miss Islington (bot)
321daaba4e
[3.13] gh-145701: Fix __classdict__ & __conditional_annotations__ in class-scope inlined comprehensions (GH-145702) (#145711)
* gh-145701: Fix `__classdict__` & `__conditional_annotations__` in class-scope inlined comprehensions (GH-145702)
(cherry picked from commit 63eaaf9599)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

* Add `:oss-fuzz:` macro support

Backports part of 255e79fa95.

---------

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-03-09 14:44:31 -07:00
Miss Islington (bot)
4800aa3076
[3.13] Remove the distutils-sig@python.org email in 'Installing Python Modules' (GH-145613) (#145709)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-03-09 19:49:51 +00:00
Miss Islington (bot)
ae696e7847
[3.13] gh-141617: clarify concurrent.futures.ThreadPoolExecutor deadlock example (GH-141620) (#145687)
gh-141617: clarify `concurrent.futures.ThreadPoolExecutor` deadlock example (GH-141620)

---------
(cherry picked from commit 171133aa84)

Co-authored-by: Yashraj <yashrajpala8@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2026-03-09 16:43:01 +00:00
Miss Islington (bot)
fd7da76ac0
[3.13] gh-145642: Docs: Avoid warning for invalid escape sequence in tutorial (GH-145643) (#145646)
gh-145642: Docs: Avoid warning for invalid escape sequence in tutorial (GH-145643)

---------
(cherry picked from commit 5a15a52dd1)

Co-authored-by: James <snoopjedi@gmail.com>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-09 00:04:57 +01:00
Miss Islington (bot)
26d587b395
[3.13] Remove typo in `functools.lru_cache` docs (GH-140278) (#145627)
Co-authored-by: Brandon Hubacher <brandon.hubacher@gmail.com>
2026-03-07 17:15:16 +00:00
Hugo van Kemenade
0021149a3a
[3.13] Docs: import datetime as dt in examples (GH-145315) (#145584) 2026-03-06 13:49:53 +02:00
Miss Islington (bot)
2ae3c92be1
[3.13] doc: Clarify logger creation example in logging HOWTO (GH-145540) (GH-145561)
(cherry picked from commit e0945443a0)

Co-authored-by: Yash Kaushik <yash005kaushik@gmail.com>
2026-03-06 08:51:02 +00:00
Miss Islington (bot)
0b4f366b5c
[3.13] Docs: use a Sphinx extension to eliminate excessive links (GH-145130) (#145574)
Docs: use a Sphinx extension to eliminate excessive links (GH-145130)
(cherry picked from commit 15f6479c41)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2026-03-06 08:50:06 +02:00
Miss Islington (bot)
0a239ddd39
[3.13] gh-145455: Show output of blurb & sphinx-build version commands (GH-145457) (GH-145462)
In gh-145455, an outdated dependency caused an import error that was not
printed out (`2>&1`); the message instead said that the tools are missing.

Don't redirect stderr, to show warnings and failures.

Also, switch `blurb` to output a version on a single line (`--version` rather
than `help`), and, and don't redirect stdout either.
This results in two version info lines being printed out. These get drowned
in typical Sphinx output, and can be helpful when debugging.
(cherry picked from commit f1de65b366)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-03-03 14:25:13 +01:00
Miss Islington (bot)
182a39799d
[3.13] GH-145450: Document missing wave.Wave_write getter methods (GH-145451) (GH-145467)
(cherry picked from commit db41717cd5)

Co-authored-by: Michiel W. Beijen <mb@x14.nl>
2026-03-03 12:51:20 +00:00
Miss Islington (bot)
5c77c7d944
[3.13] gh-106318: Fix incorrectly rendered code block in str.isalnum() docs (GH-144718) (GH-144729)
(cherry picked from commit f912c835b9)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-03-03 13:13:02 +01:00
Miss Islington (bot)
609a6f43e3
[3.13] Hide "object" prefix on dunders in contextlib docs & selectivly link some more (GH-145436) (#145444)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2026-03-02 21:19:05 +00:00
Miss Islington (bot)
0e57600bb7
[3.13] gh-145269: simplify bisect.bisect doc example (GH-145270) (#145368)
gh-145269: simplify bisect.bisect doc example (GH-145270)



---------
(cherry picked from commit fdb4b3527f)

Co-authored-by: Nathan Goldbaum <nathan.goldbaum@gmail.com>
Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>
2026-03-01 00:20:20 +01:00
Miss Islington (bot)
67f6368e47
[3.13] gh-144693: Clarify that PyFrame_GetBack does not raise exceptions (GH-144824) (GH-145319)
gh-144693: Clarify that `PyFrame_GetBack` does not raise exceptions (GH-144824)
(cherry picked from commit 8775f90017)

Co-authored-by: Taegyun Kim <k.taegyun@gmail.com>
Co-authored-by: Sergey Miryanov <sergey.miryanov@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-02-27 15:31:49 +00:00
Miss Islington (bot)
cb3aba3a89
[3.13] gh-141004: Document missing type flags (GH-145127) (GH-145317)
gh-141004: Document missing type flags (GH-145127)
(cherry picked from commit dc1b56aa03)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-02-27 15:17:22 +00:00
Miss Islington (bot)
083477fbd6
[3.13] gh-106318: Add examples for str.rjust() method (GH-143890) (#145256)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-02-26 13:48:01 +00:00
Peter Bierma
56cc9ba645
[3.13] gh-141004: Document PyModuleDef_Type (GH-145043) (GH-145147)
(cherry picked from commit 24cc998c16)
2026-02-23 15:11:21 +00:00
Miss Islington (bot)
11c61b52d3
[3.13] gh-144694: Fix re.Match.group() doc claiming [1..99] range limit (GH-144696) (#145066)
gh-144694: Fix re.Match.group() doc claiming [1..99] range limit (GH-144696)

The documentation incorrectly stated that numeric group arguments
must be in the range [1..99]. This limit was removed in Python 3.5
(bpo-22437). Replace with "a positive integer" since the next
sentence already documents the IndexError for out-of-range values.
(cherry picked from commit 85021bc247)

Co-authored-by: Mohsin Mehmood <55545648+mohsinm-dev@users.noreply.github.com>
2026-02-21 05:42:39 +00:00
Miss Islington (bot)
c2a1fcbc05
[3.13] gh-144748: Document 3.12 and 3.14 changes to PyErr_CheckSignals (GH-144982) (GH-145063)
* gh-144748: Document 3.12 and 3.14 changes to `PyErr_CheckSignals` (GH-144982)
(cherry picked from commit 06292614ff)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-02-20 19:46:53 -05:00
Stan Ulbrych
6294569259
[3.13] Remove unused :platform: in module's docs (GH-144988) (GH-144998)
It has not been outputted since Sphinx 1.1.
(cherry picked from commit 20caf1c084)
2026-02-19 12:13:53 +00:00
Miss Islington (bot)
cbecfbe792
[3.13] gh-144386: Update equivalent code for "with", "async with" and "async for" (GH-144472) (GH-144946)
They use special method lookup for special methods.
(cherry picked from commit 9e8fa2d4d1)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-02-18 11:22:24 +00:00
Stan Ulbrych
ea07223716
[3.13] Fix typos and grammar errors across documentation (GH-144709) (#144804)
(cherry picked from commit 3718f4be60)

Co-authored-by: Ronald Eddy Jr <ronald_eddy@yahoo.com>
2026-02-17 12:56:29 +00:00
Miss Islington (bot)
e1dbe2263a
[3.13] gh-101100: Resolve reference warnings in reference/ (GH-138418) (#138681)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <stan@ulbrych.org>
2026-02-15 03:06:50 +00:00
Miss Islington (bot)
99a4e55f79
[3.13] gh-144706: Warn against using synchronization primitives within signal handlers (GH-144736) (GH-144768)
gh-144706: Warn against using synchronization primitives within signal handlers (GH-144736)
(cherry picked from commit 945bf8ce1b)

Co-authored-by: Robsdedude <dev@rouvenbauer.de>
2026-02-12 23:21:26 +00:00
Miss Islington (bot)
99cc3d1842
[3.13] gh-57095: Add note about input splitting in datetime.*.strptime (GH-131049) (GH-144734)
(cherry picked from commit 2e3e76e5cd)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-02-12 11:44:42 +01:00
Stan Ulbrych
9a57c932ec
[3.13] Itertools recipes: Replace the tabulate() example with running_mean() (gh-144483) (gh-144722) 2026-02-12 00:24:00 -06:00