Commit graph

26736 commits

Author SHA1 Message Date
Miss Islington (bot)
2eb9fe92b4
[3.12] gh-103968: What's New: Add porting hints for PyType_From with metaclasses (GH-105698) (GH-106619)
gh-103968: What's New: Add porting hints for PyType_From with metaclasses (GH-105698)
(cherry picked from commit af5cf1e751)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2023-07-11 13:53:40 +02:00
Miss Islington (bot)
30870c834c
[3.12] gh-102988: Detect email address parsing errors and return empty tuple to indicate the parsing error (old API) (GH-105127) (#106612)
gh-102988: Detect email address parsing errors and return empty tuple to indicate the parsing error (old API) (GH-105127)

Detect email address parsing errors and return empty tuple to indicate the parsing error (old API). This fixes or at least ameliorates CVE-2023-27043.

---------

(cherry picked from commit 18dfbd0357)

Co-authored-by: Thomas Dwyer <github@tomd.tel>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2023-07-10 23:38:42 +00:00
Miss Islington (bot)
41057b2ffe
[3.12] gh-105227: Add PyType_GetDict() (GH-105747) (#106600)
gh-105227: Add PyType_GetDict() (GH-105747)

This compensates for static builtin types having `tp_dict` set to `NULL`.

(cherry picked from commit a840806d33)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2023-07-10 17:12:15 +00:00
Miss Islington (bot)
0481b805d6
[3.12] Clarify how topics.py gets created. (GH-106121) (#106579)
Clarify how topics.py gets created. (GH-106121)

When changing docs, it was easy to find text in topics.py, and I
wondered whether I was supposed to edit it.  Thankfully, the top of the
file says it's auto-generated, so I knew I didn't have to edit it. But I
didn't know what started the auto-generation process.

It's part of the release process, so I'll leave a note here for future
editors.
(cherry picked from commit dac1e36490)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2023-07-09 20:42:22 -07:00
Miss Islington (bot)
128a962482
[3.12] gh-106461: typing: Consolidate docs on Callable (GH-106462) (#106574)
gh-106461: typing: Consolidate docs on `Callable` (GH-106462)
(cherry picked from commit ca8b55c7f5)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-07-09 22:21:54 +01:00
Miss Islington (bot)
48f58e0243
[3.12] gh-101880: add link to object.__hash__() in hash() builtin documentation (GH-101883) (#106546)
gh-101880: add link to object.__hash__() in hash() builtin documentation (GH-101883)
(cherry picked from commit ec7180bd1b)

Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
2023-07-08 14:22:50 +05:30
Miss Islington (bot)
e229225fba
[3.12] Clarify state of CancelledError in doc (GH-106453) (#106454)
Clarify state of CancelledError in doc (GH-106453)

This change makes it explicit that asyncio.CancelledError is not a subclass of Exception.
(cherry picked from commit 12a9813808)

Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
2023-07-06 16:34:43 +05:30
Miss Islington (bot)
84cda268bd
[3.12] Doc: Add missing ref labels to exception groups/notes sections (GH-106465) (#106473)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-07-05 23:51:30 -06:00
Miss Islington (bot)
1e4c2359e4
[3.12] gh-105256: What's New note for comprehension over locals() (GH-106378) (#106471)
gh-105256: What's New note for comprehension over locals() (GH-106378)
(cherry picked from commit 13aefd175e)

Co-authored-by: Carl Meyer <carl@oddbird.net>
2023-07-05 18:53:30 -06:00
Miss Islington (bot)
a49a29f22b
[3.12] shlex docs: remove outdated note (GH-106463) (#106466)
shlex docs: remove outdated note (GH-106463)

As the versionchanged notice says, this note is no longer true on 3.12+.
(cherry picked from commit c16ea94abc)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2023-07-05 13:57:49 -07:00
Miss Islington (bot)
53605f285a
[3.12] GH-104554: Add RTSPS support to urllib/parse.py (GH-104605) (#105759)
RTSPS is the permanent scheme defined in
https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml
alongside RTSP and RTSPU schemes.

(cherry picked from commit f3266c05b6)

Co-authored-by: zentarim <33746047+zentarim@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2023-07-05 13:02:22 +02:00
Miss Islington (bot)
5784acd08c
[3.12] tp_flags docs: fix indentation (GH-106420) (#106442)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2023-07-04 23:12:47 -07:00
Miss Islington (bot)
67127ca8e2
[3.12] Small speed-up for the convolve() recipe. (GH-106371) (GH-106375) 2023-07-03 15:49:09 -05:00
Miss Islington (bot)
5e856049b1
[3.12] Replace the esoteric term 'datum' when describing dict comprehensions (GH-106119) (#106348)
Replace the esoteric term 'datum' when describing dict comprehensions (GH-106119)
(cherry picked from commit 987b712b4a)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2023-07-03 03:23:27 +00:00
Miss Islington (bot)
8738c5bcee
[3.12] gh-106232: Make timeit doc command lines compatible with Windows. (GH-106296) (#106298)
gh-106232: Make timeit doc command lines compatible with Windows. (GH-106296)

Command Prompt (CMD Shell) and older versions of PowerShell
require double quotes and single quotes inside the string.
This form also works on linux and macOS.
(cherry picked from commit 04dfc6fa90)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-06-30 22:40:43 -04:00
Miss Islington (bot)
d6a5a30669
[3.12] gh-101100: Docs: Fix references to several numeric dunders (GH-106278) (#106281)
gh-101100: Docs: Fix references to several numeric dunders (GH-106278)
(cherry picked from commit a8ae73965b)

Co-authored-by: F3eQnxN3RriK <drsuaimqjgar@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-30 15:39:52 +01:00
Miss Islington (bot)
7a1b946a8d
[3.12] gh-77782: Deprecate Py_HasFileSystemDefaultEncoding (GH-106272) (#106274)
gh-77782: Deprecate Py_HasFileSystemDefaultEncoding (GH-106272)

Deprecate Py_HasFileSystemDefaultEncoding variable.
(cherry picked from commit f3cf2ddd8d)

Co-authored-by: Victor Stinner <vstinner@python.org>
2023-06-30 10:21:36 +00:00
Miss Islington (bot)
0cd07b3272
[3.12] gh-101100: Fix reference to parse_args in optparse.rst (GH-105265) (#106204)
Co-authored-by: F3eQnxN3RriK <drsuaimqjgar@gmail.com>
2023-06-28 15:44:23 +03:00
Miss Islington (bot)
7bdf2c16e6
[3.12] gh-105993: Add possible None return type to asyncio.EventLoop.start_tls docs (GH-105995) (#106188)
gh-105993: Add possible `None` return type to `asyncio.EventLoop.start_tls` docs (GH-105995)
(cherry picked from commit 6b52a581c1)

Co-authored-by: Sam Bull <git@sambull.org>
2023-06-28 16:36:49 +05:30
Miss Islington (bot)
27bd2d1a9b
[3.12] gh-101100: Fix reference to asynchronous methods (GH-106172) (#106191)
gh-101100: Fix reference to asynchronous methods (GH-106172)
(cherry picked from commit bbf722dcd3)

Co-authored-by: F3eQnxN3RriK <drsuaimqjgar@gmail.com>
2023-06-28 16:36:02 +05:30
Miss Islington (bot)
56e39192c8
[3.12] Refer to TimeoutError instead of asyncio.TimeoutError in asyncio-task.rst (GH-106136) (#106179)
Co-authored-by: lightdrk <108566237+lightdrk@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-06-27 23:38:01 -06:00
Pablo Galindo Salgado
20315d141a
[3.12] gh-106140: Reorder some more fields to facilitate out-of-process inspection (GH-106148) (#106155)
(cherry picked from commit 9126a6a9ce)
2023-06-27 18:33:01 +00:00
Miss Islington (bot)
ac80beb1ec
[3.12] gh-106140: Reorder some fields to facilitate out-of-process inspection (GH-106143) (#106147)
gh-106140: Reorder some fields to facilitate out-of-process inspection (GH-106143)
(cherry picked from commit 2d5a1c2811)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>
Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2023-06-27 17:44:37 +00:00
Miss Islington (bot)
0555722a8a
[3.12] gh-92788: Add docs for ast.Module, ast.Expression, and others (GH-101055) (#106139)
gh-92788: Add docs for `ast.Module`, `ast.Expression`, and others (GH-101055)
(cherry picked from commit 33608fd67d)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-06-27 13:44:44 +00:00
Miss Islington (bot)
c2e8e347b3
[3.12] GH-105774: Clarify operation of normalize() (GH-106093) (GH-106128) 2023-06-26 23:32:16 -05:00
Miss Islington (bot)
1acfecbc00
[3.12] Revert "GH-96145: Add AttrDict to JSON module for use with object_hook (GH-96146)" (GH-105948) (#106117)
Revert "GH-96145: Add AttrDict to JSON module for use with object_hook (GH-96146)" (GH-105948)

This reverts commit 1f0eafa844.
(cherry picked from commit d3af83b934)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2023-06-26 21:11:49 +02:00
Miss Islington (bot)
ea6a4b7523
[3.12] gh-106107: document correct error that's raised when a mutable default value for a field is detected (gh-106109) (gh-106115)
gh-106107: document correct error that's raised when a mutable default value for a field is detected (gh-106109)
(cherry picked from commit 512f299e55)

Co-authored-by: Roderich Schupp <roderich.schupp@gmail.com>
2023-06-26 14:12:52 -04:00
Miss Islington (bot)
fa3a75dc68
[3.12] gh-106111: Remove zipapp documentation on creating a Windows executable (GH-106112) (#106114)
Remove zipapp documentation on creating a Windows executable

(cherry picked from commit 5d4dbf0e30)

Co-authored-by: Paul Moore <p.f.moore@gmail.com>
2023-06-26 18:26:40 +02:00
Miss Islington (bot)
84189640b7
[3.12] Improve typing docs on the type of class objects (GH-106081) (#106096)
Improve typing docs on the type of class objects (GH-106081)
(cherry picked from commit 3eeb8c8906)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-26 09:43:24 +01:00
Miss Islington (bot)
592d1eadc6
[3.12] gh-84436: update docs on Py_None/Py_True/Py_False/Py_Ellipsis becoming immortal (GH-105195) (#105977)
gh-84436: update docs on Py_None/Py_True/Py_False/Py_Ellipsis becoming immortal (GH-105195)
(cherry picked from commit a2392720d6)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2023-06-26 14:02:00 +05:30
Miss Islington (bot)
e9366df3ec
[3.12] gh-104212: Explain how to port imp.load_source() (GH-105978) (#106083)
gh-104212: Explain how to port imp.load_source() (GH-105978)

Explain how to port removed imp.load_source() to importlib in What's
New in Python 3.12.
(cherry picked from commit 18a7c86697)

Co-authored-by: Victor Stinner <vstinner@python.org>
2023-06-25 17:14:18 +02:00
Miss Islington (bot)
f930bee003
[3.12] Docs: add links to 'callable' term in sqlite3 docs (GH-106072) (#106073)
(cherry picked from commit bef1c8761e)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
2023-06-25 10:16:12 +02:00
Miss Islington (bot)
746c0f3d8f
[3.12] gh-106033: [docs] Improve C API GetItem & HasAttr notes. (GH-106047) (#106070)
gh-106033: [docs] Improve C API GetItem & HasAttr notes. (GH-106047)

Use a note:: tag so that these dict and object API deficiencies show up clearly.

A caution:: tag was considered, but our current python docs rendering doesn't do much with that (no box or color change).  warning:: seemed too extreme.  note looks good.
(cherry picked from commit 19d6511b0b)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2023-06-24 16:30:27 -07:00
Barney Gale
ef58c0428d
[3.12] GH-104375: Use versionchanged to describe new arguments in pathlib docs (GH-104376, GH-106058)
(cherry picked from commit 4a6c84fc1e)
2023-06-24 16:25:47 +01:00
Miss Islington (bot)
de1c090879
[3.12] Typing docs: fix typo in annotating tuples comment (GH-106048) (#106049)
Typing docs: fix typo in annotating tuples comment (GH-106048)
(cherry picked from commit 8ef0ee4ebc)

Co-authored-by: Eamon Tracey <66919574+EamonTracey@users.noreply.github.com>
2023-06-23 21:35:00 +01:00
Miss Islington (bot)
1ffcd49be2
[3.12] Typing docs: improve the guidance on annotating tuples (GH-106021) (#106027)
Typing docs: improve the guidance on annotating tuples (GH-106021)
(cherry picked from commit 968435ddb1)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-23 15:48:29 +01:00
Miss Islington (bot)
3cc5523312
[3.12] Docs: Avoid a DeprecationWarning in pyspecific.py when running with Sphinx >=6.1 (GH-105886) (#106010)
Docs: Avoid a DeprecationWarning in `pyspecific.py` when running with Sphinx >=6.1 (GH-105886)
(cherry picked from commit a72683ba8e)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-06-23 09:07:58 +01:00
Miss Islington (bot)
025c9912ee
[3.12] stdtypes.rst: remove a period (GH-105959) (#105968)
stdtypes.rst: remove a period (GH-105959)
(cherry picked from commit c5a722be5f)

Co-authored-by: Mathieu Dupuy <deronnax@gmail.com>
2023-06-21 15:40:54 +01:00
Miss Islington (bot)
5729b418fe
[3.12] gh-104212: Explain how to port imp code to importlib (GH-105905) (#105952)
gh-104212: Explain how to port imp code to importlib (GH-105905)
(cherry picked from commit 7a56a4148c)

Co-authored-by: Victor Stinner <vstinner@python.org>
2023-06-20 23:03:54 +00:00
Miss Islington (bot)
5e524ef346
[3.12] typing docs: Improve the intro to each section (GH-105901) (#105902)
typing docs: Improve the intro to each section (GH-105901)
(cherry picked from commit 4426279a43)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-19 01:02:48 +01:00
Miss Islington (bot)
1606cbc2fd
[3.12] gh-105844: Use devguide terminology to denote versions (GH-105882) (#105892)
(cherry picked from commit dba7217511)

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2023-06-18 19:56:35 +02:00
Miss Islington (bot)
6baddd9fb2
[3.12] Docs: move sphinx-lint to pre-commit (GH-105750) (#105894)
Docs: move sphinx-lint to pre-commit (GH-105750)
(cherry picked from commit bc07c8f096)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-06-18 13:21:34 +01:00
Miss Islington (bot)
32c0aeb8a7
[3.12] bpo-44530: Document the change in MAKE_FUNCTION behavior (GH-93189) (#105841)
bpo-44530: Document the change in MAKE_FUNCTION behavior (GH-93189)

* bpo-44530: Document the change in MAKE_FUNCTION behavior

Fixes dis module documentation for MAKE_FUNCTION due to 2f180ce2cb (bpo-44530, released as part of 3.11) removes the qualified name at TOS
(cherry picked from commit 486b52a315)

Co-authored-by: Alex Doe <alexdoesh@gmail.com>
2023-06-16 12:17:33 -05:00
Miss Islington (bot)
1eeb2e62d0
[3.12] gh-105844: Consistently use 'minor version' for X.Y versions (GH-105851) (#105853)
(cherry picked from commit 0bffe1acd7)

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2023-06-16 10:56:32 +02:00
Miss Islington (bot)
6f0f27eba0
[3.12] Fix inaccuracies in "Assorted Topics" section of "Defining Extension Types" tutorial (GH-104969) (#105850)
Fix inaccuracies in "Assorted Topics" section of "Defining Extension Types" tutorial (GH-104969)
(cherry picked from commit 0d0963737a)

Co-authored-by: chgnrdv <52372310+chgnrdv@users.noreply.github.com>
2023-06-16 13:26:40 +05:30
Miss Islington (bot)
f94cb788f9
[3.12] tarfile: Fix positional-only syntax in docs (GH-105770) (#105773)
The syntax used in the current docs (a / before any args) is invalid.

I think the right approach is for the arguments to arbitrary
filter functions to be treated as positional-only, meaning that users
can supply filter functions with any names for the argument. tarfile.py
only calls the filter function with positional arguments.
(cherry picked from commit 5cdd5ba49d)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2023-06-15 22:43:19 -07:00
Miss Islington (bot)
9012c55af8
[3.12] More reorganisation of the typing docs (GH-105787) (#105810)
More reorganisation of the typing docs (GH-105787)
(cherry picked from commit da911a6b22)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-15 07:12:42 +01:00
Miss Islington (bot)
1573f1605f
[3.12] Improve docs for typing.dataclass_transform (GH-105792) (#105809)
Improve docs for `typing.dataclass_transform` (GH-105792)
(cherry picked from commit 006a453205)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-06-15 07:12:26 +01:00
Miss Islington (bot)
335fbd65db
[3.12] gh-105196: Fix indentations of section headings in C API docs (GH-105672) (#105782)
gh-105196: Fix indentations of section headings in C API docs (GH-105672)
(cherry picked from commit d32e8d6070)

Co-authored-by: TATHAGATA ROY <royzen9495@gmail.com>
2023-06-14 22:30:00 -05:00
Alex Waygood
52a2bbdc9d
[3.12] Typing docs: move the deprecated stuff below the non-deprecated stuff (#105781) (#105783) 2023-06-14 16:03:30 +01:00