Commit graph

28921 commits

Author SHA1 Message Date
Miss Islington (bot)
19b31d10c2
[3.13] GH-106235: Clarify parse_known_args documentation by removing "remaining" (GH-126921) (#134914)
GH-106235: Clarify `parse_known_args` documentation by removing "remaining" (GH-126921)
(cherry picked from commit a4251411a9)

Co-authored-by: Savannah Bailey <savannahostrowski@gmail.com>
2025-05-30 13:24:22 -07:00
Miss Islington (bot)
7c5a1ea9f6
[3.13] gh-134733: Fix documentation for the show_empty option of ast.dump() (GH-134925) (GH-134941)
Optional None values are always omitted.
(cherry picked from commit 1a89991d23)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-05-30 19:30:26 +03:00
Miss Islington (bot)
7fdc829bc2
Doc: remove unnecessary section header (GH-134917)
(cherry picked from commit b367e27af9)
2025-05-30 18:14:00 +09:00
Miss Islington (bot)
f4b8cd5510
[3.13] ast docs: Fix description of ast.Constant (GH-134741) (#134912)
Contrary to the current docs, ast.Constant will never hold containers
such as frozenset or tuple; the Python parser only emits it for simple
literals.

For precision, add the exact list of types that may be contained in an
ast.Constant.
(cherry picked from commit 381020d41f)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2025-05-30 04:19:04 +00:00
Miss Islington (bot)
a9ba2ecae5
[3.13] gh-133260: Remove claim that PyUnicode_InternFromString immortalizes (GH-134213) (GH-134884)
(cherry picked from commit 4109a9c6b3)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-05-29 13:44:00 +00:00
Miss Islington (bot)
aebb4eab45
[3.13] gh-69011: : clarify & deduplicate ctypes.create_*_buffer docs (GH-132858) (GH-134882)
This adds a warning about the possibly-missing NUL terminator, but in a way
that doesn't make it sound like a bug/wart.
(cherry picked from commit b783e1791b)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-05-29 13:22:33 +00:00
Miss Islington (bot)
9cd608f999
[3.13] GH-134848: Use a set to store `AuditEvents.sources` (GH-134849) (#134854)
GH-134848: Use a set to store ``AuditEvents.sources`` (GH-134849)
(cherry picked from commit b265a7ddeb)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-05-28 16:36:59 +00:00
Miss Islington (bot)
8e60e6ca84
[3.13] gh-134817: Document [Timed]RotatingFileHandler shouldRollover method (GH-134818) (GH-134824)
(cherry picked from commit 7be5916f6d)
2025-05-28 12:32:57 +00:00
Miss Islington (bot)
067df2b95c
[3.13] gh-134160: Block multiple module initialization (GH-134773) (#134828)
gh-134160: Block multiple module initialization (GH-134773)
(cherry picked from commit 469a56470b)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-05-28 07:59:20 +00:00
Miss Islington (bot)
956490b8a5
[3.13] Update outdated statement from math about C standard (GH-134621) (#134826)
Update outdated statement from `math` about C standard (GH-134621)
(cherry picked from commit 21672b694b)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-05-28 07:36:24 +00:00
Miss Islington (bot)
73e432896b
[3.13] gh-134789: Document del s[i] operation for mutable sequences (GH-134804) (#134809)
gh-134789: Document del s[i] operation for mutable sequences (GH-134804)

[main] Update stdtypes.rst

- Added explicit mention of `del s[i]` (item deletion by index) to the Mutable Sequence Types section.
- Clarified that this operation removes the item at the specified index from the sequence.
- Addresses issue GH-134789.
(cherry picked from commit 967f361993)

Co-authored-by: Rishabh Singh <67859818+rishabh11336@users.noreply.github.com>
2025-05-27 18:54:16 +00:00
Miss Islington (bot)
d6e4786937
[3.13] gh-133678: Document C API third party tools (GH-134526) (#134792)
gh-133678: Document C API third party tools (GH-134526)
(cherry picked from commit c3c88064f5)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Steve Dower <steve.dower@python.org>
2025-05-27 15:44:44 +00:00
Miss Islington (bot)
a5f281f4e4
[3.13] gh-134664: document cleanup_socket parameter in asyncio.start_unix_server (GH-134750) (#134780)
gh-134664: document `cleanup_socket` parameter in `asyncio.start_unix_server` (GH-134750)
(cherry picked from commit 92ea1eb38f)

Co-authored-by: Shamil <ashm.tech@proton.me>
2025-05-27 14:04:29 +05:30
Miss Islington (bot)
480f02dafa
[3.13] gh-134160: Use multi-phase init in documentation examples (GH-134296) (#134754)
gh-134160: Use multi-phase init in documentation examples (GH-134296)
(cherry picked from commit 96905bdd27)

Co-authored-by: neonene <53406459+neonene@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-05-26 21:50:19 +00:00
Miss Islington (bot)
b31d46e880
[3.13] gh-134559: Add versionadded for `object.__replace__()` (GH-134672) (#134700)
gh-134559: Add versionadded for ``object.__replace__()`` (GH-134672)
(cherry picked from commit 71290a6fbe)

Co-authored-by: tmlnv <108088921+tmlnv@users.noreply.github.com>
2025-05-26 10:29:53 +00:00
Miss Islington (bot)
f331d03e88
[3.13] Fix sphinx-lint warnings (default-role used). (GH-134647) (#134669)
Fix sphinx-lint warnings (default-role used). (GH-134647)
(cherry picked from commit 24a47155d2)

Co-authored-by: Julien Palard <julien@palard.fr>
2025-05-25 19:29:38 +00:00
Miss Islington (bot)
698bf97274
[3.13] gh-134595: Update HOWTO to reflect change in CIBW option (GH-134598) (#134623)
Co-authored-by: Jasper Wong <111284156+3willows@users.noreply.github.com>
2025-05-24 07:21:14 +00:00
Miss Islington (bot)
44d184984d
[3.13] gh-80334: fix multiprocessing.freeze_support for other spawn platforms (GH-134462) (#134620)
gh-80334: fix multiprocessing.freeze_support for other spawn platforms (GH-134462)

Doc/library/multiprocessing.rst: freeze_support: Change to specify spawn method instead of platform
Have multiprocessing.freeze_support() enable on spawn, not just win32.

---------
(cherry picked from commit 80284b5c5e)

Co-authored-by: Eddy Mulyono <eddymul@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-05-24 04:13:37 +00:00
Miss Islington (bot)
1dbb644a5b
[3.13] gh-106318: Add example for str.count() (GH-134519) (#134573)
Co-authored-by: Blaise Pabon <blaise@gmail.com>
2025-05-23 09:53:19 +00:00
Miss Islington (bot)
5b203f511b
[3.13] gh-106318: Add example for str.center() (GH-134518) (#134572)
Co-authored-by: Blaise Pabon <blaise@gmail.com>
2025-05-23 09:50:17 +00:00
Miss Islington (bot)
c6497d632d
[3.13] Add notes on nogil & reinitialization to the Opt-Out section in Module Isolation HOWTO (GH-134141) (GH-134491)
Add notes on nogil & reinitialization to the Opt-Out section in Module Isolation HOWTO (GH-134141)
(cherry picked from commit 1f0a294e8c)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Sam Gross <colesbury@gmail.com>
2025-05-23 10:46:58 +02:00
Miss Islington (bot)
1a61d81544
[3.13] Docs: fix link in free-threading-python.rst (GH-134548) (#134556) 2025-05-23 00:43:26 +00:00
Miss Islington (bot)
b212653049
[3.13] Avoid __file__ in hashlib example (GH-134540) (#134550)
Avoid `__file__` in `hashlib` example (GH-134540)
(cherry picked from commit 9b292ff022)

Co-authored-by: Josh Cannon <joshdcannon@gmail.com>
2025-05-22 21:38:04 +00:00
Kattni
79f20f1191
[3.13] Docs: Add note to tutorial clarifying scope (GH-134534) (#134545)
(cherry picked from commit 742d5b5c5d)
2025-05-23 00:04:10 +03:00
Miss Islington (bot)
0671eb6c09
[3.13] Consistent sentence case in docs template files (GH-134412) (#134496)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-05-22 12:58:05 +03:00
Gregory P. Smith
5ecc39e9f4
[3.13] gh-80050: Update BufferedReader.read docs around non-blocking (GH-130653) (#134445)
(cherry picked from commit e1f891414b)

Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
2025-05-21 17:07:03 +00:00
Miss Islington (bot)
bc60b33745
[3.13] gh-132246: Add special buffer methods to C API Type Object docs (gh-132247) (gh-134427)
Two special methods, __buffer__ and __release_buffer__ were added to
Python 3.12 by PEP 688. The C API Type Object documentation for slots
includes `tp_as_buffer`, and sub-slots `bf_getbuffer`, `bf_releasebuffer`
but does not refer to the Python Data Model version of those. Add the
missing references.
(cherry picked from commit b529b60fc2)

Co-authored-by: Cody Maloney <cmaloney@users.noreply.github.com>
2025-05-21 16:34:13 +02:00
Miss Islington (bot)
fcebf5aebf
[3.13] gh-110631: Fix some incorrect indents in the documentation (GH-129312) (#134420)
Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
2025-05-21 14:00:13 +00:00
Miss Islington (bot)
7df6749219
[3.13] gh-85045: clarified that the underlying buffer of a TextIOBase can be a RawIOBase (GH-134372) (#134375)
gh-85045: clarified that the underlying buffer of a TextIOBase can be a RawIOBase (GH-134372)

Added a clarification that the underlying binary buffer of a TextIOBase can be a BufferedIOBase OR a RawIOBase
(cherry picked from commit 36eb711d2f)

Co-authored-by: Alex Kautz <alex@takemobi.com>
2025-05-20 12:28:09 -07:00
Hugo van Kemenade
61af847d41
[3.13] gh-101100: Fix Sphinx warnings in library/decimal.rst (GH-134303) (#134339)
Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
2025-05-20 17:55:23 +03:00
Guido van Rossum
eca8ff1ae2
[3.13] gh-128307: Update what's new in 3.13 with create_task changes of asyncio (#134304) (#134335)
(It's complicated.)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-05-20 07:30:18 -07:00
Miss Islington (bot)
0c0fedf289
[3.13] gh-53189: Document peculiarities of InteractiveConsole in relation to pickle (GH-123069) (GH-134329)
gh-53189: Document peculiarities of InteractiveConsole in relation to pickle (GH-123069)

(cherry picked from commit a31bbc951a)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-05-20 12:17:10 +00:00
Miss Islington (bot)
edbde92a12
[3.13] gh-134201: Expand explanation of Base85 encodings in base64 docs (GH-134288) (#134297)
gh-134201: Expand explanation of Base85 encodings in base64 docs (GH-134288)

Explain history of de-facto standard and how to pick between the two Base-85 encoding functions in the base-64 module.

---------
(cherry picked from commit 66aaad6103)

Co-authored-by: Alek Binion <aleksander.binion@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2025-05-20 00:05:26 +00:00
Miss Islington (bot)
55a7cb1206
[3.13] gh-122055: Clarify documentation for empty matches in RE (GH-133169) (GH-134218)
(cherry picked from commit 44b73d3cd4)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-05-19 16:49:29 +03:00
Peter Bierma
8d92823eca
[3.13] Docs: C API: Fix the incorrect PyThreadState_Swap documentation (#133900) 2025-05-19 18:24:00 +05:30
Miss Islington (bot)
018ec634f6
[3.13] document Py_VISIT as a macro in the docs (GH-133688) (#134187)
document `Py_VISIT` as a macro in the docs (GH-133688)
(cherry picked from commit bb32f3c698)

Co-authored-by: da-woods <dw-git@d-woods.co.uk>
2025-05-18 16:36:04 +00:00
Miss Islington (bot)
9c297690d5
[3.13] fix indent in controlflow.rst docs (GH-134008) (#134185)
fix indent in `controlflow.rst` docs (GH-134008)
(cherry picked from commit 4ce91871a9)

Co-authored-by: Yongzi Li <1538321957@qq.com>
2025-05-18 16:27:09 +00:00
Thomas Grainger
fd6a602d04
[3.13] gh-133745: Fix asyncio task factory name/context kwarg breaks (#133948)
In 3.13.3 we accidentally broke the interface for custom task factory. Factory authors added workarounds.
This PR (for 3.13.4) unbreaks task factories that haven't made a workaround yet while also supporting those that have.

NOTE: The custom task factory API will change to what we accidentally released in 3.13.3.

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2025-05-18 06:50:07 -07:00
Miss Islington (bot)
ebe54d7ab7
[3.13] gh-134150: Clarify distinction between JSON and Python objects (GH-134154) (#134167)
gh-134150: Clarify distinction between JSON and Python objects (GH-134154)

* gh-134150: Clarify distinction between JSON objects and Python objects in json module docs

* Revert change to JSON introduction

* Clarify occurrences of "object literal" as JSON
(cherry picked from commit fa4e088668)

Co-authored-by: Micha Albert <micha@2231puppy.tech>
2025-05-18 01:53:37 +00:00
Miss Islington (bot)
f62543271a
[3.13] gh-88275: Add missing __init__ method to match example (GH-120281) (#134143)
gh-88275: Add missing `__init__` method to `match` example (GH-120281)
(cherry picked from commit 7a9d46295a)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
2025-05-17 13:18:14 +00:00
Miss Islington (bot)
ec42d72f47
[3.13] Docs: fix spelling of "test case" in unittest documentation (GH-134137) (#134139)
Docs: fix spelling of "test case" in `unittest` documentation (GH-134137)
(cherry picked from commit b41d79c776)

Co-authored-by: Clifford Gama <53076065+cliff688@users.noreply.github.com>
2025-05-17 14:03:58 +02:00
Miss Islington (bot)
c529870542
[3.13] gh-133881: add forward reference to list.sort() in lambda expression tutorial (GH-133910) (#134127)
gh-133881: add forward reference to `list.sort()` in lambda expression tutorial (GH-133910)
(cherry picked from commit c1c9ad1d5a)

Co-authored-by: Oleg Burnaev <51371645+Shepard2154@users.noreply.github.com>
2025-05-17 08:05:41 +00:00
Miss Islington (bot)
4291bbe88b
[3.13] gh-117026: Remove outdated sentence in SimpleHTTPRequestHandler docs (GH-117027) (GH-134108)
The code was changed in 0f7cddc308 (bpo-839496/gh-39531).
(cherry picked from commit ea2d707bd5)

Co-authored-by: Saleh Dehqanpour <salehdeh76@gmail.com>
2025-05-16 22:24:05 +03:00
Miss Islington (bot)
8077e2268c
[3.13] gh-133286: add explanation about seq for pathlib Pattern Language (GH-133340) (#134106)
gh-133286: add explanation about `seq` for pathlib Pattern Language (GH-133340)
(cherry picked from commit ac8df4b589)

Co-authored-by: alexey semenyuk <alexsemenyuk88@gmail.com>
2025-05-16 20:20:53 +01:00
Miss Islington (bot)
2a029a7d79
[3.13] gh-133515: fix docs for unawaited coroutines in debug mode (GH-134081) (#134094)
gh-133515: fix docs for unawaited coroutines in debug mode (GH-134081)
(cherry picked from commit d94b1e9cac)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-05-16 15:38:22 +00:00
Miss Islington (bot)
0007c9b505
[3.13] gh-124210: Add introduction to threading docs (GH-127046) (#134091)
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2025-05-16 12:25:22 +00:00
Miss Islington (bot)
bd3add06f6
[3.13] gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (GH-133987) (#133992)
gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (GH-133987)
---------
(cherry picked from commit 3e23047363)

Co-authored-by: Joey Smith <joeysmith@gmail.com>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
2025-05-14 21:33:38 -04:00
Miss Islington (bot)
ab8aafe551
[3.13] Docs: remove link elements in builders other than HTML (GH-133720) (#134006)
Co-authored-by: Maciej Olko <maciej.olko@affirm.com>
2025-05-14 18:22:27 +03:00
Stan Ulbrych
78a04b3300
[3.13] gh-46236: Document PyUnicode_BuildEncodingMap (#133770) 2025-05-13 19:23:43 -04:00
Miss Islington (bot)
05ddd06624
[3.13] gh-133413: Fix references to removed Request.has_data (GH-133414) (GH-133946)
The has_data() method of http.request.Request
was removed in version 3.4.
(cherry picked from commit 86c1d439e0)

Co-authored-by: ppaez <pp@pp.com.mx>
2025-05-12 18:25:25 +00:00