[3.12] GH-104395: Add a link in 'Meta Information' to the docs download page (GH-104443) (#109345)

GH-104395: Add a link in 'Meta Information' to the docs download page (GH-104443)
(cherry picked from commit 90cf345ed42ae4d17d2a073718985eb3432a7c20)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-109184: update traceback module doc w.r.t notes (message is no longer always at the end) (#109201) (#109334)

gh-109184: update traceback module doc w.r.t notes (message is no longer always at the end) (#109201)

(cherry picked from commit 0e76cc359ba5d5e29d7c75355d7c1bc7e817eecf)

[3.12] gh-109114: Relax the check for invalid lambdas inside f-strings to avoid false positives (GH-109121). (#109155)

(cherry picked from commit 5bda2f637e1cfbca45a83aa6e22db25498064b27)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

[3.12] gh-109118: Disallow nested scopes within PEP 695 scopes within classes (GH-109196) (#109297)

gh-109118: Disallow nested scopes within PEP 695 scopes within classes (GH-109196)

Fixes GH-109118. Fixes GH-109194.

(cherry picked from commit b88d9e75f68f102aca45fa62e2b0e2e2ff46d810)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] Fix iter_index() to work with lists which do not support stop=None. (gh-109306) (#109310)

Fix iter_index() to work with lists which do not support stop=None. (gh-109306)
(cherry picked from commit f2a55fecd063244a5fd09a38f673f0781f8802d1)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

[3.12] gh-109295: Fix test_os.test_access_denied() for TEMP=cwd (GH-109299) (#109304)

gh-109295: Fix test_os.test_access_denied() for TEMP=cwd (GH-109299)

Fix test_os.test_access_denied() when the TEMP environment variable
is equal to the current working directory. Run the test using a
different filename, since self.fname already exists in this case.
(cherry picked from commit 7dedfd36dc16d9e1e15d7d0b0a636dd401a5a543)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-109295: Clean up multiprocessing in test_asyncio and test_compileall (GH-109298) (#109301)

gh-109295: Clean up multiprocessing in test_asyncio and test_compileall (GH-109298)

test_asyncio and test_compileall now clean up multiprocessing by
calling multiprocessing _cleanup_tests(): explicitly clean up
resources and stop background processes like the resource tracker.
(cherry picked from commit 09ea4b8706165fd9474165090a0ba86509abd6c8)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-109292: add symtable impact of PEP 709 to What's New (GH-109293) (#109296)

gh-109292: add symtable impact of PEP 709 to What's New (GH-109293)
(cherry picked from commit 2b1e2f1cd154e6df553eda7936715ea0622b4ecf)

Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] gh-109195: fix source location for super load before LOAD_SUPER_ATTR (GH-109289) (#109291)

gh-109195: fix source location for super load before LOAD_SUPER_ATTR (GH-109289)
(cherry picked from commit ceeb4173aee7b835f553a8286feaa48b98c16124)

Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] gh-107322: zipapp: Remove the suggestion to remove .dist-info directories (GH-107296) (#109281)

gh-107322: zipapp: Remove the suggestion to remove .dist-info directories (GH-107296)

Removed zipapp suggestion to rm .dist-info subdirectories. This totally breaks importlib.metadata
(cherry picked from commit 1ee50e2a78f644d81d341a08562073ad169d8cc7)

Co-authored-by: wim glenn <hey@wimglenn.com>

[3.12] gh-90805: Make sure test_functools works with and without _functoolsmodule (GH-108644) (#109275)

gh-90805: Make sure test_functools works with and without _functoolsmodule (GH-108644)
(cherry picked from commit baa6dc8e388e71b2a00347143ecefb2ad3a8e53b)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-109190: What's New in 3.12: Add subheadings to removals for easy linking (GH-109159) (#109273)

gh-109190: What's New in 3.12: Add subheadings to removals for easy linking (GH-109159)
(cherry picked from commit 57b6205523d934d61b6308d63ef72c494c7d2b7e)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-109182: Fix and improve tests for gh-108654 (GH-109189) (#109271)

gh-109182: Fix and improve tests for gh-108654 (GH-109189)
(cherry picked from commit c0f488b88f2a54d76256818e2841d868fecfd396)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] GH-108976. Keep monitoring data structures valid during de-optimization during callback. (GH-109131) (#109268)

GH-108976. Keep monitoring data structures valid during de-optimization during callback. (GH-109131)

[3.12] Test DocTestFinder directly instead of calling support.run_doctest() (GH-108917) (#109259)

Test DocTestFinder directly instead of calling support.run_doctest() (GH-108917)
(cherry picked from commit 0abc935086931d4915ea3c45cffffecb31e7a45c)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-109230: test_pyexpat no longer depends on the current directory (GH-109233) (#109241)

gh-109230: test_pyexpat no longer depends on the current directory (GH-109233)

Fix test_pyexpat.test_exception(): it can now be run from a directory
different than Python source code directory. Before, the test failed
in this case.

Skip the test if Modules/pyexpat.c source is not available. Skip also
the test on Python implementations other than CPython.
(cherry picked from commit e55aab95786e0e9fb36a9a1122d2d0fb3d2403cd)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-109237: Fix test_site for non-ASCII working directory (GH-109238) (#109239)

gh-109237: Fix test_site for non-ASCII working directory (GH-109238)

Fix test_site.test_underpth_basic() when the working directory
contains at least one non-ASCII character: encode the "._pth" file to
UTF-8 and enable the UTF-8 Mode to use UTF-8 for the child process
stdout.
(cherry picked from commit cbb3a6f8ada3d133c3ab9f9465b65067fce5bb42)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] Fix "FSTRING_MIDDLE" typo in py312 "What's New" (GH-109222) (#109223)

Fix "FSTRING_MIDDLE" typo in py312 "What's New" (GH-109222)
(cherry picked from commit 2dd6a86c4ee604b331ed739c2508b0d0114993c6)

Co-authored-by: Delgan <4193924+Delgan@users.noreply.github.com>

[3.12] Improve the sieve() recipe in the itertools docs (gh-109199) (#109203)

Improve the sieve() recipe in the itertools docs (gh-109199)

Lazier sieve
(cherry picked from commit d3ed9921cdd8ac291fbfe3adf42f7730d3a14dbc)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

[3.12] Fix an ironic typo in a code comment. (gh-109186) (#109188)

Fix an ironic typo in a code comment. (gh-109186)
(cherry picked from commit 75cd86599bad05cb372aed9fccc3ff884cd38b70)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

[3.12] gh-109118: Fix runtime crash when NameError happens in PEP 695 function (GH-109123) (#109173)

* gh-109118: Fix runtime crash when NameError happens in PEP 695 function (#109123)

(cherry picked from commit 17f994174de9211b2baaff217eeb1033343230fc)

* [3.12] gh-109118: Fix runtime crash when NameError happens in PEP 695 function (GH-109123).
(cherry picked from commit 17f994174de9211b2baaff217eeb1033343230fc)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] GH-109067: fix randomly failing `test_async_gen_asyncio_gc_aclose_09` test (GH-109142) (#109149)

GH-109067: fix randomly failing `test_async_gen_asyncio_gc_aclose_09` test (GH-109142)

Use `asyncio.sleep(0)` instead of short sleeps.
(cherry picked from commit ccd48623d4860e730a16f3f252d67bfea8c1e905)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>

[3.12] gh-109022: [Enum] require `names=()` to create empty enum type (GH-109048) (#109122)

gh-109022: [Enum] require `names=()` to create empty enum type (GH-109048)

add guard so that ``Enum('bar')`` raises a TypeError instead of
creating a new enum class called `bar`.  To create the new but
empty class, use:

    huh = Enum('bar', names=())
(cherry picked from commit c74e440168fab9bf91346471087a394af13fa2db)

Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

[3.12] gh-108732: include comprehension locals in frame.f_locals (GH-109026) (#109097)

gh-108732: include comprehension locals in frame.f_locals (GH-109026)
(cherry picked from commit f2584eade378910b9ea18072bb1dab3dd58e23bb)

Co-authored-by: Carl Meyer <carl@oddbird.net>
Co-authored-by: Radislav Chugunov <52372310+chgnrdv@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] gh-106922: Fix error location for constructs with spaces and parentheses (GH-108959) (#109147)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>

[3.12] gh-103186: Suppress RuntimeWarning about unclosed async iterator in test_sys_settrace (GH-109075) (#109138)

gh-103186: Suppress RuntimeWarning about unclosed async iterator in test_sys_settrace (GH-109075)
(cherry picked from commit d485551c9d1792ff3539eef1d6374bd4c01dcd5d)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] Add version directives to ast docs (GH-108788) (#109106)

Add version directives to ast docs (GH-108788)
(cherry picked from commit 74fc96bc60f5c02bde50ff2f3516add99483e402)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>

[3.12] gh-68403: Fix test_coverage in test_trace (GH-108910) (#109104)

gh-68403: Fix test_coverage in test_trace (GH-108910)

Its behavior no longer affected by test running options such as -m.
(cherry picked from commit 7e1a7abb9831965cdec477e62dbe4f8415b8a582)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-75743: Restore test_timeout.testConnectTimeout() (GH-109087) (#109103)

gh-75743: Restore test_timeout.testConnectTimeout() (GH-109087)

This un-skips this test now that pythontest.net implements appropriate firewall
rules for it.
(cherry picked from commit 1829a3c9a3712b6a68a3a449e4a08787c73da51d)

Co-authored-by: Ee Durbin <ewdurbin@gmail.com>

[3.12] gh-107924: re-order os.sendfile() flag documentation (GH-107926) (#109099)

gh-107924: re-order os.sendfile() flag documentation (GH-107926)
(cherry picked from commit 403ab1306a6e9860197bce57eadcb83418966f21)

Co-authored-by: Christoph Anton Mitterer <mail@christoph.anton.mitterer.name>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-102823: Document return type of floor division on floats (GH-102824) (#109092)

gh-102823: Document return type of floor division on floats (GH-102824)
(cherry picked from commit b72251de930c8ec6893f1b3f6fdf1640cc17dfed)

Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] socket documentation fix - rename triple to 3-tuple (GH-24722) (#109073)

socket documentation fix - rename triple to 3-tuple (GH-24722)
(cherry picked from commit 6b15ff52351787644115a4dd9d5d6717d66b9806)

Co-authored-by: Ori Hoch <ori@uumpa.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-71770: Add more details on behavior of configparser's default_section (GH-31562) (#109088)

gh-71770: Add more details on behavior of configparser's default_section (GH-31562)
(cherry picked from commit 891236f48263e2d4c650b7a127fc9bffb8327807)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-103186: Remove debug print in test_sys_settrace (GH-109077) (#109084)

gh-103186: Remove debug print in test_sys_settrace (GH-109077)
(cherry picked from commit e4bb0026b9a21d066e7a5c4716ea4d755b95d2d5)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] GH-90915: Document that SystemExit doesn't trigger sys.excepthook (GH-31357) (#109082)

GH-90915: Document that SystemExit doesn't trigger sys.excepthook (GH-31357)
(cherry picked from commit 1294fcede09af6c781553b7a3a6ff612c7dfa431)

Co-authored-by: Colin Watson <cjwatson@debian.org>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] bpo-38157: Add example about per file output for mock_open. (GH-16090) (#109071)

bpo-38157: Add example about per file output for mock_open. (GH-16090)
(cherry picked from commit e183a71eef1ec3ac86bb4d81a158c21d6f1a783b)

Co-authored-by: Karthikeyan Singaravelan <tir.karthi@gmail.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-103186: Suppress and assert expected RuntimeWarnings in test_sys_settrace (GH-103244) (#109066)

gh-103186: Suppress and assert expected RuntimeWarnings in test_sys_settrace (GH-103244)

Caused as a result of frame manipulation where locals are never assigned / initialised.
(cherry picked from commit 3e53ac99038920550358c1ea0212c3907a8cb385)

Co-authored-by: Ijtaba Hussain <ijtabahussain@live.com>

[3.12] test.pythoninfo logs freedesktop_os_release() (GH-109057) (#109064)

test.pythoninfo logs freedesktop_os_release() (GH-109057)
(cherry picked from commit babdced23fc299b7607ac76abfdd7a81050f8359)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-108915: Removes extra backslashes in str.split docstring (GH-109044). (#109061)

* [3.12] gh-108915: Removes extra backslashes in str.split docstring (GH-109044).
(cherry picked from commit e7d5433f944a5725aa82595f9251abfc8a63d333)

Co-authored-by: Daniel Weiss <134341009+justdan6@users.noreply.github.com>
* re-clinic

---------

Co-authored-by: Daniel Weiss <134341009+justdan6@users.noreply.github.com>

[3.12] gh-108740: Fix "make regen-all" race condition (#108741) (#109019)

gh-108740: Fix "make regen-all" race condition (#108741)

Fix a race condition in "make regen-all". The deepfreeze.c source and
files generated by Argument Clinic are now generated or updated
before generating "global objects". Previously, some identifiers may
miss depending on the order in which these files were generated.

* "make regen-global-objects": Make sure that deepfreeze.c is
  generated and up to date, and always run "make clinic".
* "make clinic" no longer runs generate_global_objects.py script.
* "make regen-deepfreeze" now only updates deepfreeze.c (C file).
  It doesn't build deepfreeze.o (object) anymore.
* Remove misleading messages in "make regen-global-objects" and
  "make clinic". They are now outdated, these commands are now
  safe to use.
* Document generates files in Doc/using/configure.rst.

Co-authored-by: Erlend E. Aasland <erlend@python.org>
(cherry picked from commit db1ee6a19ab62191c16ecb732cb4dcaede98a902)

[3.12] gh-108851: Fix tomllib recursion tests (GH-108853) (#109012)

gh-108851: Fix tomllib recursion tests (GH-108853)

* Add get_recursion_available() and get_recursion_depth() functions
  to the test.support module.
* Change infinite_recursion() default max_depth from 75 to 100.
* Fix test_tomllib recursion tests for WASI buildbots: reduce the
  recursion limit and compute the maximum nested array/dict depending
  on the current available recursion limit.
* test.pythoninfo logs sys.getrecursionlimit().
* Enhance test_sys tests on sys.getrecursionlimit()
  and sys.setrecursionlimit().
(cherry picked from commit 8ff11425783806f8cb78e99f667546b1f7f3428e)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-89392: Use unittest test runner for doctests in test_getopt (GH-108916) (#108919)

gh-89392: Use unittest test runner for doctests in test_getopt (GH-108916)
(cherry picked from commit f980cc19b9cafc09ef21e906871f810a1c89e62f)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-89392: Use normal unittest runner in test_type_cache (GH-108911) (#108913)

gh-89392: Use normal unittest runner in test_type_cache (GH-108911)
(cherry picked from commit eaabaac7c099884f92428a7bb04ffa1f1d6080dd)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-91960: Skip test_gdb if gdb cannot retrive Python frames (GH-108999) (#109010)

gh-91960: Skip test_gdb if gdb cannot retrive Python frames (GH-108999)

Skip test_gdb if gdb is unable to retrieve Python frame objects: if a
frame is "<optimized out>". When Python is built with "clang -Og",
gdb can fail to retrive the 'frame' parameter of
_PyEval_EvalFrameDefault(). In this case, tests like py_bt() are
likely to fail. Without getting access to Python frames,
python-gdb.py is mostly clueless on retrieving the Python traceback.
Moreover, test_gdb is no longer skipped on macOS if Python is built
with Clang.
(cherry picked from commit fbce43a251488f666be9794c908a6613bf8ae260)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-108983: Add more PEP 526 tests to `test_grammar` (GH-108984) (#109000)

gh-108983: Add more PEP 526 tests to `test_grammar` (GH-108984)
(cherry picked from commit 1fb20d42c58924e2e941622b3539645c7b843e0e)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-108962: Skip test_tempfile.test_flags() if not supported (GH-108964) (#108967)

gh-108962: Skip test_tempfile.test_flags() if not supported (GH-108964)

Skip test_tempfile.test_flags() if chflags() fails with "OSError:
[Errno 45] Operation not supported" (ex: on FreeBSD 13).
(cherry picked from commit cd2ef21b076b494224985e266c5f5f8b37c66618)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-108834: Sync libregrtest with the main branch (#108966)

* gh-108834: regrtest reruns failed tests in subprocesses (#108839)

When using --rerun option, regrtest now re-runs failed tests
in verbose mode in fresh worker processes to have more
deterministic behavior. So it can write its final report even
if a test killed a worker progress.

Add --fail-rerun option to regrtest: exit with non-zero exit code
if a test failed pass passed when re-run in verbose mode (in a
fresh process). That's now more useful since tests can pass
when re-run in a fresh worker progress, whereas they failed
when run after other tests when tests are run sequentially.

Rename --verbose2 option (-w) to --rerun. Keep --verbose2 as a
deprecated alias.

Changes:

* Fix and enhance statistics in regrtest summary. Add "(filtered)"
  when --match and/or --ignore options are used.
* Add RunTests class.
* Add TestResult.get_rerun_match_tests() method
* Rewrite code to serialize/deserialize worker arguments as JSON
  using a new WorkerJob class.
* Fix stats when a test is run with --forever --rerun.
* If failed test names cannot be parsed, log a warning and don't
  filter tests.
* test_regrtest.test_rerun_success() now uses a marker file, since
  the test is re-run in a separated process.
* Add tests on normalize_test_name() function.
* Add test_success() and test_skip() tests to test_regrtest.

(cherry picked from commit 31c2945f143c6b80c837fcf09a5cfb85fea9ea4c)

* gh-108834: regrtest --fail-rerun exits with code 5 (#108896)

When the --fail-rerun option is used and a test fails and then pass,
regrtest now uses exit code 5 ("rerun) instead of 2 ("bad test").

(cherry picked from commit 1170d5a292b46f754cd29c245a040f1602f70301)

* gh-108416: Mark slow but not CPU bound test methods with requires_resource('walltime') (GH-108480)

(cherry picked from commit 1e0d62793a84001e92f1c80b511d3a212b435acc)

* Manually sync Lib/test/libregrtest/ from main

---------

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-107755: Document the correct default value of slice step (GH-107756) (#108955)

gh-107755: Document the correct default value of slice step (GH-107756)

Document the correct default value of slice step.
(cherry picked from commit 9bf350b0662fcf1a8b43b9293e6c8ecf3c711561)

Co-authored-by: wim glenn <hey@wimglenn.com>

[3.12] gh-107732: Mention dir support in importlib.resources docs (GH-107734) (#109058)

gh-107732: Mention dir support in importlib.resources docs (#107734)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
(cherry picked from commit 9f0c0a46f00d687e921990ee83894b2f4ce8a6e7)

Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>

[3.12] gh-109015: Add test.support.socket_helper.tcp_blackhole() (GH-109016) (#109041)

gh-109015: Add test.support.socket_helper.tcp_blackhole() (GH-109016)

Skip test_asyncio, test_imaplib and test_socket tests if FreeBSD TCP
blackhole is enabled (net.inet.tcp.blackhole=2).
(cherry picked from commit a52a3509770f29f940cda9307704908949912276)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] Docs: Fix typo in datetime.tzinfo docstring (GH-107257) (#109032)

Docs: Fix typo in datetime.tzinfo docstring (GH-107257)
(cherry picked from commit 60a9eea3f56c002356998f5532b3ad870a1ffa8e)

Co-authored-by: Mikhail Samylov <Samylov-Mikhail@yandex.com>
Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] GH-108202: Document ``calendar``'s command-line interface (GH-109020) (#109030)

GH-108202: Document ``calendar``'s command-line interface (GH-109020)
(cherry picked from commit f0f96a9f40762499811681d405b6f922b6ed7a55)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] GH-90690: Mention removal of ``PRECALL`` in What's New (GH-103910) (#109027)

GH-90690: Mention removal of ``PRECALL`` in What's New (GH-103910)
(cherry picked from commit f9bd6e49ae58e0ba2934f29dd0f3299ba844cc8d)

Co-authored-by: Anthony Shaw <anthony.p.shaw@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] C API tests: use special markers to test that output parameters were set (GH-109014) (#109023)

[3.12] C API tests: use special markers to test that output parameters were set (GH-109014).
(cherry picked from commit bf414b7fcb7c8ba780a5e1d9f320ecef0c7f9488)

[3.12] gh-109002: Ensure only one wheel for each vendored package (GH-109003) (#109005)

Output with one wheel:
```
❯ GITHUB_ACTIONS=true ./Tools/build/verify_ensurepip_wheels.py
Verifying checksum for /Volumes/RAMDisk/cpython/Lib/ensurepip/_bundled/pip-23.2.1-py3-none-any.whl.
Expected digest: 7ccf472345f20d35bdc9d1841ff5f313260c2c33fe417f48c30ac46cccabf5be
Actual digest:   7ccf472345f20d35bdc9d1841ff5f313260c2c33fe417f48c30ac46cccabf5be
::notice file=/Volumes/RAMDisk/cpython/Lib/ensurepip/_bundled/pip-23.2.1-py3-none-any.whl::Successfully verified the checksum of the pip wheel.
```

Output with two wheels:
```
❯ GITHUB_ACTIONS=true ./Tools/build/verify_ensurepip_wheels.py
::error file=/Volumes/RAMDisk/cpython/Lib/ensurepip/_bundled/pip-22.0.4-py3-none-any.whl::Found more than one wheel for package pip.

::error file=/Volumes/RAMDisk/cpython/Lib/ensurepip/_bundled/pip-23.2.1-py3-none-any.whl::Found more than one wheel for package pip.
```

Output without wheels:
```
❯ GITHUB_ACTIONS=true ./Tools/build/verify_ensurepip_wheels.py
::error file=::Could not find a pip wheel on disk.
```
(cherry picked from commit f8a047941f2e4a1848700c21d58a08c9ec6a9c68)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

Merge branch '3.12' of https://github.com/python/cpython into 3.12

Post 3.12.0rc2

[3.12] gh-108857: improve markup in inspect.Signature.replace() docs (GH-108862) (#108971)

gh-108857: improve markup in inspect.Signature.replace() docs (GH-108862)
(cherry picked from commit 6f8411cfd68134ccae01b0b4cb332578008a69e3)

Co-authored-by: nabin2004 <107109731+nabin2004@users.noreply.github.com>

Python 3.12.0rc2

[3.12] gh-108469: Update ast.unparse for unescaped quote support from PEP701 [3.12] (GH-108553) (#108960)

Co-authored-by: Anthony Shaw <anthony.p.shaw@gmail.com>
Co-authored-by: sunmy2019 <59365878+sunmy2019@users.noreply.github.com>

[3.12] gh-108927: Fix test_import + test_importlib + test_unittest problem (GH-108929) (#108954)

gh-108927: Fix test_import + test_importlib + test_unittest problem (GH-108929)
(cherry picked from commit 3f89b257639dd817a32079da2ae2c4436b8e82eb)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-107565: Update Windows build to use OpenSSL 3.0.10 (GH-108928) (#108930)

gh-107565: Update Windows build to use OpenSSL 3.0.10 (GH-108928)
(cherry picked from commit deea7c82682848b2a0db971a4dcc3a32c73a9f8c)

Co-authored-by: Zachary Ware <zach@python.org>

[3.12] GH-103082: Document PEP-669: Low Impact Monitoring for CPython (GH-107772) (#108909)

GH-103082: Document PEP-669: Low Impact Monitoring for CPython (GH-107772)
(cherry picked from commit 8b515f60ee1dec65cb3d64f1cc1d4b32aa2f4184)

Co-authored-by: Mark Shannon <mark@hotpy.org>

[3.12] GH-108390: Prevent non-local events being set with `sys.monitoring.set_local_events()` (GH-108420) (#108899)

* GH-108390: Prevent non-local events being set with `sys.monitoring.set_local_events()` (GH-108420)

* Restore generated objects

* Restore size of monitoring arrays in code object for 3.12 ABI compatibility.

* Update ABI file

[3.12] gh-89392: Remove support of test_main() in libregrtest (GH-108876) (#108897)

[3.12] gh-89392: Remove support of test_main() in libregrtest (GH-108876).
(cherry picked from commit 04a0830b00879efe057e3dfe75e9aa9c0caf1a26)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] Link to PEP sections in What's New in 3.12 (GH-108878) (#108890)

Link to PEP sections in What's New in 3.12 (GH-108878)
(cherry picked from commit 7855d325e638a4b7f7b40f2c35dc80de82d8fe70)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] bpo-45229: Make ElementTree tests discoverable (GH-108859) (#108873)

[3.12] bpo-45229: Make ElementTree tests discoverable (GH-108859).
(cherry picked from commit 074ac1f72e392a576516639f650bac0519d1cb52)

[3.12] CI: Bump GitHub Actions (GH-108879) (#108889)

CI: Bump GitHub Actions (GH-108879)
(cherry picked from commit 572678e1f864cb042df6962848a436d84ef7a8a4)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-89392: Remove test_main() in test_netrc (GH-108860) (#108872)

[3.12] gh-89392: Remove test_main() in test_netrc (GH-108860).
(cherry picked from commit 76f3c043b6c5971d5a13fc6decf87a80ddf7ef95)

Co-authored-by: T. Wouters <thomas@python.org>

[3.12] Disable `differing_test_runners` health check (GH-108886) (#108887)

Disable `differing_test_runners` health check (GH-108886)
(cherry picked from commit 6ead5bd6ae20b902e6c11a3c0acede22632dc0d5)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-89392: Make test_pep646_syntax discoverable (GH-108861) (#108871)

* [3.12] gh-89392: Make test_pep646_syntax discoverable (GH-108861).
(cherry picked from commit d0b22f6bd84239e50b43709f98f2bb950222cfe5)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* Add "import unittest".

[3.12] Resolve reference warnings in faq/gui.rst (GH-108147) (#108193)

* Resolve reference warnings in faq/gui.rst (GH-108147)
(cherry picked from commit 8f3d09bf5d16b508fece5420a22abe6f0c1f00b7)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* Resolve reference warnings in faq/gui.rst

---------

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-46376: Revert "Return existing pointer when possible in ctypes (GH-107131) (GH-107487)" (#108864)

This reverts commit 54aaaadef8a44324f6be674707c67a3516470ff6.

Co-authored-by: T. Wouters <thomas@python.org>

[3.12] Reorder some test's decorators (GH-108804) (#108844)

Reorder some test's decorators (GH-108804)

For example, do not demand the 'cpu' resource if the test cannot be run
due to non-working threads.
(cherry picked from commit 509bb61977cc8a4487efd3f9cdd63d9f7b86be62)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-107208: Fix iter_index() recipe to not swallow exceptions (gh-108835) (#108837)

gh-107208: Fix iter_index() recipe to not swallow exceptions (gh-108835)
(cherry picked from commit f373c6b9483e12d7f6e03a631601149ed60ab883)

gh-107208: iter_index now supports "stop" and no longer swallows ValueError

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

[3.12] gh-108822: regrtest computes statistics (#108793) (#108833)

gh-108822: regrtest computes statistics (#108793)

test_netrc, test_pep646_syntax and test_xml_etree now return results
in the test_main() function.

Changes:

* Rewrite TestResult as a dataclass with a new State class.
* Add test.support.TestStats class and Regrtest.stats_dict attribute.
* libregrtest.runtest functions now modify a TestResult instance
  in-place.
* libregrtest summary lists the number of run tests and skipped
  tests, and denied resources.
* Add TestResult.has_meaningful_duration() method.
* Compute TestResult duration in the upper function.
* Use time.perf_counter() instead of time.monotonic().
* Regrtest: rename 'resource_denieds' attribute to 'resource_denied'.
* Rename CHILD_ERROR to MULTIPROCESSING_ERROR.
* Use match/case syntadx to have different code depending on the
  test state.

Notes on the backport: doctest.TestResults.skipped is a new feature
in Python 3.13, so don't use it in the backport.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit d4e534cbb35678c82b3a1276826af55d7bfc23b6)

[3.12] gh-108416: Mark slow test methods with @requires_resource('cpu') (GH-108421) (#108798)

gh-108416: Mark slow test methods with @requires_resource('cpu') (GH-108421)

Only mark tests which spend significant system or user time,
by itself or in subprocesses.
(cherry picked from commit f3ba0a74cd50274acdcd592d4ce8395b92492b7c)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-63760: Don't declare gethostname() on Solaris (#108817) (#108824)

gh-63760: Don't declare gethostname() on Solaris (#108817)

Since 2005, Solaris defines gethostname(). socketmodule.c no longer
has to define gethostname() for Solaris.

Oracle Solaris and OpenSolaris have patches to remove the
gethostname() definition in Python:

* https://github.com/oracle/solaris-userland/blob/master/components/python/python37/patches/15-gethostname.patch
* https://github.com/OpenIndiana/oi-userland/blob/oi/hipster/components/python/python37/patches/15-gethostname.patch
* https://github.com/omniosorg/omnios-build/blob/master/build/python27/patches/24-gethostname.patch

Co-authored-by: Jakub Kulík <Kulikjak@gmail.com>
(cherry picked from commit 0e6d582b3b73a88e71cae04327b31a1ee203722c)

[3.12] gh-101100: Fix sphinx warnings in `unittest.mock-examples.rst` (GH-108810) (#108813)

* [3.12] gh-101100: Fix sphinx warnings in `unittest.mock-examples.rst` (GH-108810).
(cherry picked from commit 5141b1ebe07ad54279e0770b4704eaf76f24951d)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* Make the requested changes

---------

Co-authored-by: AlexWaygood <alex.waygood@gmail.com>

[3.12] gh-101100: Fix sphinx warnings in `uuid.rst` (GH-108805) (#108807)

* gh-101100: Fix sphinx warnings in `uuid.rst` (GH-108805)

* gh-101100: Fix sphinx warnings in `uuid.rst`

* Use anchors
(cherry picked from commit 21da4980f5916e8fd648f04367a9e60d141af366)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* Fix typo

* another typo

---------

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-106392: Fix inconsistency in deprecation warnings (GH-106436) (#108792)

gh-106392: Fix inconsistency in deprecation warnings (GH-106436)

They used "datetime" to refer to both the object and the module.
(cherry picked from commit d5c5d4bfd3260219397326795d3b2ff62a9ab8cb)

Co-authored-by: William Andrea <william.j.andrea@gmail.com>

[3.12] gh-105563: reference DateType in datetime's documentation (GH-105946) (#108789)

gh-105563: reference DateType in datetime's documentation (GH-105946)
(cherry picked from commit 8f9ea43ee805f98391f857397daac9df7ffa71cd)

Co-authored-by: TATHAGATA ROY <royzen9495@gmail.com>

[3.12] Improve some C API documentation (GH-108768) (#108785)

* Express functions which take argument as a C string in terms of
  functions which take Python object.
* Use "note" directive for PyMapping_HasKey() and
  PyMapping_HasKeyString() notes..
(cherry picked from commit 6f97eeec222f81bd7ae836c149872a40b079e2a6)

[3.12] Add Modules/_testcapi/util.h header (GH-108774) (#108780)

Add Modules/_testcapi/util.h header (GH-108774)

It contains common macros used in C API tests.
(cherry picked from commit 0e01fac315dfa705ac8a6954485546f28cf4c87d)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-101100: Fix sphinx warnings in `tutorial/appendix.rst` (GH-108750) (#108759)

(cherry picked from commit 3047f09490ae63f25d57efe1d14a9a65d9b5f6db)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] Make test_fcntl quiet (GH-108758) (#108760)

Make test_fcntl quiet (GH-108758)

Running test_fcntl logs two "struct.pack: ..." lines because
multiprocessing imports test_fcntl twice with
test.support.verbose=1. Move get_lockdata() inside TestFcntl test
case and only call it where it's needed, to stop logging these lines.
(cherry picked from commit 23f54c120067c96973619b9501fe4dff1b055188)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.12] gh-101100: Fix sphinx warnings in `tutorial/classes.rst` (GH-108746) (#108756)

gh-101100: Fix sphinx warnings in `tutorial/classes.rst` (GH-108746)
(cherry picked from commit e775601ef1ada83a80e1539d0bcd5509deadee14)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-107805: Fix signatures of module-level generated functions in `turtle` (GH-107807) (#108749)

gh-107805: Fix signatures of module-level generated functions in `turtle` (GH-107807)
(cherry picked from commit 044b8b3b6a65e6651b161e3badfa5d57c666db19)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] `ast` docs: Fix incorrect link on `keyword` (GH-108728) (#108737)

`ast` docs: Fix incorrect link on `keyword` (GH-108728)

In two places, Sphinx was erroneously adding links to the `keyword` module instead of the `ast.keyword` class
(cherry picked from commit c1e2f3b2f70b8a72ea7e1bf792addf62a94ae65d)

Co-authored-by: Alex Povel <git@alexpovel.de>

[3.12] gh-108682: [Enum] raise TypeError if super().__new__ called in custom __new__ (GH-108704) (#108733)

gh-108682: [Enum] raise TypeError if super().__new__ called in custom __new__ (GH-108704)

When overriding the `__new__` method of an enum, the underlying data type should be created directly; i.e. .

    member = object.__new__(cls)
    member = int.__new__(cls, value)
    member = str.__new__(cls, value)

Calling `super().__new__()` finds the lookup version of `Enum.__new__`, and will now raise an exception when detected.
(cherry picked from commit d48760b2f1e28dd3c1a35721939f400a8ab619b8)

Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

[3.12] gh-97850: Note in py312 whatsnew that `importlib.util.set_loader` and `importlib.util.module_for_loader` have been removed (GH-108719) (#108723)

gh-97850: Note in py312 whatsnew that `importlib.util.set_loader` and `importlib.util.module_for_loader` have been removed (GH-108719)

Note in py312 whatsnew that `importlib.util.set_loader` and `importlib.util.module_for_loader` have been removed
(cherry picked from commit 013a99a47b3299f48cf7f95aa451a116441b029c)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-101100: Fix sphinx warnings in `threading.rst` (GH-108684) (#108707)

gh-101100: Fix sphinx warnings in `threading.rst` (GH-108684)
(cherry picked from commit 991e4e76b54b69f227242e73c2ec9d62f903da53)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-108654: restore comprehension locals before handling exception (GH-108659) (#108700)

gh-108654: restore comprehension locals before handling exception (GH-108659)
(cherry picked from commit d52c4482a82f3f98f1a78efa948144a1fe3c52b2)

Co-authored-by: Carl Meyer <carl@oddbird.net>
Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>

[3.12] gh-108520: Fix bad fork detection in nested multiprocessing use case (GH-108568) (#108691)

gh-108520: Fix bad fork detection in nested multiprocessing use case (GH-108568)

gh-107275 introduced a regression where a SemLock would fail being passed along nested child processes, as the `is_fork_ctx` attribute would be left missing after the first deserialization.

---------

(cherry picked from commit add8d45cbe46581b9748909fbbf60fdc8ee8f71e)

Co-authored-by: albanD <desmaison.alban@gmail.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Antoine Pitrou <pitrou@free.fr>

[3.12] gh-101100: Fix Sphinx warnings in the Logging Cookbook (GH-108678) (#108680)

gh-101100: Fix Sphinx warnings in the Logging Cookbook (GH-108678)
(cherry picked from commit c7cef546319c51defa01236469b636b6978b99ab)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] Fix typo in multiprocessing docs (GH-108666) (#108677)

Fix typo in multiprocessing docs (GH-108666)
(cherry picked from commit 38ab0dba801884b0963ef0daa95e94e120a2b524)

Co-authored-by: kato8966 <66937409+kato8966@users.noreply.github.com>

[3.12] gh-108669: unittest: Fix documentation for TestResult.collectedDurations (GH-108670) (#108672)

gh-108669: unittest: Fix documentation for TestResult.collectedDurations (GH-108670)
(cherry picked from commit 6c484c39beeb66d40ef0a73cc4f1e900ea498cfa)

Co-authored-by: Sebastian Rittau <srittau@rittau.biz>

[3.12] Mention Ellipsis pickling in the docs (GH-103660) (#108661)

Mention Ellipsis pickling in the docs (GH-103660)
(cherry picked from commit 14ec0bb7c363def917f768b76f334146a3cddd84)

Co-authored-by: sterliakov <50529348+sterliakov@users.noreply.github.com>

[3.12] gh-107801: Improve the accuracy of io.IOBase.seek docs (#108268) (#108655)

(cherry picked from commit 8178a88bd81edae87d6974483e4de9b32e808797)

- Add param docstrings
- Link to os.SEEK_* constants
- Mention the return value in the initial paragraph

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-108617: Extend interactive session tests for sqlite3 (GH-108556) (#108626)

gh-108617: Extend interactive session tests for sqlite3 (GH-108556)
(cherry picked from commit ecb2bf02a4a564b638f756ce6e644ec17b6edf16)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>