Commit graph

14129 commits

Author SHA1 Message Date
Miss Islington (bot)
7a6d8d4c95
[3.14] gh-137526: Fix broken link to drdobbs journal in difflib.rst (GH-137527) (#137531)
Co-authored-by: Sebastien Williams-Wynn <s.williamswynn.mail@gmail.com>
2025-08-27 17:02:26 +03:00
Miss Islington (bot)
27a2152a9b
[3.14] gh-44538: Mention nested classes/functions in doctest docs (GH-137870) (#137918)
Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
2025-08-27 17:01:55 +03:00
Miss Islington (bot)
cc38a57233
[3.14] gh-137609: Update signatures of builtins in the documentation (GH-137610) (#138137)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-08-27 16:59:02 +03:00
Miss Islington (bot)
f4af7176c1
[3.14] gh-106318: Add example for str.find() (GH-134529) (#138174)
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-08-27 06:48:49 +00:00
Miss Islington (bot)
271823fdaf
[3.14] gh-135862: add C contiguous one-dimensional buffer requirement to asyncio.StreamWriter docs (GH-137910) (#137912)
gh-135862: add C contiguous one-dimensional buffer requirement to `asyncio.StreamWriter` docs (GH-137910)
(cherry picked from commit 1c3950abc1)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-23 19:27:51 +03:00
Miss Islington (bot)
132b8664b1
[3.14] gh-137847: Add examples for UUIDv6-8 (GH-137848) (#137901)
Co-authored-by: Weilin Du <108666168+LamentXU123@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-08-21 21:36:35 +03:00
Miss Islington (bot)
5923849855
[3.14] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (#137990)
gh-137900: Improve dataclasses frozen parameter documentation (GH-137937)
(cherry picked from commit 7685b8ada8)

Co-authored-by: Tangyuan <47830915@qq.com>
2025-08-20 16:49:43 +03:00
Miss Islington (bot)
3fa5a4beb4
[3.14] gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (GH-137859) (#137908)
Co-authored-by: Bar Harel <bzvi7919@gmail.com>
2025-08-19 14:27:36 +03:00
Miss Islington (bot)
c9e2e15438
[3.14] Emend an error in `string.templatelib` example output (GH-137890) (#137892)
Emend an error in ``string.templatelib`` example output (GH-137890)
(cherry picked from commit 8e3244d39b)

Co-authored-by: Christoph Walcher <christoph-wa@gmx.de>
2025-08-18 14:07:47 +03:00
Miss Islington (bot)
bb4e747654
[3.14] gh-137846: Add missing 'be' to profile doc. (GH-137856) (#137857)
gh-137846: Add missing 'be' to profile doc. (GH-137856)

Insert 'be' into 'will interpreted'.
(cherry picked from commit 3663b2ad54)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-08-16 20:24:17 +03:00
Miss Islington (bot)
cfa5ee5389
[3.14] gh-137777: Disband the 'Program Frameworks' chapter (GH-137796) (#137830)
gh-137777: Disband the 'Program Frameworks' chapter (GH-137796)
(cherry picked from commit eee6589c17)

Co-authored-by: rimchoi <hyerimc858@gmail.com>
2025-08-16 11:04:59 +03:00
Miss Islington (bot)
e817d1aa2b
[3.14] gh-132661: PEP 750 documentation: second pass (GH-137020) (#137392)
gh-132661: PEP 750 documentation: second pass (GH-137020)
(cherry picked from commit 4dae9b1ff1)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-08-16 09:21:29 +03:00
Miss Islington (bot)
a4ef631c5e
[3.14] gh-137760: Update REPL constants documentation (gh-137798) (#137822)
Co-authored-by: Chaemin-Lim <antraxmin@naver.com>
2025-08-15 13:59:57 +00:00
Miss Islington (bot)
bbc92b9219
[3.14] GH-123299: Copyedit 3.14 What's New: Optimizations (GH-137789) (#137813)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-08-15 14:58:12 +03:00
Miss Islington (bot)
36a1e1aaf7
[3.14] gh-137026: Add an explainer guide for asyncio (GH-137215) (#137581)
Co-authored-by: Alexander Nordin <alexander.f.nordin@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-08-15 13:14:39 +03:00
Miss Islington (bot)
bab2a7e982
[3.14] gh-137183: Document that array.array typecode w is new in 3.13 (GH-137184) (#137208)
Co-authored-by: Akuli <akuviljanen17@gmail.com>
2025-08-15 13:13:27 +03:00
Miss Islington (bot)
0696a7526e
[3.14] gh-136437: Convert more `os.path` functions to positional-only in the docs (GH-136970) (#137000)
Co-authored-by: sobolevn <mail@sobolevn.me>
2025-08-15 13:10:59 +03:00
Miss Islington (bot)
daed07a1f9
[3.14] GH-137426: Remove code deprecation of importlib.abc.ResourceLoader (GH-137567) (#137654)
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-08-12 15:47:28 +03:00
Miss Islington (bot)
f180fb956b
[3.14] gh-119711: describe create_datagram_endpoint's behavior in asyncio when local_addr is None (GH-136913) (#137164)
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2025-08-10 16:52:30 +03:00
Miss Islington (bot)
50461821fb
[3.14] gh-137499: Fixed dead link to NIST website (GH-137500) (#137502)
gh-137499: Fixed dead link to NIST website (GH-137500)
(cherry picked from commit 3c1471d971)

Co-authored-by: tobiasjcat <70606111+tobiasjcat@users.noreply.github.com>
2025-08-09 03:31:29 +00:00
Miss Islington (bot)
3df0842de5
[3.14] [Doc] Remove unnecessary quotes from typing module (GH-137207) (#137541)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-08-08 17:31:32 +03:00
Miss Islington (bot)
43d8f527c9
[3.14] Doc: remove unused images (GH-137323) (#137324)
Co-authored-by: Inada Naoki <songofacandy@gmail.com>
2025-08-06 18:39:52 +03:00
Serhiy Storchaka
69fee0c66a
[3.14] gh-137341: Remove more word duplications (GH-137342) (#137346) 2025-08-03 21:26:16 +03:00
Miss Islington (bot)
42b58cfa42
[3.14] gh-119180: Refer to annotationlib.get_annotations() in typing.get_type_hints() documentation (GH-137247) (#137263)
gh-119180: Refer to `annotationlib.get_annotations()` in `typing.get_type_hints()` documentation (GH-137247)
(cherry picked from commit 5e2f0b976a)

Co-authored-by: Victorien <65306057+Viicos@users.noreply.github.com>
2025-07-31 07:07:44 +03:00
Miss Islington (bot)
aab9537cf0
[3.14] gh-136992: Add "None" as valid SameSite value as per RFC 6265bis (GH-137040) (#137140)
Co-authored-by: Iqra Khan <iqraakhan2519@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-07-30 22:43:53 +03:00
Miss Islington (bot)
f607515bc5
[3.14] GH-116738: document thread-safety of bisect (GH-136555) (#137221)
Co-authored-by: Neil Schemenauer <nas-github@arctrix.com>
2025-07-30 22:01:10 +03:00
Miss Islington (bot)
9da008da99
[3.14] gh-132898: Add a note in multiprocessing.Process docs about creating a process in a REPL (GH-137118) (#137154)
Co-authored-by: Duprat <yduprat@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-07-28 22:48:58 +03:00
Miss Islington (bot)
5746e067fd
[3.14] gh-137090: Remove redundant statement in `Doc/library/concurrent.interpreters.rst` (GH-137091) (#137108)
gh-137090: Remove redundant statement in ``Doc/library/concurrent.interpreters.rst`` (GH-137091)
(cherry picked from commit 1e69cd1634)

Co-authored-by: soolabettu <17737361+soolabettu@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-07-25 19:08:28 +03:00
Miss Islington (bot)
c328d140eb
[3.14] Fix code example in annotationlib documentation (GH-136972) (#137002)
Co-authored-by: Victorien <65306057+Viicos@users.noreply.github.com>
2025-07-22 19:15:27 +03:00
Miss Islington (bot)
c59a60bdb4
[3.14] gh-132661: Document t-strings and templatelib (GH-135229) (#136974)
Co-authored-by: Dave Peck <davepeck@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Loïc Simon <loic.pano@gmail.com>
Co-authored-by: pauleveritt <pauleveritt@me.com>
Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
2025-07-22 13:32:00 +03:00
Miss Islington (bot)
ddd3413687
[3.14] gh-136859: Improve StrEnum docs (GH-136864) (#136936)
Co-authored-by: Nacho Caballero <nachocab@gmail.com>
Co-authored-by: Nacho Caballero <nacho.caballero@astrazeneca.com>
Co-authored-by: Antonio Spadaro <ilovelinux@users.noreply.github.com>
2025-07-22 11:32:09 +03:00
Miss Islington (bot)
d5d3adafa7
[3.14] gh-135468: Improve `BaseHandler.http_error_default()` parameter descriptions (GH-136797) (#136825)
Co-authored-by: Valerio Gianella <49408327+valeriogianella@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-07-22 11:29:40 +03:00
Miss Islington (bot)
caef946a25
[3.14] gh-136170: Revert adding ZipFile.data_offset (GH-136950) (#136955)
gh-136170: Revert adding `ZipFile.data_offset` (GH-136950)

* Revert "gh-84481: Make ZipFile.data_offset more robust (GH-132178)"

This reverts commit 6cd1d6c6b1.

* Revert "gh-84481: Add ZipFile.data_offset attribute (GH-132165)"

This reverts commit 0788948dcb.

---------
(cherry picked from commit 6bf1c0ab34)

Co-authored-by: Emma Smith <emma@emmatyping.dev>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-07-21 20:35:41 -07:00
Miss Islington (bot)
fa9a369044
[3.14] gh-136437: Document os.path.dirname as accepting only pos-only (GH-136946) (#136947)
gh-136437: Document `os.path.dirname` as accepting only pos-only (GH-136946)
(cherry picked from commit 3224429450)

Co-authored-by: sobolevn <mail@sobolevn.me>
2025-07-21 18:29:22 +00:00
Miss Islington (bot)
81edfb7140
[3.14] GH-136874: url2pathname(): discard query and fragment components (GH-136875) (#136942)
GH-136874: `url2pathname()`: discard query and fragment components (GH-136875)

In `urllib.request.url2pathname()`, ignore any query or fragment components
in the given URL.
(cherry picked from commit 80b2d60a51)

Co-authored-by: Barney Gale <barney.gale@gmail.com>
2025-07-21 19:08:07 +01:00
Miss Islington (bot)
aa17c39339
[3.14] gh-136437: Document some os.path functions as requiring pos-only (GH-136812) (#136944)
gh-136437: Document some `os.path` functions as requiring pos-only (GH-136812)
(cherry picked from commit b5428bb0e7)

Co-authored-by: sobolevn <mail@sobolevn.me>
2025-07-21 18:07:56 +00:00
Miss Islington (bot)
0d87bb66d3
[3.14] gh-121028: Soft-deprecate sys.api_version (GH-136463) (GH-136928)
(cherry picked from commit 658599c15d)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-07-21 12:29:51 +00:00
Miss Islington (bot)
17c5959aa3
[3.14] GH-130645: Default to color help in argparse (GH-136809) (#136886)
GH-130645: Default to color help in argparse (GH-136809)
(cherry picked from commit acbe896cb1)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-07-20 15:22:53 -07:00
Miss Islington (bot)
2caae152b9
[3.14] gh-86608: Improve and restructure tarfile examples (GH-121771) (#136866)
gh-86608: Improve and restructure tarfile examples (GH-121771)

Add an example on how to write a tarfile to stdout; general improvements.
(cherry picked from commit cc81b4e501)

Co-authored-by: Dominic H <dom@dominic.sk>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-07-20 14:16:19 +01:00
Miss Islington (bot)
2cb3b534e7
[3.14] gh-108362: Retarget incremental GC changes to 3.14 (GH-125453) (#136851)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-07-20 14:28:17 +03:00
Miss Islington (bot)
f8af7cb723
[3.14] gh-136752: Clarify documentation for `IPv{N}Address.is_reserved` (GH-136794) (#136827)
gh-136752: Clarify documentation for ``IPv{N}Address.is_reserved`` (GH-136794)
(cherry picked from commit 6293d8a1a6)

Co-authored-by: Matthieu Lienart <50069805+mlnrt@users.noreply.github.com>
Co-authored-by: Matthieu Lienart <matthieu.lienart@axians.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-07-19 14:50:30 +00:00
Miss Islington (bot)
8d063f3d92
[3.14] gh-54732: Make argparse error caused by empty rows in option files explicit (GH-136795) (#136818)
gh-54732: Make argparse error caused by empty rows in option files explicit (GH-136795)
(cherry picked from commit 8ffc3ef01e)

Co-authored-by: jdunter <2ve@mailbox.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-07-19 14:28:52 +00:00
Miss Islington (bot)
03457ca2ac
[3.14] gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803) (GH-136806)
gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803)

Add a copy of the text from SimpleQueue.close()

---------
(cherry picked from commit f575588ccf)

Co-authored-by: aggshruti99 <aggshruti99@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-07-19 14:57:52 +02:00
Miss Islington (bot)
8b4275c99a
[3.14] gh-136769: Include fixed-width integers in the fundamental data types table (GH-136784) (#136785)
gh-136769: Include fixed-width integers in the fundamental data types table (GH-136784)

Fixed-sized types, like ``c_int32``, are currently missing from the fundamental data types table
in the ``ctypes`` documentation. This commit adds them, and  notes that ``c_[u]int8`` is an alias
of ``c_[u]byte``.
(cherry picked from commit acefb978dc)

Co-authored-by: Sina Zel taat <111974143+SZeltaat@users.noreply.github.com>
2025-07-19 10:26:22 +00:00
Miss Islington (bot)
ba6ea7c53d
[3.14] gh-74598: document that fnmatch.filterfalse is affected by cache limitation (GH-136781) (#136782)
gh-74598: document that `fnmatch.filterfalse` is affected by cache limitation (GH-136781)
(cherry picked from commit 263e451c41)

Co-authored-by: Gergely Elias <gergely.elias@gmail.com>
2025-07-19 09:56:55 +00:00
Miss Islington (bot)
aeeacdb8b5
[3.14] Docs: Improve example for `itertools.batched()` (GH-136775) (#136778)
Docs: Improve example for ``itertools.batched()`` (GH-136775)

The current example `batched('ABCDEFG', n=3) → ABC DEF G` can confuse readers because both, the size of the tuples and the number of tuples are 3.
By using a batch size of n=2, it is clearer that the `n` argument refers to the size of the resulting tuples.
I.e. the new example is: `batched('ABCDEFG', n=2) → AB CD EF G`
(cherry picked from commit 3eecc72ac7)

Co-authored-by: RafaelWO <38643099+RafaelWO@users.noreply.github.com>
2025-07-19 09:36:35 +00:00
Miss Islington (bot)
2ea3b75200
[3.14] gh-136697: Use the standard audit event format for sys.monitoring docs (GH-136747) (#136749)
gh-136697: Use the standard audit event format for sys.monitoring docs (GH-136747)
(cherry picked from commit 28937d3a21)

Co-authored-by: Tian Gao <gaogaotiantian@hotmail.com>
2025-07-17 12:00:09 -07:00
Miss Islington (bot)
2ce207108c
[3.14] Improved venv docs to indicate that isolation is the default. (GH-136698) (GH-136705)
(cherry picked from commit 8e2f4b4483)
Co-authored-by: Facundo Batista <facundo@taniquetil.com.ar>
Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2025-07-17 11:24:54 +01:00
Miss Islington (bot)
6943d8ef27
[3.14] gh-126548: Add a thread-unsafety warning for importlib.reload() (GH-136704) (GH-136723)
gh-126548: Add a thread-unsafety warning for `importlib.reload()` (GH-136704)
(cherry picked from commit 69d8fe50dd)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
2025-07-16 16:40:11 +00:00
Miss Islington (bot)
323974295d
[3.14] Fix index entry and anchor for module.__test__ (GH-136674) (GH-136688)
It was "doctest.module attribute". Now it is "module attribute".
(cherry picked from commit 7689407fa4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-07-15 15:58:52 +00:00