[3.12] gh-117797: Improve `test_descr.test_not_implemented` (GH-117798) (#117921)

gh-117797: Improve `test_descr.test_not_implemented` (GH-117798)
(cherry picked from commit 1a1e013a4a526546c373afd887f2e25eecc984ad)

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

[3.12] gh-117804: Document how to suppress PGO unprofiled source warnings (GH-117859) (#117912)

(cherry picked from commit 757891ee8ad61a864444c1fdb764d81bc8a11189)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] Docs: add link roles with Sphinx extlinks (GH-117850) (#117910)

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

[3.12] Docs: make the `whatsnew-typing-py312` anchor point to things that were new in the typing module (GH-117904) (#117905)

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

gh-90329: Add _winapi.GetLongPathName and GetShortPathName and use in venv to reduce warnings (GH-117817)

gh-112278: Improve error handling in wmi module and tests (GH-117818)

[3.12] gh-115664: Reorganize versionadded directives for -X options (GH-116304) (GH-117900)

Add the versionadded directives just under the description of the
corresponding option.
(cherry picked from commit 10f1a2687a080f07bc128e185c854586207f08cf)

[3.12] gh-117114: Update os.path function availability and link to genericpath.py in os.path.rst (GH-117756)

[3.12] gh-117889: Fix PGO test in test_peg_generator (GH-117893) (#117895)

Reuse support.check_cflags_pgo() in test_peg_generator to check for
PGO build.

Log PGO_PROF_USE_FLAG in test.pythoninfo.
(cherry picked from commit 64cd6fc9a6a3c3c19091a1c81cbbe8994583017d)

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

[3.12] gh-91565: Replace bugs.python.org links with Devguide/GitHub ones  (GH-91568) (GH-117890)

gh-91565: Replace bugs.python.org links with Devguide/GitHub ones  (GH-91568)

(cherry picked from commit 3de09cadde788065a4f2d45117e789c9353bbd12)

Co-authored-by: Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[3.12] Add 'The Python 2.3 Method Resolution Order' (GH-116435) (#117885)

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

[3.12] gh-117694: Improve tests for PyEval_EvalCodeEx() (GH-117695) (GH-117884)

(cherry picked from commit 57bdb75975ff90f95248c59fda34345f3bfff3c4)

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

[3.12] Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst (GH-117820) (#117877)

(cherry picked from commit e01831760e3c7cb9cdba78b048c8052808a3a663)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] Tweak wording for dataclasses.replace (gh-117758) (#117876)

(cherry picked from commit e7cce2a9c696250aff64a57b85182356367be041)

Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com>

[3.12] gh-115692: Add tests to increase `json` coverage (GH-115693) (#117867)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>

[3.12] dataclasses docs: add some link anchors (GH-117601) (#117863)

dataclasses docs: add some link anchors (GH-117601)
(cherry picked from commit c99d374fc7327ebd47e22c3b1906bc865aad80a1)

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

[3.12] Simpler example of shallow dict export of a dataclass (GH-117812) (#117862)

Simpler example of shallow dict export of a dataclass (GH-117812)
(cherry picked from commit f303651b45649392bf718f970793ad65d9ded0b8)

Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com>

[3.12] gh-117840: Fix indent to fix shlex syntax highlighting (GH-117843) (#117844)

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

[3.12] gh-114466: explicitly define heap invariant (GH-117778) (#117835)

I think the choice of wording in these docs is great and doesn't
need to change. However, it could be useful to explicitly define
this term / the cost of doing so seems relatively low.
(cherry picked from commit 37a4cbd8727fe392dd5c78aea60a7c37fdbad89a)

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

[3.12] gh-117764: Add signatures for functions in the faulthandler module (GH-117771) (GH-117806)

(cherry picked from commit 245e426b55fe6c49140863c352f2a2be11c70fbe)

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

[3.12] Fix version directive indents (GH-117719) (#117810)

[3.12] gh-117752: Autoconf: fix PGO builds for 'make -C build' incantations (GH-117803) (#117805)

(cherry picked from commit 1ddbeae040beb35614f3933f340e0dedcc1e98e4)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] gh-117752: Autoconf: fix -fno-semantic-interposition check (GH-117789) (#117800)

Force the compiler to issue an error if the flag is not supported.
(cherry picked from commit 49fc1414b52b31f6ad0408775d160ec0559c33bb)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] gh-117752: Autoconf: store all LLVM profile data in the build directory (GH-117790) (#117795)

This prevents spurious 'env changed' and llvm-profdata merge errors.

(cherry picked from commit 396b831850f0f364d584db4407a5d633f33e571c)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] gh-117233: Detect support for several hashes at hashlib build time (GH-117234) (#117767)

gh-117233: Detect support for several hashes at hashlib build time (GH-117234)

Detect libcrypto BLAKE2, Shake, SHA3, and Truncated-SHA512 support at hashlib build time

GH-GH- BLAKE2

While OpenSSL supports both "b" and "s" variants of the BLAKE2 hash
function, other cryptographic libraries may lack support for one or both
of the variants. This commit modifies `hashlib`'s C code to detect
whether or not the linked libcrypto supports each BLAKE2 variant, and
elides references to each variant's NID accordingly. In cases where the
underlying libcrypto doesn't fully support BLAKE2, CPython's
`./configure` script can be given the following flag to use CPython's
interned BLAKE2 implementation: `--with-builtin-hashlib-hashes=blake2`.

GH-GH- SHA3, Shake, & truncated SHA512.

Detect BLAKE2, SHA3, Shake, & truncated SHA512 support in the
OpenSSL-ish libcrypto library at build time.  This helps allow hashlib's
`_hashopenssl` to be used with libraries that do not to support every
algorithm that upstream OpenSSL does.  Such as AWS-LC & BoringSSL.

(cherry picked from commit b8eaad30090b46f115dfed23266305b6546fb364)

Co-authored-by: Will Childs-Klein <willck93@gmail.com>
Co-authored-by: Gregory P. Smith [Google LLC] <greg@krypto.org>

[3.12] gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (GH-105406) (#117757)

gh-104269: Document `glob.glob` duplicates when using multiple `**` patterns (GH-105406)
(cherry picked from commit c06be6bbb8d138dde50c0a07cbd64496bee537c5)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>

[3.12] gh-101549: fix documentation of xml.etree.ElementInclude (GH-101550) (#117754)

Co-authored-by: Mikhail B <55960560+mbel0@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>

[3.12] Fix markup of `win32_ver` in `platform.rst` (GH-116492) (#117753)

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

[3.12] gh-115142: Skip `test_capi.test_dict.py` if `_testcapi` is not available (GH-117588) (GH-117718)

(cherry picked from commit dfcae4379f2cc4d352a180f9fef2381570aa9bcb)

[3.12] gh-117711: Only check for 'test/wheeldata' when it's actually used (GH-117712) (#117749)

gh-117711: Only check for 'test/wheeldata' when it's actually used (GH-117712)

It's possible to build Python with option `--with-wheel-pkg-dir`
pointing to a custom wheel directory. Don't include the directory in the test
set if the wheels are used from a different location.

(cherry picked from commit d4963871b03cc76fe7d9648d022d12007585beae)

Co-authored-by: Karolina Surma <33810531+befeleme@users.noreply.github.com>
Co-authored-by: Miro Hrončok <miro@hroncok.cz>

[3.12] gh-117606: Truncate extremely long error message in `test_exceptions` (GH-117670) (#117745)

gh-117606: Truncate extremely long error message in `test_exceptions` (GH-117670)
(cherry picked from commit 02f1385f8ad6bf45376377c41f106b386d3a7eb0)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-112536: Define `_Py_THREAD_SANITIZER` on GCC when TSan is enabled (GH-117702) (#117713)

gh-112536: Define `_Py_THREAD_SANITIZER` on GCC when TSan is enabled (GH-117702)

The `__has_feature(thread_sanitizer)` is a Clang-ism. Although new
versions of GCC implement `__has_feature`, the `defined(__has_feature)`
check still fails on GCC so we don't use that code path.
(cherry picked from commit 79eec66e3dc277ea6ebad8c0b33756eea6a7ab3b)

Co-authored-by: Sam Gross <colesbury@gmail.com>

[3.12] gh-117692: Fix `AttributeError` in `DocTestFinder` on wrapped `builtin_or_method` (GH-117699) (#117708)

* gh-117692: Fix `AttributeError` in `DocTestFinder` on wrapped `builtin_or_method` (GH-117699)
(cherry picked from commit 4bb7d121bc0a3fd00a3c72cd915b5dd8fac5616e)

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

[3.12] gh-117360: Clearer wording in os.path.lexists() docs (GH-117679) (#117701)

(cherry picked from commit 73906d5c908c1e0b73c5436faeff7d93698fc074)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
Co-authored-by: Zachary Ware <zach@python.org>

[3.12] gh-117597: Clarify exception handling in the tutorial (GH-117681) (#117700)

(cherry picked from commit a05068db0cb43337d20a936d919b9d88c35d9818)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>

[3.12] gh-117534: Add checking for input parameter in iso_to_ymd (GH-117543) (#117689)

gh-117534: Add checking for input parameter in iso_to_ymd (GH-117543)

Moves the validation for invalid years in the C implementation of the `datetime` module into a common location between `fromisoformat` and `fromisocalendar`, which improves the error message and fixes a failed assertion when parsing invalid ISO 8601 years using one of the "ISO weeks" formats.

---------

(cherry picked from commit d5f1139c79525b4e7e4e8ad8c3e5fb831bbc3f28)

Co-authored-by: Vlad4896 <166005126+Vlad4896@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>

Post 3.12.3

Python 3.12.3

[3.12] gh-111726: Explicitly close database connections in sqlite3 doctests (GH-111730) (#117630)

(cherry picked from commit a7702663e3f7efc81f0b547f1f13ba64c4e5addc)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] Fix reference in code.rs (#117615) (#117628)

Co-authored-by: Anita Hammer <166057949+anitahammer@users.noreply.github.com>
Fix reference in code.rst (#117615)

[3.12] gh-111726: Remove some doctests from sqlite3 docs (GH-117623) (#117625)

* remove load extension doctest since we cannot skip it conditionally
* remove sys.unraisablehook example; using unraisable hooks is not "an
  improved debug experience"

(cherry picked from commit e338e1a4ec5e43a02447f4ec80320d7fc12b3ed4)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] gh-111726: Cleanup test files after running sqlite3 doctest (GH-117604) (#117622)

Remove all temporary databases in a dedicated 'testcleanup' step
at the end of the file.
(cherry picked from commit a453f5ef9d0b89bd00488d3814c6f0a2886342b8)

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

[3.12] gh-117594: Require cpu resource to test_search_anchor_at_beginning (g… (gh-117616)

gh-117594: Require cpu resource to test_search_anchor_at_beginning (gh-117595)

(cherry picked from commit 784623c63c45a4d13dfb04318c39fdb1ab790218)

[3.12] gh-117074: Update Traversable.joinpath docs to the 3.11+ protocol (GH-117113) (GH-117571)

gh-117074: Update Traversable.joinpath docs to the 3.11+ protocol (GH-117113)
(cherry picked from commit e569f9132b5bdc1c103116a020e19e3ccc20cf34)

Co-authored-by: Petr Viktorin <encukou@gmail.com>

[3.12] gh-109120: Fix syntax error in handlinh of incorrect star expressions… (#117465)

gh-109120: Fix syntax error in handlinh of incorrect star expressions (#117444)

(cherry picked from commit c97d3af2391e62ef456ef2365d48ab9b8cdbe27b)

[3.12] [doc] Update logging documentation to improve grammar and elucidate an example. (GH-117541) (GH-117542)

(cherry picked from commit df912c913a3d94995b379f1e19fe0a79acab6169)

[3.12] gh-117521: Improve typing.TypeGuard docstring (GH-117522) (#117538)

(cherry picked from commit b32789ccb91bbe43e88193f68b1364a8da6d9866)

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

[3.12] gh-117467: Add preserving of mailbox owner on flush (GH-117510) (GH-117537)

(cherry picked from commit 3f5bcc86d0764b691087e8412941e947554c93fd)

Co-authored-by: Tony Mountifield <tony@mountifield.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-117267: Ensure DirEntry.stat().st_ctime still contains creation time during deprecation period (GH-117354)

(cherry picked from commit 985917dc8d34e2d2f717f7a981580a8dcf18d53a)

Co-authored-by: Steve Dower <steve.dower@python.org>

[3.12] gh-117166: Ignore empty and temporary dirs in `test_makefile` (GH-117190) (GH-117367)

gh-117166: Ignore empty and temporary dirs in `test_makefile` (GH-117190)
(cherry picked from commit d9cfe7e565a6e2dc15747a904736264e31a10be4)

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

[3.12] gh-91565: Update issue tracker URL in error message. (GH-117450) (#117497)

gh-91565: Update issue tracker URL in error message. (GH-117450)

* Update issue tracker URL in commit message.

* Also update issue tracker URL in comment.
(cherry picked from commit 8987a5c809343ae0dd2b8e607bf2c32a87773127)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[3.12] gh-115538: Use pathlib to compare prefixes in test_venv (GH-117076)

gh-115538: Use pathlib to compare prefixes in test_venv (GH-117076)
(cherry picked from commit 52f5b7f9e05fc4a25e385c046e0b091641674556)

Co-authored-by: AN Long <aisk@users.noreply.github.com>

[3.12] Link to the Python type system specification (GH-117400) (#117448)

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

[3.12] Docs: specify XML document name in xml.etree.elementtree example (GH-24223) (#117429)

(cherry picked from commit 9dae05ee59eeba0e67af2a46f2a2907c9f8d7e4a)

Co-authored-by: Moshe Kaplan <mosheekaplan@gmail.com>

[3.12] Docs: add more links to PIPE in subprocess docs (GH-25416) (#117427)

(cherry picked from commit fc2071687b708598264a3403b7f9104667c1092f)

Co-authored-by: Matthew Davis <7035647+mdavis-xyz@users.noreply.github.com>

[3.12] build(deps): bump actions/add-to-project from 0.6.0 to 1.0.0 (GH-117415) (#117420)

build(deps): bump actions/add-to-project from 0.6.0 to 1.0.0 (GH-117415)
(cherry picked from commit 3bb12e407c183946471272f8aee098e54e62a333)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[3.12] gh-102190: Add additional zipfile `pwd=` arg docstrings (gh-102195) (GH-117408)

gh-102190: Add additional zipfile `pwd=` arg docstrings (gh-102195)

This just documents the parameter that already exists.

---------

(cherry picked from commit a32d6939486d7f90ee57e215077f6116e19de24d)

Co-authored-by: Deborah <32307299+dlwrnc@users.noreply.github.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

[3.12] gh-117387 Remove hash mark from introductory text (GH-117409) (#gh-

[3.12] gh-117347: Fix test_clinic side effects (#117363) (#117365)

gh-117347: Fix test_clinic side effects (#117363)

Save/restore converters in ClinicWholeFileTest and
ClinicExternalTest.

(cherry picked from commit 35b6c4a4da201a947b2ceb96ae4c0d83d4d2df4f)

[3.12] Fix reversed assertRegex checks in test_ssl. (GH-117351) (#117359)

Fix reversed assertRegex checks in test_ssl. (GH-117351)
(cherry picked from commit 2e9be80c99f635c2f7761e8356b0260922d6e7a6)

Co-authored-by: Gregory P. Smith <greg@krypto.org>

[3.12] gh-117110: Fix subclasses of typing.Any with custom constructors (GH-117111) (#117357)

gh-117110: Fix subclasses of typing.Any with custom constructors (GH-117111)
(cherry picked from commit 8eec7ed714e65d616573b7331780b0aa43c6ed6a)

Co-authored-by: 傅立业（Chris Fu） <17433201@qq.com>

[3.12] gh-117339: Use NULL instead of None for LOAD_SUPER_ATTR in dis docs (GH-117343) (GH-117345)

[3.12] gh-114331: Skip decimal test_maxcontext_exact_arith on s390x (GH-117326) (#117327)

gh-114331: Skip decimal test_maxcontext_exact_arith on s390x (GH-117326)
(cherry picked from commit 6702d2bf6edcd5b5415e17837383623b9d76a5b8)

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

[3.12] gh-117310: Remove extra DECREF on "no ciphers" error path in `_ssl._SSLContext` constructor (GH-117309) (GH-117317)

gh-117310: Remove extra DECREF on "no ciphers" error path in `_ssl._SSLContext` constructor (GH-117309)

Remove extra self DECREF on ssl "no ciphers" error path.

This doesn't come up in practice because nobody links against a broken
OpenSSL library that provides nothing.
(cherry picked from commit 8cb7d7ff86a1a2d41195f01ba4f218941dd7308c)

Co-authored-by: Gregory P. Smith <greg@krypto.org>

[3.12] gh-117178: Recover lazy loading of self-referential modules (GH-117179) (#117319)

Co-authored-by: Chris Markiewicz <effigies@gmail.com>

[3.12] gh-99108: Update and check HACL* version information (GH-117295) (GH-117302)

gh-99108: Update and check HACL* version information (GH-117295)

(cherry picked from commit 669ef49c7d42f35da6f7ee280102353b9b37f83e)

Co-authored-by: Seth Michael Larson <seth@python.org>

[3.12] gh-104242: Enable test_is_char_device_true in pathlib test on all platform (GH-116983) (GH-117277)

(cherry picked from commit af1b0e94400d1bf732466d675054df8cf7dfb62d)

[3.12] Change links on the index page (GH-117230) (#117268)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>

[3.12] gh-115538: Use isolate mode when running venv test_multiproces… (#117264)

[3.12] gh-115538: Use isolate mode when running venv test_multiprocessing_recursion() (GH-117116)
(cherry picked from commit 4ec347760f98b156c6a2d42ca397af6b0b6ecc50)

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

[3.12] pre-commit: add `check-case-conflict` and `check-merge-conflict` (GH-117259) (#117260)

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

[3.12] gh-66543: Fix mimetype.guess_type() (GH-117217) (GH-117256)

Fix parsing of the following corner cases:

* URLs with only a host name
* URLs containing a fragment
* URLs containing a query
* filenames with only a UNC sharepoint on Windows

(cherry picked from commit 9654daf793b534b44a831c80f43505ab9e380f1f)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>

[3.12] gh-83845: Add tests for operator module (GH-115883) (#117253)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Karthikeyan Singaravelan <tir.karthi@gmail.com>

[3.12] gh-83434: Sync libregrtest and test_regrtest with the main branch (#117250)

* gh-115122: Add --bisect option to regrtest (#115123)

* test.bisect_cmd now exit with code 0 on success, and code 1 on
  failure. Before, it was the opposite.
* test.bisect_cmd now runs the test worker process with
  -X faulthandler.
* regrtest RunTests: Add create_python_cmd() and bisect_cmd()
  methods.

(cherry picked from commit 1e5719a663d5b1703ad588dda4fccd763c7d3e99)

* gh-115720: Show number of leaks in huntrleaks progress reports (GH-115726)

Instead of showing a dot for each iteration, show:
- '.' for zero (on negative) leaks
- number of leaks for 1-9
- 'X' if there are more leaks

This allows more rapid iteration: when bisecting, I don't need
to wait for the final report to see if the test still leaks.

Also, show the full result if there are any non-zero entries.
This shows negative entries, for the unfortunate cases where
a reference is created and cleaned up in different runs.

Test *failure* is still determined by the existing heuristic.

(cherry picked from commit af5f9d682c20c951b90e3c020eeccac386c9bbb0)

* gh-83434: Disable XML in regrtest when -R option is used (#117232)

(cherry picked from commit d52bdfb19fadd7614a0e5abaf68525fc7300e841)

---------

Co-authored-by: Petr Viktorin <encukou@gmail.com>

[3.12] gh-117187: Fix XML tests for vanilla Expat <2.6.0 (GH-117203) (GH-117244)

gh-117187: Fix XML tests for vanilla Expat <2.6.0 (GH-117203)

This fixes XML unittest fallout from the https://github.com/python/cpython/issues/115398 security fix.  When configured using `--with-system-expat` on systems with older pre 2.6.0 versions of libexpat, our unittests were failing.

* sax|etree: Simplify Expat version guard where simplifiable

Idea by Matěj Cepl

* sax|etree: Fix reparse deferral tests for vanilla Expat <2.6.0

This *does not fix* the case of distros with an older version of libexpat with the 2.6.0 feature backported as a security fix.  (Ubuntu is a known example of this with its libexpat1 2.5.0-2ubunutu0.1 package)
(cherry picked from commit 9f74e86c78853c101a23e938f8e32ea838d8f62e)

Co-authored-by: Sebastian Pipping <sebastian@pipping.org>

[3.12] gh-99108: Refresh HACL*; update modules accordingly; fix namespacing (GH-117237) (GH-117243)

Pulls in a new update from https://github.com/hacl-star/hacl-star and fixes our C "namespacing" done by `Modules/_hacl/refresh.sh`.

Co-authored-by: Jonathan Protzenko <protz@microsoft.com>

[3.12] Sync main docs and docstring for median_grouped(). (gh-117214) (gh-117241)

[3.12] Add information about negative  indexes to sequence datamodel doc (GH-110903) (#117238)

Co-authored by Terry Jan Reedy
(cherry picked from commit c2276176d543a2fc2d57709c2787f99850fbb073)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>

[3.12] Minor markup and grammar fixes in the statistics docs (gh-117216) (gh-117218)

[3.12] gh-91227: Ignore ERROR_PORT_UNREACHABLE in proactor recvfrom() (GH-32011) (GH-117209)

(cherry picked from commit f11d0d8be8af28e1368c3c7c116218cf65ddf93e)

Co-authored-by: Erik Soma <stillusingirc@gmail.com>

[3.12] GH-115986 Docs: promote pprint.pp usage as a default (GH-116614) (#117196)

Co-authored-by: Kerim Kabirov <the.privat33r+gh@pm.me>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] gh-101760: Improve the imaplib.IMAP4 example (GH-101764) (#117191)

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

[3.12] docs:fix over-linking in dataclasses.rst (GH-117005) (#117163)

* docs: fix over-linking in dataclasses.rst (#117005)

(cherry picked from commit 0907871d43bffb613cbd560224e1a9db13d06c06)

* [3.12] docs: fix over-linking in dataclasses.rst (GH-117005)
(cherry picked from commit 0907871d43bffb613cbd560224e1a9db13d06c06)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
---------

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

[3.12] gh-117084: Fix ZIP file extraction for directory entry names with backslashes on Windows (GH-117129) (GH-117162)

(cherry picked from commit 567ab3bd15398c8c7b791f3e376ae3e3c0bbe079)

[3.12] [docs] Fix typo in docstring and add example to logging cookbook. (GH-117157) (GH-117159)

(cherry picked from commit 00baaa21de229a6db80ff2b84c2fd6ad1999a24c)

Fix get_packagefamilyname helper function on Windows 32-bit (GH-117153)

(cherry picked from commit 3be9b9d8722696b95555937bb211dc4cda714d56)

Co-authored-by: Steve Dower <steve.dower@python.org>

[3.12] gh-117127: glob tests: Reopen dir_fd to pick up directory changes (GH-117128) (GH-117150)

gh-117127: glob tests: Reopen dir_fd to pick up directory changes (GH-117128)
(cherry picked from commit 42ae924d278c48a719fb0ab86357f3235a9f7ab9)

Co-authored-by: Petr Viktorin <encukou@gmail.com>

[3.12] gh-75988: Fix issues with autospec ignoring wrapped object (GH-115223) (#117119)

gh-75988: Fix issues with autospec ignoring wrapped object (#115223)

* set default return value of functional types as _mock_return_value

* added test of wrapping child attributes

* added backward compatibility with explicit return

* added docs on the order of precedence

* added test to check default return_value

(cherry picked from commit 735fc2cbbcf875c359021b5b2af7f4c29f4cf66d)

[3.12] gh-117061: Fix test_posix.test_sched_setaffinity() on RHEL9 (GH-117126) (#117137)

gh-117061: Fix test_posix.test_sched_setaffinity() on RHEL9 (GH-117126)

On RHEL9, sched_setaffinity(0, []) does not fail.
(cherry picked from commit 50f9b0b1e0fb181875751cef951351ed007b6397)

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

[3.12] gh-116333: Relax error string text expectations in SSL-related tests (GH-116334) (GH-117136)

gh-116333: Relax error string text expectations in SSL-related tests (GH-116334)

* Relax error string text expectations in SSL-related tests

As suggested [here][1], this change relaxes the OpenSSL error string
text expectations in a number of tests. This was specifically done in
support of more easily building CPython [AWS-LC][2], but because AWS-LC
is a fork of [BoringSSL][3], it should increase compatibility with that
library as well.

In addition to the error string relaxations, we also add some guards
around the `tls-unique` channel binding being used with TLSv1.3, as that
feature (described in [RFC 6929][4]) is [not defined][5] for TLSv1.3.

[1]: https://discuss.python.org/t/support-building-ssl-and-hashlib-modules-against-aws-lc/44505/4
[2]: https://github.com/aws/aws-lc
[3]: https://github.com/google/boringssl
[4]: https://datatracker.ietf.org/doc/html/rfc5929GH-section-3
[5]: https://datatracker.ietf.org/doc/html/rfc8446GH-appendix-C.5
(cherry picked from commit c85d84166a84a5cb2d724012726bad34229ad24e)

Co-authored-by: Will Childs-Klein <willck93@gmail.com>

[3.12] Remove more stray backticks from NEWS files (GH-115374) (#117118)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[3.12] Fix sort order for "locale encoding" glossary item (GH-115794) (#117102)

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

[3.12] gh-116773: Fix overlapped memory corruption crash (GH-116774) (#117078)

Manual backport of gh-116774.

[3.12] gh-117058: Update GUI and packaging recommendations for macOS. (GH-117059) (#117081)

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

[3.12] gh-117021: Fix integer overflow in PyLong_AsPid() on non-Windows 64-bit platforms (GH-117064) (GH-117070)

(cherry picked from commit 519b2ae22b54760475bbf62b9558d453c703f9c6)

[3.12] gh-90300: Remove reference to PYTHON_FROZEN_MODULES in Python CLI help (GH-117035)

Fix error introduced in 4be9fa896117bf07dc944a29c98dd18b71dd6c74.

[3.12] docs: announce venv creation before installing packages (GH-117036) (#117040)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

[3.12] gh-101100: Fix Sphinx warnings in `library/pydoc.rst` (GH-116913) (#117037)

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

[3.12] gh-113964: Don't prevent new threads until all non-daemon threads exit (GH-116677) (#117029)

Starting in Python 3.12, we prevented calling fork() and starting new threads
during interpreter finalization (shutdown). This has led to a number of
regressions and flaky tests. We should not prevent starting new threads
(or `fork()`) until all non-daemon threads exit and finalization starts in
earnest.

This changes the checks to use `_PyInterpreterState_GetFinalizing(interp)`,
which is set immediately before terminating non-daemon threads.

(cherry picked from commit 60e105c1c11ecca1680d03c38aa06bcc77a28714)

[3.12] gh-90300: Improve the Python CLI help output (GH-115853) (GH-117022)

* document equivalent command-line options for all environment variables
* document equivalent environment variables for all command-line options
* reduce the size of variable and option descriptions to minimum
* remove the ending period in single-sentence descriptions

(cherry picked from commit b85572c47dc7a8c65fc366a87a3660fc7a3ed244)

Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] gh-56374: Clarify documentation of nonlocal (GH-116942) (#117023)

Define 'nonlocal scopes' in a way that excludes class scopes.
Rearrange the rest of the doc.  Add "Programmer's note".

(cherry picked from commit 025ef7a5f7b424fba8713e448244b952bf897df3)
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>