[3.13] gh-138204: Forbid expansion of a shared anonymous mmap on Linux (GH-138220) (GH-138387)

This is a Linux kernel bug which caused a bus error.
https://bugzilla.kernel.org/show_bug.cgi?id=8691
(cherry picked from commit 33fcb0c4a054f646d9d3686c145209a893b09bb0)

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

[3.13] GH-101100: Resolve reference warnings in whatsnew/3.7.rst (GH-138410) (#138424)

GH-101100: Resolve reference warnings in whatsnew/3.7.rst (GH-138410)

Resolve reference warnings in whatsnew/3.7.rst
(cherry picked from commit dd86fb4ba5a9db1c1e7293917af68d0cf0ddeaaf)

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

[3.13] gh-101100: Resolve reference warnings in library/xml.sax.handler.rst (GH-136612) (#138422)

Co-authored-by: Weilin Du <108666168+LamentXU123@users.noreply.github.com>

[3.13] Doc: Track file downloads via plausible (GH-138393) (#138397)

Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] gh-136599: Add tests for long_hash (GH-138335) (#138391)

gh-136599: Add tests for long_hash (GH-138335)
(cherry picked from commit 2d3711dc06657e072a83b580636cbb0009658636)

Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>

[3.13] gh-138297 Point link in docs for `finally` to try/else, instead of if/else (GH-138298) (#138382)

Co-authored-by: James Parrott <80779630+JamesParrott@users.noreply.github.com>
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>

[3.13] gh-89905: Correct `-R` option doc (GH-137608) (#138354)

gh-89905: Correct `-R` option doc (GH-137608)
(cherry picked from commit b3ff3165d2c935fdda7c5bb1e69314372e1cf84c)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

[3.13] gh-54874: Expand unicodedata module documentation (GH-138301) (#138345)

* gh-54874: Expand unicodedata module documentation (GH-138301)

Closes GH-54874
(cherry picked from commit 0d383f86eec97b343457ee1ce1d274f6b3d9ce6c)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
* Changes links to UCD 15.0.0

---------

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>

[3.13] gh-116946: Revert GC protocol for immutable empty heap types (GH-138322, GH-138323, GH-138326) (#138337)

* Revert "[3.13] gh-116946: fully implement GC protocol for `bz2` objects (GH-138266) (#138322)"

This reverts commit 90036f51fe4bb2eed0e5161f26712cf08e1563d2.

* Revert "[3.13] gh-116946: fully implement GC protocol for `lzma` objects (GH-138288) (#138323)"

This reverts commit 828682df868217788cda695a21bb63635f6fadc7.

* Revert "[3.13] gh-116946: fully implement GC protocol for `_hashlib` objects (GH-138289) (#138326)"

This reverts commit 21b593219ad5cf444553afaebe12ff9137d4d55e.

[3.13] gh-116946: fully implement GC protocol for `zlib` objects (GH-138290) (#138328)

(cherry picked from commit 2a54acf3c3d9f388c3d878a17ea804a801affca9)

[3.13] gh-116946: fully implement GC protocol for `_hashlib` objects (GH-138289) (#138326)

(cherry picked from commit 6f1dd9551a69c8c76d066a04e94db6dbc6c7597c)

[3.13] gh-116946: fully implement GC protocol for `lzma` objects (GH-138288) (#138323)

(cherry picked from commit 3ea16f990f81e1e3b2892f1dfd213937b1df2a68)

[3.13] gh-116946: fully implement GC protocol for `bz2` objects (GH-138266) (#138322)

(cherry picked from commit 9be91f6a20ed2fd9b491c3e779dc45c7392f60ca)

[3.13] gh-138295: Fix a grammar issue in the descriptor HOWTO (GH-138296) (GH-138300)

gh-138295: Fix a grammar issue in the descriptor HOWTO (GH-138296)

"an str" -> "a str"
(cherry picked from commit 552cf86b83e8aafebcfe9abbc77101bdbfda14c8)

Co-authored-by: Fangyi Zhou <me@fangyi.io>

[3.13] gh-133829: Remove some specifics from the ``zipimport`` example (GH-133835) (#138273)

Co-authored-by: R Chintan Meher <meherrihaan@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

[3.13] gh-138158: Use the `"data"` tarfile extraction filter in `Tools/ssl/multissltests.py` (GH-138147) (#138263)

gh-138158: Use the `"data"` tarfile extraction filter in `Tools/ssl/multissltests.py` (GH-138147)

The `Tools/ssl/multissltests.py` script may extract a possibly untrusted tarball.
Since the script does not necessarily use Python 3.14 or later (where the `"data"`
filter became the default `tarfile` extraction filter), the user may theoretically
suffer from a path traversal attack.

Although the script should not be used in production and usually relies on downloading
trusted sources, the `"data"` extraction filter is now explicitly used wherever relevant.
(cherry picked from commit 31d3836f26096f9503ca68f4e89d927bc1e060cd)

Co-authored-by: Tommaso Bona <piergeolo@gmail.com>

[3.13] gh-138257: Fix internal `RuleCollectorVisitor` attribute name (GH-138208) (#138260)

gh-138257: Fix internal `RuleCollectorVisitor` attribute name (GH-138208)

The internal `RuleCollectorVisitor` class had an attribute named "rulses"
instead of "rules" that other `GrammarVisitor` subclasses define.
(cherry picked from commit 11217a883da324b85a290f5d78f090d8f4880f16)

Co-authored-by: chemelnucfin <3982092+chemelnucfin@users.noreply.github.com>

[3.13] gh-123858: Improve Doc: SyntaxWarning is emitted during bytecode generation (gh-138243)

---------
(cherry picked from commit 5f7906715adea645d8141d5337851872cfca4381)

Co-authored-by: Hang <bebound@gmail.com>
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>

[3.13] gh-137317: Fix inspect.signature() for class with wrapped __init__ or __new__ (GH-137862) (GH-138225)

Fixed several cases where __init__, __new__ or metaclass` __call__ is a descriptor
that returns a wrapped function.
(cherry picked from commit 025a2135eff848abf24f9dc52c81386eea9da397)

Co-authored-by: Ju4tCode <42488585+yanyongyu@users.noreply.github.com>

[3.13] bpo-41839: Fix error checking in sched_get_priority_ functions (GH-22374) (GH-138202)

(cherry picked from commit bbcb75c986c47887e6c0757e63d59cd7af544f39)

Co-authored-by: Jakub Kulík <Kulikjak@gmail.com>

[3.13] Docs: Fix typo in `shutil.make_archive` example (GH-138188) (GH-138196)

Docs: Fix typo in `shutil.make_archive` example (GH-138188)
(cherry picked from commit f733e428f8d19cb211f24ca7fb8abf65e1f2efed)

Co-authored-by: Andreas Pelme <andreas@pelme.se>

[3.13] gh-71679: Improve tests for repr() of bytes and bytearray (GH-138180) (GH-138183)

* Merge existing tests test_repr_str and test_to_str.
* Add more tests for non-printable and non-ASCII bytes.
* Add tests for special escape sequences ('\t\n\r').
* Add tests for slashes.
* Add more tests for quotes.
* Add tests for subclasses.
* Add test for non-ASCII class name.
* Only apply @check_bytes_warnings for str() tests.
(cherry picked from commit 0dbbf61cc2550428ff99daee367364c688031e1a)

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

[3.13] gh-106318: Add example for `str.find()` (GH-134529) (#138175)

Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.13] gh-137740: Clarify `__del__` invocation mechanism in reference counting (GH-137741) (#138112)

gh-137740: Clarify `__del__` invocation mechanism in reference counting (GH-137741)
(cherry picked from commit 90b932e65080008dfd974b2e03c3068dbb72b95d)

Co-authored-by: Robin Narsingh Ranabhat <robinnarsingha123@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>

[3.13] enhance docs for critical sections (GH-137334) (#138168)

enhance docs for critical sections (GH-137334)
(cherry picked from commit 5ae8b97f6bdcadd0cc15e0046b0db09e4c6e0d6b)

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

[3.13] gh-138148: Fix grammatical error in the `asynchronous generator iterator` term (GH-138155) (GH-138160)

gh-138148: Fix grammatical error in the `asynchronous generator iterator` term (GH-138155)
(cherry picked from commit 43b113d23dfc5ab28d97fbb7ac94a36b361928d4)

Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>

[3.13] gh-137609: Update signatures of builtins in the documentation (GH-137610) (GH-138138)

Show signatures that match the actual signatures or future multisignatures
for all functions, classes and methods in the "builtins" module.
(cherry picked from commit 65fb4d11a0f3f3e4aea373bd84918e4445cbfe67)

[3.13] Lint: Create a project-wide ``.ruff.toml`` settings file (GH-133124) (#137670)

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

[3.13] gh-138081: Fix/remove incorrect links in `idlelib/HISTORY.txt` (GH-138091) (#138125)

gh-138081: Fix/remove incorrect links in `idlelib/HISTORY.txt` (GH-138091)
(cherry picked from commit be24ff0b5738365bdc5921689feee9c2c68eebc3)

Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>

[3.13] gh-135261: bring back CI job for testing OpenSSL 1.1.1w (GH-135262) (#138110)

This partially reverts commit ad944b5e1f304be1a8c2cc03e9f15005bcb97108
by bringing back the CI job for testing OpenSSL 1.1.1w. Despite this
version being upstream EOL, the rationale for keeping it as follows:

- It most resembles other 1.1.1-work-a-like ssl APIs supported by important vendors.
- Python officially requires OpenSSL 1.1.1 or later, although OpenSSL 3.0 or later
  is recommended for cryptographic modules. Since changing the build requirements
  requires a transition period, we need to keep testing the allowed versions.
- The code base still contains calls to OpenSSL functions that are deprecated since
  OpenSSL 3.0 as well as `ifdef` blocks constrained to OpenSSL 1.1.1.

(cherry picked from commit 96b7a2eba423b42320f15fd4974740e3e930bb8b)

[3.13] gh-137986: Fix and improve the csv functions docstrings (GH-137987) (GH-138108)

The csv.register_dialect() docstring no longer imply that it returns a
dialect.
All functions have now signatures.
(cherry picked from commit aa1dbd4dde32951de2e7438b56d6761001604ee2)

Co-authored-by: maurycy <5383+maurycy@users.noreply.github.com>

[3.13] gh-136134: smtplib: fix CRAM-MD5 on FIPS-only environments (GH-136623) (#138087)

(cherry picked from commit 766614f88af0433c2c14f5c4ed11c92d0fb04e61)
(cherry picked from commit ab1bef8ad27ad531a1109cfc016ea627d94f9cc1)

[3.13] gh-136134: imaplib: fix CRAM-MD5 on FIPS-only environments (GH-136615) (#138055)

(cherry picked from commit 4519b8acb5a65df2af69e60b0d8c0a5df5bfb087)

[3.13] gh-137754: Fix import of zoneinfo if _datetime is not available (GH-137845) (GH-138085)

Both modules should use the Python implementation in that case.
(cherry picked from commit 6620ef0ff62dea2632bedf9afa88aa4780a2c9d9)

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

[3.13] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138076)

gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082)

Specifically, clarify that ZipInfo.date_time pulls the datetime information from the central directory, and that times are interpreted as local time.
(cherry picked from commit 282e88506b1d3c2ea2a0fd2fbce6c4e27ddc1c92)

Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com>
Co-authored-by: Emma Smith <emma@emmatyping.dev>

[3.13] gh-91116: Add hyperlink from `sys.settrace` to frame objects (GH-138062) (GH-138069)

gh-91116: Add hyperlink from `sys.settrace` to frame objects (GH-138062)
(cherry picked from commit f278afcabf1a1c4162a0bfd4912662517d5d04a2)

Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>

[3.13] gh-135386: Skip readonly tests for the root user (GH-138058) (GH-138064)

(cherry picked from commit 5b0f00e616738ededcf4b178dee8c30f5005e7ae)

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

[3.13] gh-132744: Check recursion limit in _PY_FRAME_GENERAL (GH-132746) (GH-138032)

[3.13] gh-135386: Fix "unable to open database file" errors on readonly DB (GH-135566) (GH-138057)

Add immutable=1 flag for read-only SQLite access to avoid WAL/SHM errors on readonly DB.
(cherry picked from commit c0ae92b7c07d8146bbcc6ed5197f97a7a16efded)

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

[3.13] gh-137973: Add a non-parallel test plan to the iOS testbed project (GH-138018) (#138039)

Modifies the iOS testbed project to add a test plan. This simplifies the iOS
test runner, as we can now use the built-in log streaming to see test results.
It also allows for some other affordances, like providing a default LLDB config,
and using a standardized mechanism for specifying test arguments.
(cherry picked from commit 2ba2287b85eea3cc3a71d77c6bcf9eb5670ca05d)

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>

[3.13] gh-135734: correctly handle `--enable-optimizations --disable-test-modules` combination (#137998)

[3.13] gh-138011: Clarify tutorial method object example code (GH-138014) (#138026)

x must be a MyClass instance for examples to work.

---------

(cherry picked from commit 339f5da6395868073e22157424405b89cafb5c6d)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

[3.13] gh-137477: Fix inspect.getblock() for generator expressions (GH-137488) (GH-137995)

This fixes also inspect.getsourcelines() and inspect.getsource().
(cherry picked from commit eae9d7de1c45a64076a926d53672823e6ae1777d)

[3.13] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (#137991)

gh-137900: Improve dataclasses frozen parameter documentation (GH-137937)
(cherry picked from commit 7685b8ada84822a7ee9ce51e8ee0e2e35fd60b4e)

Co-authored-by: Tangyuan <47830915@qq.com>

[3.13] Fix typo in `logging` docs (GH-137981) (GH-137984)

Fix typo in `logging` docs (GH-137981)
(cherry picked from commit 9b5235b62ed85e4757f1530cd73ef8d318be6215)

Co-authored-by: Maximilian Linhoff <maximilian.linhoff@cta-observatory.org>

[3.13] Update the dbm documentation (GH-137919) (GH-137963)

Unify documentation for all backends, enumerate all not implemented mapping
methods, document particularities of implemented mapping methods.
(cherry picked from commit 8700404f8688d6a56279dce47a5a5802ec53ed06)

[3.13] [docs] fix grammar in ssl.SSLContect.sslsocket_class docs (GH-137935) (#137951)

[docs] fix grammar in ssl.SSLContect.sslsocket_class docs (GH-137935)

---------
(cherry picked from commit 379161dd51c2cf67568e007fbb5fa225e73c9e10)

Co-authored-by: PrinceNaroliya <naroliyaprince@gmail.com>
Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>

[3.13] gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (GH-137859) (#137907)

Co-authored-by: Bar Harel <bzvi7919@gmail.com>

[3.13] gh-134869: Fix Ctrl+C corrupts REPL  autocomplete (GH-134929) (#137925)

gh-134869: Fix Ctrl+C corrupts REPL  autocomplete (GH-134929)
(cherry picked from commit 8750e5ecfcfbc337efb511046d34f28b2d26bd68)

Co-authored-by: ggqlq <124190229+ggqlq@users.noreply.github.com>

[3.13] gh-44538: Mention nested classes/functions in doctest docs (GH-137870) (GH-137917)

gh-44538: Mention nested classes/functions in doctest docs (GH-137870)
(cherry picked from commit 138ed6db9f89171983dc32af4e7ad2e73d46a940)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>

[3.13] gh-123085: _compile_importlib: Avoid copying sources before compilation (GH-124131) (#137914)

gh-123085: _compile_importlib: Avoid copying sources before compilation (GH-124131)
(cherry picked from commit 42c8b0556c02d29e32f4c7c95e7128a343716250)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>

[3.13] gh-135862: add C contiguous one-dimensional buffer requirement to `asyncio.StreamWriter` docs (GH-137910) (#137913)

gh-135862: add C contiguous one-dimensional buffer requirement to `asyncio.StreamWriter` docs (GH-137910)
(cherry picked from commit 1c3950abc1d403bddce5212c08d6c40e78486e9d)

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

[3.13] gh-131885: Use positional-only markers for the ``decimal`` module (GH-131990) (#137904)

Co-authored-by: Semyon Moroz <donbarbos@proton.me>

[3.13] gh-87135: Hang non-main threads that attempt to acquire the GIL during finalization (GH-105805) (GH-137827)

* [3.13] gh-87135: Hang non-main threads that attempt to acquire the GIL during finalization (GH-105805)

Instead of surprise crashes and memory corruption, we now hang threads that attempt to re-enter the Python interpreter after Python runtime finalization has started. These are typically daemon threads (our long standing mis-feature) but could also be threads spawned by extension modules that then try to call into Python. This marks the `PyThread_exit_thread` public C API as deprecated as there is no plausible safe way to accomplish that on any supported platform in the face of things like C++ code with finalizers anywhere on a thread's stack. Doing this was the least bad option.

(cherry picked from commit 8cc5aa47ee464ddfd8da5461edecf4a5c72df2ff)

Co-authored-by: Jeremy Maitin-Shepard <jeremy@jeremyms.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
* state "3.13.7 and earlier"
* backport: do not add the deprecated marker
* fix Py_IsFinalizing doc ref

---------

Co-authored-by: Jeremy Maitin-Shepard <jeremy@jeremyms.com>

[3.13] gh-135661: Fix parsing unterminated bogus comments in HTMLParser (GH-137873) (GH-137875)

Bogus comments that start with "<![CDATA[" should not include the starting "!"
in its value.
(cherry picked from commit 7636a66635a0da849cfccd06a52d0a21fb692271)

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

[3.13] gh-137846: Add missing 'be' to profile doc. (GH-137856) (#137858)

gh-137846: Add missing 'be' to profile doc. (GH-137856)

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

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

[3.13] gh-90483: fix docs of `SubprocessTransport.get_pipe_transport ` (GH-137852) (#137854)

gh-90483: fix docs of `SubprocessTransport.get_pipe_transport ` (GH-137852)
(cherry picked from commit 038a6e3b959b1fa55f43b2e60bc207c01f7da0ce)

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

[3.13] gh-101359: clarify docs for `asyncio.Event.clear` (GH-137849) (#137851)

gh-101359: clarify docs for `asyncio.Event.clear` (GH-137849)
(cherry picked from commit 4b2dbe8e0aa35046622f87dec1fa42da4d2deb2d)

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

[3.13] gh-131178: Add tests for `site` command-line interface  (GH-133582) (GH-137833)

gh-131178: Add tests for `site` command-line interface  (GH-133582)
(cherry picked from commit 03f5519d776e28ffd0b8344ef328ecddf863fe0a)

Co-authored-by: ggqlq <124190229+ggqlq@users.noreply.github.com>

[3.13] gh-137777: Disband the 'Program Frameworks' chapter (GH-137796) (#137831)

Co-authored-by: rimchoi <hyerimc858@gmail.com>

[3.13] gh-123085: Fix issue in inferred caller when resource package has no source (GH-123102) (#124024)

[3.13] Mention the "context manager" keyword in concurrent.futures documentation (GH-130976) (#137811)

Mention the "context manager" keyword in concurrent.futures documentation (GH-130976)
(cherry picked from commit 095bc775ecb5d4213767de3feebaa5a98d8c603c)

Co-authored-by: Jakub Stasiak <jakub@stasiak.at>

[3.13] gh-137760: Update REPL constants documentation (gh-137798) (gh-137823)

gh-137760: Update REPL constants documentation (gh-137798)
(cherry picked from commit d6719c6be651bbc6a8547c3b65714184e06462de)

Co-authored-by: Chaemin-Lim <antraxmin@naver.com>

[3.13] gh-137576: Fix for Basic REPL showing incorrect code in tracebacks with `PYTHONSTARTUP` (GH-137625) (#137778)

(cherry picked from commit 04f8ef663be7589def9f456a2024e1707e3408ea)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>

[3.13] gh-134262: Catch both URLError and ConnectionError in retries (GH-135365) (#137779)

gh-134262: Catch both URLError and ConnectionError in retries (GH-135365)
(cherry picked from commit acc20a83f4d93682e91c4992c785eaf7e3d0c69c)

Co-authored-by: Emma Smith <emma@emmatyping.dev>

[3.13] gh-134262: Fix off by one errors in download retry functions (GH-137775)

(cherry picked from commit e64395e8eb8d3a9e35e3e534e87d427ff27ab0a5)

Co-authored-by: Emma Smith <emma@emmatyping.dev>

[3.13] gh-135661: Fix CDATA section parsing in HTMLParser (GH-135665) (GH-137773)

"] ]>" and "]] >" no longer end the CDATA section.

Make CDATA section parsing  context depending.
Add private method HTMLParser._set_support_cdata() to change the context.
If called with True, "<[CDATA[" starts a CDATA section which ends with "]]>".
If called with False, "<[CDATA[" starts a bogus comments which ends with ">".
(cherry picked from commit 0cbbfc462119b9107b373c24d2bda5a1271bed36)

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

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

Post 3.13.7

[3.13] gh-109975: Indicate the minimum version for PyREPL in the tutorial (GH-136046) (#137767)

Co-authored-by: Konstantin Morenko <konstantin-morenko@users.noreply.github.com>

Python 3.13.7

[3.13] gh-131788: make resource_tracker re-entrant safe (GH-131787) (#137738)

gh-131788: make resource_tracker re-entrant safe (GH-131787)
(cherry picked from commit f24a012350f71141648cbd61081a25a458dd7fff)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

[3.13] gh-87281: Improve documentation for locale.setlocale() and locale.getlocale() (GH-137313) (GH-137723)

Add a section explaining the locale name formats.
(cherry picked from commit 15ab45775cb01e4baab6af6016347a6f95124e23)

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

[3.13] gh-137668: Document that ord() supports also bytes and bytearray (GH-137669) (GH-137704)

(cherry picked from commit 35759fe2faf1443455dfcb15ef7c435e34b492c7)

[3.13] gh-133403: Run `mypy` on `Tools/build/mypy.ini` changes (GH-137692) (#137699)

(cherry picked from commit e93dca72232efe6d5cf2d52ea6dd3967ff61360b)

[3.13] gh-133403: Check `generate_stdlib_module_names` and `check_extension_modules` with mypy (GH-137546) (#137691)

(cherry picked from commit 68a61b0f1d5661180fd432ff9b8ab21272468a87)

[3.13] gh-137242: Add Android CI job (GH-137186) (#137684)

(cherry picked from commit f660ec37531b5e368a27ba065f73d31ff6fb6680)

Co-authored-by: Malcolm Smith <smith@chaquo.com>
Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

[3.13] gh-136672: Docs: Move Enum functions and add examples (GH-136791) (#137689)

Co-authored-by: RafaelWO <38643099+RafaelWO@users.noreply.github.com>
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

[3.13] Update pre-commit hooks (GH-137591) (GH-137641)

(cherry picked from commit b36d23f58e8ab85b8576ab59c2ce72572c2cb12a)

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

[3.13] gh-126008: Improve docstrings for Tkinter cget and configure methods (GH-133303) (GH-137661)

* Explain the behavior of Widget.configure() depending on arguments.
* Unify descriptions.
* Replace "resource" with "option".
(cherry picked from commit 027cacb67ce1b16a96a6a2866299803eff16a4a6)

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

[3.13] gh-137583: Only lock the SSL context, not the SSL socket (GH-137588) (GH-137613)

Fixes a deadlock introduced in 3.13.6.

(cherry picked from commit 55788a90967e82a9ea05b45c06a293b46ec53d72)

[3.13] gh-131885: Use positional-only markers for ``max()`` and ``min()`` (GH-131868) (#137657)

Co-authored-by: Evan Kohilas <ekohilas@users.noreply.github.com>

[3.13] gh-125897: Mark range function parameters as positional only (GH-125945) (#137653)

Co-authored-by: Konstantin Baikov <konstantin.baikov@gmail.com>

[3.13] gh-137400: Fix a crash when disabling profiling across all threads (gh-137471) (gh-137649)

The `PyEval_SetProfileAllThreads` function and other related functions
had a race condition on `tstate->c_profilefunc` that could lead to a
crash when disable profiling or tracing on all threads while another
thread is starting to profile or trace a a call.

There are still potential crashes when threads exit concurrently with
profiling or tracing be enabled/disabled across all threads.
(cherry picked from commit 362692852f13cdd1d33cc7ed35c0cbac7af1a785)

[3.13] Add test for opening an SQLite with bytes path (GH-136331) (GH-137633)

Add test for opening an SQLite with bytes path (GH-136331)
(cherry picked from commit 1bde13b0e99592fbfce3538b27ada29ea09840a6)

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

[3.13] Fix documentation of hash in PyHash_FuncDef (GH-137595) (#137643)

Fix documentation of hash in PyHash_FuncDef (GH-137595)

Because of a small typo, it wasn't showing up in the generated docs.
(cherry picked from commit 70218b40082396d68c277667fc9bb7f87d095e3c)

Co-authored-by: da-woods <dw-git@d-woods.co.uk>

[3.13] gh-136914: Fix support of cached functions and properties in DocTest's lineno computation (GH-136930) (GH-137615)

Previously, DocTest's lineno of functions and methods decorated with
functools.cache(), functools.lru_cache() and functools.cached_property()
was not properly returned (None was returned) because the
computation relied on inspect.isfunction() which does not consider the
decorated result as a function.

We now use the more generic inspect.isroutine(), as elsewhere
in doctest's logic.

Also, added a special case for functools.cached_property().
(cherry picked from commit fece15d29f28e89f1231afa80508c80ed28dc37d)

Co-authored-by: Denis Laxalde <denis@laxalde.org>

[3.13] gh-137499: Fixed dead link to NIST website (GH-137500) (#137501)

Co-authored-by: tobiasjcat <70606111+tobiasjcat@users.noreply.github.com>
Co-authored-by: Senthil Kumaran <senthil@python.org>

[3.13] gh-137026: Add an explainer guide for asyncio (GH-137215) (#137582)

gh-137026: Add an explainer guide for asyncio (GH-137215)

* - Add an explainer guide (aka HOWTO, not how-to) for asyncio.

* Fix linter errors.

* - Enforce max line length of roughly 79 chars.
- Start sentences on new lines to minimize disruption of diffs.

* Add reference to subinterpreters.

* - Significantly reduce article size. Remove both example sections & "Which concurrency do I want" section.

* Align section-header lengths with section names.

* - Remove reference to deleted section.

* - Fix a variety of rote style guide items like title-alignment, use of ie and $, and so forth.
- Add links to other parts of the docs for keywords and objects like await, coro, task, future, etc.

* - One last title alignment.

* - Style nit.

* - Rework a variety of I statements.

* Lint fix.

* - Firm up commentary on yield from in corotuines.

* Update language comparing await and yield from.

* - Remove await-ing Tasks and futures section

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* - Address comments related to style & writing flow.

* per-thread event loop note.

* Add section describing coroutines roots in generators.

* Phrasing tweak.

* Use asyncio.create_task instead of asyncio.Task

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* small phrasing.

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* phrasing nit.

* style nits

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* phrasing nit

* Fix misnaming of async generator.

* phrasing nits.

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* consistent spacing

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* phrasing nits

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* add conclusion

* nits

* - Variety of style & grammar improvements thanks to ZeroIntensity's comments.

* - Make all directives start with a 3 space indent. Then 4 thereafter.

* - Use :linenos: instead of manually writing the line numbers.

* - Fix label typo for article.

* fix label link.

* Apply suggestions from code review

* - introduce async-sleep name

* Phrasing

* nit

* ungendered octopus

* teammates

* jobs

* rework fella to penguin

* - remove byline; add seealso

* Change ref from asyncio to use seealso block.

* Remove typehints. Fix indentation in one code example.

* Slight rephrase for clarity.

* Make references point to asyncio. Wrap some long lines.

* - Variety of style/phrasing improvements based on PR feedback.

* phrasing.

* phrasing nit.

* Apply suggestions from code review

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* nit

* Apply suggestions from code review

* fix backticks.

* nits

* nit

* add section on asyncio.run

* title change under the hood.

* modify task coro example.

* howtos article link.

* prefer await without backticks.

* phrasing tweak.

* Rework phrasing around how await tasks pauses and returns control in the await section.

* move code block to beforfe explanation in coroutine under the hood.

* phrasing.

* link to yield from.

* style nits

* nit

* - Modify language re: event-loop cycling endlessly.
- Discuss why await was designed to not yield for coros.

* - Add a note about debug=True on asyncio.run to await coro section.

* clarity nit

* - Add two other references in seealso block.

* nit

* Language simplification

* Apply suggestions from code review

* nit

* grammar fix.

* fix

* worker bees

* rework event loop paragraph to significantly deemphasize queues

* remove all references to queue besides the initial analogy.

* add note about garbage collection of tasks

* add practical note re: garbage collection

* phrasing nits

* re arrange note on task gc.

* line wrap nit

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

* link to debug mode docs.

* readd part2 prefix.

* simplify title.

* fix titles. tihnk I messed this up earlier.

* avoid idiom in title.

* fix titles once agian.

* Apply suggestions from code review

* rework task gc example.

* phrasing tweak.

* tewak.

* nit

* nit

* nit

* nit

---------
(cherry picked from commit 3964f974894eff1653913dda437971e0bbfa8ccc)

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>

[3.13] Fix typo in Doc/extending/extending.rst (GH-136890) (#137561)

Co-authored-by: Cornelius Roemer <cornelius.roemer@gmail.com>

[3.13] gh-136155: Docs: check for EPUB fatal errors in CI (GH-134074) (#137538)

Co-authored-by: Maciej Olko <maciej.olko@affirm.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] Replace "ordered arguments" with "positional arguments" in `unittest.mock` documentation (GH-137552) (GH-137554)

Replace "ordered arguments" with "positional arguments" in `unittest.mock` documentation (GH-137552)
(cherry picked from commit 64ee1babfb971ddbc00fd8711cccebfbddf6e4ee)

Co-authored-by: Tom Forbes <tom@tomforb.es>

[3.13] Bump mypy to 1.17.1 (GH-137542) (#137544)

Bump mypy to 1.17.1 (GH-137542)
(cherry picked from commit fb1cb00030c706366dfd1a457dd5de324d5619ea)

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

[3.13] [Doc] Remove unnecessary quotes from typing module (GH-137207) (#137540)

[Doc] Remove unnecessary quotes from typing module (GH-137207)

* gh-106320: Remove private _PyInterpreterState functions (GH-106335)

Remove private _PyThreadState and _PyInterpreterState C API
functions: move them to the internal C API (pycore_pystate.h and
pycore_interp.h). Don't export most of these functions anymore, but
still export functions used by tests.

Remove _PyThreadState_Prealloc() and _PyThreadState_Init() from the C
API, but keep it in the stable API.

* Doc: minor change

* Revert "Doc: minor change"

This reverts commit ebfa0937c2caf0110ab1540f14956d56fe925092.

* [Doc] Remove unnecessary quotes from typing (See Also section)

* [Doc] Remove unnecessary quotes from typing

---------
(cherry picked from commit f06fcb7f4b430993ece308e4e11cba939a676c69)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

[3.13] gh-130102: drop "require numeric arguments" from pow() docs (GH-137456) (#137537)

gh-130102: drop "require numeric arguments" from pow() docs (GH-137456)
(cherry picked from commit 37b5a0d671685645db8f1d5ecfa1260587f1fc28)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Senthil Kumaran <senthil@python.org>

[3.13] gh-137412: fix `default_builtin_hashes` values in `test_hashlib.py` (GH-137413) (#137535)

gh-137412: fix `default_builtin_hashes` values in `test_hashlib.py` (GH-137413)

fix `default_builtin_hashes` in test_hashlib
(cherry picked from commit deb385a14337bc3e38442b4cee3aac4a57364adc)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-137463: Update validate_abstract_methods in test_collections.py (GH-137464) (#137521)

gh-137463: Update `validate_abstract_methods` in `test_collections.py` (#137464)

Update `validate_abstract_methods` in `test_collections.py`

The test for missing abstract methods in `validate_abstract_methods` incorrectly attempted to instantiate the generated class `C` with an argument (`C(name)`), which always raises a `TypeError: C() takes no arguments`. Although the test originally passes, it passes for the wrong reason.

This change makes the test correctly validate the enforcement of abstract methods in ABCs.

(cherry picked from commit 5be872350d562e6c9987b09ff4b7bda80a2f9cd0)

[3.13] gh-137526: Fix broken link to drdobbs journal in difflib.rst (GH-137527) (#137532)

gh-137526: Fix broken link to drdobbs journal in difflib.rst (GH-137527)
(cherry picked from commit 244c7b8c4c579972e7db54132bdd74de3d3b3c0a)

Co-authored-by: Sebastien Williams-Wynn <s.williamswynn.mail@gmail.com>

[3.13] gh-137440: Update comment in Python/hamt.c on importing for testing (GH-137441) (GH-137520)

gh-137440: Update comment in Python/hamt.c on importing for testing (GH-137441)

Switch from `_testcapi` to `_testinternalcapi`.
(cherry picked from commit 7ab68cd50658f76abc9e0f12e6212736e2440720)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>

[3.13] gh-137044: Support large limit values in getrlimit() and setrlimit() (GH-137338) (GH-137507)

* Return large limit values as positive integers instead of negative integers
  in resource.getrlimit().
* Accept large values and reject negative values (except RLIM_INFINITY)
  for limits in resource.setrlimit().
(cherry picked from commit baefaa6cba1d69efd2f930cdc56bca682c54b139)

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