Commit graph

28846 commits

Author SHA1 Message Date
Miss Islington (bot)
293f2895d5
[3.13] gh-98347: Add links to python-isal in the documentation (GH-98637) (#132894)
gh-98347: Add links to python-isal in the documentation (GH-98637)

Clearly note that this is primarily intended for users for who zlib/gzip is a bottleneck.
(cherry picked from commit b1fc8b69ec)

Co-authored-by: Ruben Vorderman <r.h.p.vorderman@lumc.nl>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-04-25 03:09:58 +01:00
Miss Islington (bot)
9953971924
[3.13] Differentiate bitwise OR from the word "or" (GH-132890) (#132891)
Differentiate bitwise OR from the word "or" (GH-132890)
(cherry picked from commit 15ff60aff0)

Co-authored-by: Brett Cannon <brett@python.org>
2025-04-24 22:11:18 +00:00
Miss Islington (bot)
52e0f564d0
[3.13] Fix a grammar error in the Py_ALWAYS_INLINE doc (GH-129304) (#132877)
Co-authored-by: Kuba_Z2 <77853483+KubaZ2@users.noreply.github.com>
2025-04-24 14:27:41 +00:00
Miss Islington (bot)
9ec6f77f8a
[3.13] gh-128185: Align Decimal docs with spec (case irrelevant for nan/inf) (GH-128323) (#132875)
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2025-04-24 14:09:03 +00:00
Miss Islington (bot)
bd4a39f125
[3.13] gh-122399: change webbrowser.rst to better describe the contents of controller object (GH-122407) (#132874)
Co-authored-by: Jordi Burguet-Castell <jordi.burguet.castell@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-04-24 14:03:02 +00:00
Miss Islington (bot)
abbc44c557
[3.13] gh-132742: Update documentation for the fcntl module (GH-132765) (GH-132832)
(cherry picked from commit 5f50541ebd)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-04-23 21:08:46 +03:00
Gregory P. Smith
cdabbc126f
[3.13] gh-122179: Fix hashlib.file_digest and non-blocking I/O (GH-132787)
gh-122179: Fix hashlib.file_digest and non-blocking I/O (GH-122183)

* Fix hashlib.file_digest and non-blocking I/O
* Add documentation around this behavior
* Add versionchanged

(cherry picked from commit 2b47f46d7d)

Co-authored-by: Sebastian Rittau <srittau@rittau.biz>
2025-04-21 21:55:57 +00:00
Miss Islington (bot)
d8b9011702
[3.13] gh-85583: Add an overview of formatted string literals (f-strings) to `str` (GH-132689) (#132767)
gh-85583: Add an overview of formatted string literals (f-strings) to ``str`` (GH-132689)
(cherry picked from commit fee808936f)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-04-21 08:55:13 +01:00
Miss Islington (bot)
5ab628fc65
[3.13] gh-129327: revise hashlib documentation to account for FIPS removing sha1 (GH-132729) (#132740)
gh-129327: revise hashlib documentation to account for FIPS removing sha1 (GH-132729)

* gh-129327: revise hashlib documentation to account for FIPS removing sha1

More generally, the current documentation is a bit scattered, talking
about what terms are "equal" despite those terms not being very
interesting and given the term "secure hash", probably wrong (because
md5 and sha1 are not secure anymore).

Let's talk about cryptographically secure instead, and note that two of
them aren't. And then we can also link to the source for NIST going
through the removal process for SHA1.

* Add Gregors Suggestion

* Clean up

---------
(cherry picked from commit a16586c9e7)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Eli Schwartz <eschwartz@gentoo.org>
2025-04-20 01:12:26 +00:00
Miss Islington (bot)
38f305b9db
[3.13] Docs: Fix REPL example in Doc/library/shutil.rst (GH-132700) (#132728)
Docs: Fix REPL example in `Doc/library/shutil.rst` (GH-132700)
(cherry picked from commit e154e4db36)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-04-19 14:20:46 +00:00
Miss Islington (bot)
83cb89b941
[3.13] gh-129719: Restore missing socket.CAN_RAW_ERR_FILTER on Linux (GH-129721) (#132702)
gh-129719: Restore missing `socket.CAN_RAW_ERR_FILTER` on Linux (GH-129721)
(cherry picked from commit ce31ae5209)

Co-authored-by: Jeroen Bogers <11465689+jbogers@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2025-04-18 20:49:23 +00:00
Miss Islington (bot)
151828d520
[3.13] Minor doc edit: Make multinomial() the first math example (gh-132697) (gh-132698) 2025-04-18 17:47:25 +00:00
Miss Islington (bot)
ca2e1a1e1c
[3.13] gh-130861: Add clarification to the perf docs on optimization levels (GH-131098) (#132687) 2025-04-18 13:48:23 +00:00
Miss Islington (bot)
bfba11ad11
[3.13] gh-132668: Remove outdated description of POP_JUMP_* instructions (GH-132669) (#132680)
gh-132668: Remove outdated description of `POP_JUMP_*` instructions (GH-132669)
(cherry picked from commit 7e2672cfcf)

Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
2025-04-18 14:14:40 +02:00
Miss Islington (bot)
7d4c00e7c5
[3.13] Docs: Migrate entirely to PSF hosted plausible for analytics (GH-132648) (#132660)
Docs: Migrate entirely to PSF hosted plausible for analytics (GH-132648)
(cherry picked from commit 1d529cbc89)

Co-authored-by: Ee Durbin <ewdurbin@gmail.com>
2025-04-18 05:02:18 +01:00
Miss Islington (bot)
db7ad1c89f
[3.13] gh-132608: Fix a sample code coloring for ast.While (GH-132609) (#132612) 2025-04-16 21:02:39 +01:00
Miss Islington (bot)
f9578dc31f
[3.13] typing docs: Clarify Protocol / runtime_checkable docs (GH-132606) (#132607)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2025-04-16 17:50:31 +00:00
Miss Islington (bot)
2a1a337d28
[3.13] Docs: Synchronise `indexsidebar.html` with docsbuild-scripts (GH-132567) (#132573)
Docs: Synchronise ``indexsidebar.html`` with docsbuild-scripts (GH-132567)
(cherry picked from commit 4f10b93d1b)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-04-15 23:42:27 +01:00
Miss Islington (bot)
11617d5a7f
[3.13] Fix argument order in multinomial() example (gh-132557) (gh-132560) 2025-04-15 16:56:57 +00:00
Miss Islington (bot)
bdff88b9aa
[3.13] gh-131803: Clarify that you must register signal handlers for set_wakeup_fd (GH-131859) (#132522)
gh-131803: Clarify that you must register signal handlers for set_wakeup_fd (GH-131859)
(cherry picked from commit 939476bbbb)

Co-authored-by: Jeremy Fleischman <jeremyfleischman@gmail.com>
2025-04-14 16:52:36 +00:00
Victor Stinner
866b6359e5
[3.13] gh-46236: Add missing PyUnicode_FromOrdinal() doc (#132040) (#132521)
gh-46236: Add missing PyUnicode_FromOrdinal() doc (#132040)

(cherry picked from commit 8768df2fe9)

Co-authored-by: RUANG (James Roy) <longjinyii@outlook.com>
2025-04-14 16:48:40 +00:00
Serhiy Storchaka
d321b6ec82
[3.13] gh-132099: Harmonize Bluetooth address handling (GH-132486) (GH-132497)
Now all protocols always accept the Bluetooth address as string and
getsockname() always returns the Bluetooth address as string.

* BTPROTO_SCO now accepts not only bytes, but str.
* BTPROTO_SCO now checks address for embedded null.
* On *BSD, BTPROTO_HCI now accepts str instead of bytes.
* On FreeBSD, getsockname() for BTPROTO_HCI now returns str instead of bytes.
* On NetBSD and DragonFly BSD, BTPROTO_HCI now checks address for embedded null.
(cherry picked from commit 1fc1df8dcc)
2025-04-14 19:36:04 +03:00
Miss Islington (bot)
fd0bba67c4
[3.13] gh-86513: improve docs of loop.call_exception_handler (GH-132466) (#132487)
gh-86513: improve docs of loop.call_exception_handler (GH-132466)
(cherry picked from commit ce753517a8)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-04-14 11:42:45 +00:00
Miss Islington (bot)
f206b98c18
[3.13] gh-101100: Fix sphinx warnings in library/plistlib.rst (GH-132422) (#132485)
Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
2025-04-13 18:41:56 +00:00
Miss Islington (bot)
d021b719ed
[3.13] gh-132111: Document dataclasses.InitVar (GH-132446) (#132483)
gh-132111: Document dataclasses.InitVar (GH-132446)
(cherry picked from commit 281fc338fd)

Co-authored-by: Tapeline <mail@tapeline.dev>
2025-04-13 16:53:40 +00:00
Serhiy Storchaka
54e1b63333
[3.13] gh-132099: Fix documentation for the BTPROTO_HCI protocol (GH-132118) (GH-132482)
(cherry picked from commit 1d97488c95)
2025-04-13 16:27:41 +00:00
Vinay Sajip
1dcdac6e08
[3.13] gh-132106: Ensure that running `logging.handlers.QueueListener… (GH-132471)
Cherry-picked using 5863cd70b8
2025-04-13 13:00:50 +01:00
Miss Islington (bot)
ff66901d8a
[3.13] gh-132354: document return value for asyncio.Task.cancel (GH-132374) (#132465)
gh-132354: document return value for `asyncio.Task.cancel` (GH-132374)
(cherry picked from commit 64b066ad29)

Co-authored-by: Felix Scherz <felixwscherz@gmail.com>
2025-04-13 07:41:26 +00:00
Miss Islington (bot)
244a642443
[3.13] Fix a typo in c-api/typeobj.rst (GH-132317) (#132464)
Fix a typo in c-api/typeobj.rst (GH-132317)
(cherry picked from commit f69b344e09)

Co-authored-by: Yongzi Li <1538321957@qq.com>
2025-04-13 07:24:46 +00:00
Miss Islington (bot)
1884a3bbd1
[3.13] Docs: Fix specifications of gcvisitobjects_t (GH-132433) (#132441)
Docs: Fix specifications of `gcvisitobjects_t` (GH-132433)

`gcvisitobjects_t` callbacks should return 1 for the iteration to continue instead of 0.
(cherry picked from commit 1e5798e372)

Co-authored-by: da-woods <dw-git@d-woods.co.uk>
2025-04-12 15:42:26 +00:00
Miss Islington (bot)
17b61394ee
[3.13] gh-123441: Update Belorussian spelling (GH-132409) (GH-132432)
(cherry picked from commit ad3bbe8fbc)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-04-12 10:42:31 +00:00
Miss Islington (bot)
c1744902c7
[3.13] gh-106482: Clarify documentation of character set in RE (GH-106517) (#132365)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Martin Panter <vadmium@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-04-10 13:48:57 +00:00
Miss Islington (bot)
fc85256f89
[3.13] Fix example code in curses tutorial (GH-126446) (#132362)
Co-authored-by: Jiayu Yi <yijiayu@gmail.com>
2025-04-10 12:13:50 +00:00
Miss Islington (bot)
8e017f2f48
[3.13] Docs: Add a missing trailing full stop (GH-130561) (#132358)
Co-authored-by: Liam DeVoe <orionldevoe@gmail.com>
2025-04-10 11:57:40 +00:00
Miss Islington (bot)
b328e4bc57
[3.13] gh-72631: Fix wrong documentation for GzipFile.peek (GH-29820) (#132353)
Co-authored-by: 180909 <wjh180909@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2025-04-10 11:27:20 +00:00
Adam Turner
f24f241802
[3.13] Generate social media preview cards for the documentation (GH-132101) (#132344) 2025-04-10 06:39:46 +01:00
Miss Islington (bot)
c3c8e31547
[3.13] gh-106670: Fix a typo in doc of pdb's exceptions command (GH-132277) (#132279)
gh-106670: Fix a typo in doc of pdb's exceptions command (GH-132277)
(cherry picked from commit efd8aca62c)

Co-authored-by: Tian Gao <gaogaotiantian@hotmail.com>
2025-04-08 21:28:35 +00:00
Thomas Wouters
6280bb5478 Python 3.13.3 2025-04-08 15:54:08 +02:00
Miss Islington (bot)
d2ec87f740
[3.13] gh-102136: Add -m to options that work with -i (GH-119271) (GH-119285)
(cherry picked from commit 172690227e)

Co-authored-by: Melanie Arbor <hellomelaniec@gmail.com>
2025-04-08 12:31:47 +02:00
Miss Islington (bot)
5aa7aeb50f
[3.13] gh-132021: Add bool type to the list of allowed JSON key types (GH-132048) (#132255)
gh-132021: Add bool type to the list of allowed JSON key types (GH-132048)
(cherry picked from commit 403886c28d)

Co-authored-by: Srinivas Reddy Thatiparthy (తాటిపర్తి శ్రీనివాస్  రెడ్డి) <thatiparthysreenivas@gmail.com>
Co-authored-by: Eric V. Smith <ericvsmith@users.noreply.github.com>
2025-04-08 08:51:39 +00:00
Miss Islington (bot)
7e9c5772a8
[3.13] gh-115684: Clarify datetime replace documentation (GH-116519) (#131676)
gh-115684: Clarify datetime `replace` documentation (GH-116519)

* Clarify datetime `replace` documentation

In GH-115684, HopedForLuck noted that `datetime.date.replace()`
documentation was confusing because it looked like it would be changing
immutable objects.

This documentation change specifies that the `replace()` methods in
`datetime` return new objects. This uses similar wording to the
documentation for `datetime.combine()`, which specifies that a new
datetime is returned. This is also similar to wording for
`string.replace()`, except `string.replace()` emphasizes that a "copy"
is returned.

Resolves GH-115684.

* Include reviewer comments

Thanks Privat33r-dev for the comments!

---------
(cherry picked from commit d2d886215c)

Co-authored-by: David Lowry-Duda <david@lowryduda.com>
Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>
2025-04-08 10:45:21 +02:00
Miss Islington (bot)
53b9370c43
[3.13] Add psfhosted Plausible instance to analytics (GH-132252) (#132253)
Add psfhosted Plausible instance to analytics (GH-132252)
(cherry picked from commit 40844164b1)

Co-authored-by: Ee Durbin <ewdurbin@gmail.com>
2025-04-08 07:51:18 +00:00
Hugo van Kemenade
bf5471f4de
[3.13] Docs HTML: Remove self-closing tags (GH-132220) (#132228)
(cherry picked from commit ce724571b3)

Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-04-07 22:06:06 +01:00
Miss Islington (bot)
53555f2199
[3.13] gh-130521: Add Open Graph meta tags to template pages (GH-130523) (#132239)
gh-130521: Add Open Graph meta tags to template pages (GH-130523)
(cherry picked from commit f5639d87f5)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-04-07 21:05:15 +00:00
Miss Islington (bot)
bd2f518555
[3.13] gh-132221: Fix __match_args__ generation docs in dataclasses.rst (GH-132222) (#132226)
gh-132221: Fix `__match_args__` generation docs in `dataclasses.rst` (GH-132222)
(cherry picked from commit 8b62374b34)

Co-authored-by: sobolevn <mail@sobolevn.me>
2025-04-07 14:52:55 +00:00
Prometheus3375
07483c2c80
[3.13] gh-131912: Improve description of grouping options in the format specification docs (GH-132030) (#132123)
(cherry picked from commit 06a110f522)
2025-04-07 09:19:13 +02:00
Miss Islington (bot)
2f1fc0fab9
[3.13] Docs: Add a single table summary for `cmath` (GH-131887) (#132179)
Docs: Add a single table summary for ``cmath`` (GH-131887)
(cherry picked from commit 6eaa4aeef2)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-04-06 23:42:49 +00:00
Miss Islington (bot)
7e154bea3d
[3.13] Fix numbered list syntax in programming.rst (GH-130158) (#132140)
Fix numbered list syntax in programming.rst (GH-130158)
(cherry picked from commit 376631829a)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2025-04-05 19:26:40 +00:00
Miss Islington (bot)
65181de34c
[3.13] Docs: document plistlib.InvalidFileException (GH-132069) (#132116)
Docs: document `plistlib.InvalidFileException` (GH-132069)
(cherry picked from commit 99e9798d61)

Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
2025-04-05 10:53:13 +02:00
Miss Islington (bot)
75d453b0ab
[3.13] gh-131544: Update docs for PyType_AddWatcher (gh-132015) (gh-132019)
gh-131544: Update docs for PyType_AddWatcher (gh-132015)
(cherry picked from commit 25275bda79)

Co-authored-by: Donghee Na <donghee.na@python.org>
2025-04-03 01:24:43 +09:00