[3.12] gh-118042: Fix error in Telnet.__del__ when __init__() was not called (GH-118274)

[3.12] gh-118207: Rename the COMMON_FIELDS macro in funcobject.h and undef it after use (GH-118208) (#118269)

gh-118207: Rename the COMMON_FIELDS macro in funcobject.h and undef it after use (GH-118208)
(cherry picked from commit 796b3fb28057948ea5b98f7eb0c0f3af6a1e276e)

Co-authored-by: Itamar Oren <itamarost@gmail.com>

[3.12] gh-118221: Always use the default row factory in sqlite3.iterdump() (#118223) (#118270)

sqlite3.iterdump() depends on the row factory returning resulting rows
as tuples; it will fail with custom row factories like for example a
dict factory.

With this commit, we explicitly reset the row factory of the cursor used
by iterdump(), so we always get predictable results. This does not
affect the row factory of the parent connection.

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] GH-117894: prevent aclose()/athrow() being re-used after StopIteration (GH-117851) (GH-118226)

(cherry picked from commit 7d369d471cf2b067c4d795d70b75201c48b46f5b)

[3.12] gh-117968: Make the test for closed file more safe in the C API tests (GH-118230) (GH-118266)

The behavior of fileno() after fclose() is undefined, but it is the only
practical way to check whether the file was closed.
Only test this on the known platforms (Linux, Windows, macOS), where we
already tested that it works.
(cherry picked from commit 546cbcfa0eeeb533950bd49e30423f3d3bbd5ebe)

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

[3.12] gh-85453: Make numeric literals consistent across datetime.rst (GH-118245) (#118248)

Remove code formatting from remaining numeric literals.
(cherry picked from commit 59a4d52973ca73bd739f914e88243a31dbef6b32)

Co-authored-by: edson duarte <eduarte.uatach@gmail.com>

[3.12] gh-85453: Adapt datetime.rst to devguide recommendations for code snippets and variables (GH-118068) (#118244)

Also remove formatting from numeric literals.

(cherry picked from commit 809aa9a682fc865f7502e7421da0a74d204aab6d)

Co-authored-by: edson duarte <eduarte.uatach@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.12] gh-118013: Use weakrefs for the cache key in `inspect._shadowed_dict` (GH-118202) (#118232)

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

[3.12] gh-113171: gh-65056: Fix "private" (non-global) IP address ranges (GH-113179) (GH-113186) (GH-118177)

* GH-113171: Fix "private" (non-global) IP address ranges (GH-113179)

The _private_networks variables, used by various is_private
implementations, were missing some ranges and at the same time had
overly strict ranges (where there are more specific ranges considered
globally reachable by the IANA registries).

This patch updates the ranges with what was missing or otherwise
incorrect.

100.64.0.0/10 is left alone, for now, as it's been made special in [1].

The _address_exclude_many() call returns 8 networks for IPv4, 121
networks for IPv6.

[1] https://github.com/python/cpython/issues/61602

* GH-65056: Improve the IP address' is_global/is_private documentation (GH-113186)

It wasn't clear what the semantics of is_global/is_private are and, when
one gets to the bottom of it, it's not quite so simple (hence the
exceptions listed).

(cherry picked from commit 2a4cbf17af19a01d942f9579342f77c39fbd23c4)
(cherry picked from commit 40d75c2b7f5c67e254d0a025e0f2e2c7ada7f69f)

---------

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

[3.12] bpo-40944: Fix IndexError when parse emails with truncated Message-ID, address, routes, etc (GH-20790) (GH-117974)

(cherry picked from commit 1aa8bbe62f27b564cf15e2aad591c62744354a4e)

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

[3.12] Fix typo in py_compile.rst (GH-118102) (GH-118191)

(cherry picked from commit 0d221e9a1952949465df4e737e8d3189bdd9632a)

Co-authored-by: Animesh Kumar <animesh0721@gmail.com>

[3.12] gh-118168: Fix Unpack interaction with builtin aliases (GH-118169) (#118178)

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

[3.12] gh-59215: unittest: restore _top_level_dir at end of discovery (GH-15242) (GH-117508)

* gh-59215: unittest: restore _top_level_dir at end of discovery (GH-15242)
(cherry picked from commit fc5f68e58ecfbc8c452e1c2f33a2a53d3f2d7ea2)

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

[3.12] gh-116741: Upgrade libexpat to 2.6.2 (GH-117296) (GH-118166)

gh-116741: Upgrade libexpat to 2.6.2 (GH-117296)

Upgrade libexpat to 2.6.2
(cherry picked from commit c9829eec0883a8991ea4d319d965e123a3cf6c20)

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

[3.12] gh-117968: Add tests for the part of the PyRun family of the C API (GH-117982) (GH-118011)

(cherry picked from commit 6078f2033ea15a16cf52fe8d644a95a3be72d2e3)

Co-authored-by: NGRsoftlab <78017794+NGRsoftlab@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

[3.12] gh-118030: Group definitions for `ParamSpecArgs` and `ParamSpecKwargs` in `typing.rst` (GH-118154) (#118155)

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

[3.12] gh-118148: Improve tests for shutil.make_archive() (GH-118149) (GH-118151)

(cherry picked from commit 287d939ed4445089e8312ab44110cbb6b6306a5c)

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

[3.12] gh-115986 Improve pprint documentation accuracy (GH-117403) (#118146)

(cherry picked from commit ceb6038b053c403bed3ca3a8bd17b7e3fc9aab7d)

Co-authored-by: Kerim Kabirov <the.privat33r+gh@pm.me>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] gh-117995: Don't raise DeprecationWarnings for indexed nameless params (GH-118001) (#118142)

Filter out '?NNN' placeholders when looking for named params.

(cherry picked from commit 550483b7e6c54b2a25d4db0c4ca41bd9c1132f93)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: AN Long <aisk@users.noreply.github.com>

[3.12] Docs: replace Harry Potter reference with Monty Python (GH-118130) (#118135)

Docs: replace Harry Potter reference with Monty Python (GH-118130)
(cherry picked from commit 1446024124fb98c3051199760380685f8a2fd127)

Co-authored-by: Clément Robert <cr52@protonmail.com>

[3.12] gh-118121: Fix `test_doctest.test_look_in_unwrapped` (#118122) (#118129)

[3.12] Clarifying nonlocal doc: SyntaxError is raised if nearest enclosing scope is global (GH-114009) (#118128)

Clarifying nonlocal doc: SyntaxError is raised if nearest enclosing scope is global (GH-114009)
(cherry picked from commit 1558d993166636f371c1003107ec979db6744f21)

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

[3.12] GH-115874: Fix segfault in FutureIter_dealloc (GH-118114)

GH-115874: Fix segfault in FutureIter_dealloc (GH-117741)
(cherry picked from commit d8f350309ded3130c43f0d2809dcb8ec13112320)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>

[3.12] gh-118100: Improve links in `ast.rst` (GH-118101) (#118110)

gh-118100: Improve links in `ast.rst` (GH-118101)
(cherry picked from commit 2aa11cca115add03f39cb6cd7299135ecf4d4d82)

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

[3.12] gh-114053: Fix bad interaction of PEP-695, PEP-563 and ``get_type_hints`` (#118009) (#118104)

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

[3.12] gh-88035: update doc-string of `epoch` in timemodule.c (GH-118076) (GH-118097)

Follow GH-88035, update doc-string of epoch in timemodule.c

The epoch is `January 1st, 1970 on all platforms`, according to
current documentation.
(cherry picked from commit 7c6cc00211772cc2afe0bc5e996b6d28f925d133)

Co-authored-by: lit <litlighilit@foxmail.com>

[3.12] gh-87969: Align docs and docstrings with implementation for ctypes' [w]string_at() (GH-25384) (GH-118046)

gh-87969: Align docs and docstrings with implementation for ctypes' [w]string_at() (GH-25384)

The implementation uses 'ptr' for the name of the first parameter of
ctypes.string_at() and ctypes.wstring_at(). Align docs and docstrings
with the naming used in the implementation.

(cherry picked from commit 81a926bd20a8c66646e51b66ef1cfb309b73ebe7)

Co-authored-by: Shreyan Avigyan <shreyan.avigyan@gmail.com>
Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

[3.12] gh-116935: Document that heap types need to support garbage collection (GH-118021) (GH-118092)

gh-116935: Document that heap types need to support garbage collection (GH-118021)
(cherry picked from commit 5d544365742a117027747306e2d4473f3b73d921)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>

[3.12] gh-117518: Clarify PyTuple_GetItem() borrowed reference in the doc (GH-117920) (#118087)

gh-117518: Clarify PyTuple_GetItem() borrowed reference in the doc (GH-117920)
(cherry picked from commit 4605a197bd84da1a232bd835d8e8e654f2fef220)

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

[3.12] gh-64588: Clarify the difference between mu and xbar in statistics docs (GH-117333) (#118080)

gh-64588: Clarify the difference between mu and xbar in statistics docs (GH-117333)

Thanks Davin Potts for the clarification idea.
(cherry picked from commit fefd5d97111364afa027ae580c3244f427dda59d)

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>

[3.12] gh-117535: Ignore made up file name "sys" for warnings (#118014)

[3.12] Use "Contributed by" in a couple of occurrences of 3.12 whatsnew (GH-118070) (#118078)

Use "Contributed by" in a couple of occurrences of 3.12 whatsnew (GH-118070)
(cherry picked from commit 398abdd6fa5b6b15c0570c75321cd7df9573a5b7)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>

[3.12] gh-117503: Fix test for posixpath.expanduser() when pw_dir ends with / (GH-118056) (GH-118058)

(cherry picked from commit ccdcd1d95a9d6eda4df86811c4539f204beef817)

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

[3.12] gh-116932: Remove redundant NEWS entry (GH-118040) (#118041)

Co-authored-by: lyc8503 <me@lyc8503.site>

[3.12] Doc: Render version/language selector on Read the Docs (GH-116966) (#118038)

Co-authored-by: Manuel Kaufmann <humitos@gmail.com>

[3.12] gh-116932: Add note on how to report python documentation theme bugs (GH-117989) (GH-118031)

gh-116932: Add note on how to report python documentation theme bugs (GH-117989)
(cherry picked from commit 468b9aeb922470c26275ce7dda1e6d570a3323f3)

Co-authored-by: lyc8503 <me@lyc8503.site>

[3.12] gh-117613: Argument Clinic: ensure that defining class params are positional-only (#117939)

[3.12] gh-115009: Update Windows installer to use SQLite 3.45.3 (GH-117445) (#118008)

(cherry picked from commit de0dc68b8263da4e3e69d517f303b9b08b36f142)

[3.12] gh-114539: Clarify implicit launching of shells by subprocess (GH-117996) (#118002)

gh-114539: Clarify implicit launching of shells by subprocess (GH-117996)
(cherry picked from commit a4b44d39cd6941cc03590fee7538776728bdfd0a)

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

[3.12] gh-80361: Fix TypeError in email.Message.get_payload() (GH-117994) (GH-117998)

It was raised when the charset is rfc2231 encoded, e.g.:

   Content-Type: text/plain; charset*=ansi-x3.4-1968''utf-8
(cherry picked from commit deaecb88fa5da68cbffca413c63af95fd99578dd)

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

[3.12] gh-117977: Amend version changed annotation for os.chmod, os.chown, and os.listdir (GH-117978) (#117992)

(cherry picked from commit fccedbda9316d52d93b2db855c07f947fab26ae2)

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

[3.12] gh-117975: Ensure flush level is checked when configuring a logging MemoryHandler. (GH-117976) (GH-117986)

(cherry picked from commit 6d0bb43232dd6ebc5245daa4fe29f07f815f0bad)

[3.12] gh-115009: Update macOS installer to use SQLite 3.45.3 (GH-117443) (#117981)

(cherry picked from commit b9b3c455f0293be67a762f653bd22f864d15fe3c)

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>

[3.12] gh-71966: Move the module docstring from _pydecimal to decimal (GH-117919) (GH-117962)

Now it is set even if the C implementation is used.

Also add a one-line synopsis.
(cherry picked from commit c69968ff69b59b27d43708379e4399f424f92075)

[3.12] gh-117313: Fix re-folding email messages containing non-standard line separators (GH-117369) (GH-117971)

Only treat '\n', '\r' and '\r\n' as line separators in re-folding the email
messages.  Preserve control characters '\v', '\f', '\x1c', '\x1d' and '\x1e'
and Unicode line separators '\x85', '\u2028' and '\u2029' as is.
(cherry picked from commit aec1dac4efe36a7db51f08385ddcce978814dbe3)

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

[3.12] gh-117503: Fix support of non-ASCII user names in posixpath.expanduser() (GH-117504) (GH-117970)

They are now supported in bytes paths as well as in string paths.
(cherry picked from commit 51132da0c4dac13500d9bb86b2fdad42091d3fd9)

[3.12] gh-73231: Update documentation for PyErr_SetFromWindowsErr() (GH-117226) (GH-117973)

(cherry picked from commit 438b7c3071eebaccd1ba215f15a239345b22f813)

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

[3.12] gh-117879: Fix test_httpservers for the build with profiling (GH-117932) (GH-117969)

(cherry picked from commit 8429b4565deaef7a86bffc0ce58bc0eab1d7ae48)

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

[3.12] gh-86650: Fix IndexError when parse emails with invalid Message-ID (GH-117934) (GH-117965)

In particularly, one-off addresses generated by Microsoft Outlook:
https://learn.microsoft.com/en-us/office/client-developer/outlook/mapi/one-off-addresses

(cherry picked from commit f74e51229c83e3265f905dc15283bfe0ec1a659e)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: fsc-eriker <72394365+fsc-eriker@users.noreply.github.com>

[3.12] gh-75171: Fix parsing invalid email address headers starting or ending with a dot (GH-15600) (GH-117964)

(cherry picked from commit 8cc9adbfddc8e37cf7d621b12754eecb0584f5da)

Co-authored-by: tsufeki <tsufeki@ymail.com>
Co-authored-by: Tim Bell <timothybell@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-117945: Fix `os.path.ismount()` documentation (GH-117947) (#117952)

gh-117945: Fix `os.path.ismount()` documentation (GH-117947)
(cherry picked from commit a23fa3368e50866f31d6fc1c66a9a5ca2a580239)

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

gh-112844: Fix xz CPE identifier (GH-117656)

(cherry picked from commit d70ee13e575ae4832f2824add64dba77ce5ab7ad)

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

[3.12] Docs: Add classes to C API return value annotations (GH-117926) (#117937)

Docs: Add classes to C API return value annotations (GH-117926)
(cherry picked from commit 3284b84c437e3b0b0a052471e8a6aabc528fc651)

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

[3.12] gh-117691: Add an appropriate stacklevel for PEP-706 tarfile deprecation warnings (GH-117872) (GH-117930)

gh-117691: Add an appropriate stacklevel for PEP-706 tarfile deprecation warnings (GH-117872)
(cherry picked from commit cff0a2db00b6379f60fe273a9782f71773d0a4cb)

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

gh-77102: site: try utf-8 and locale encoding when reading .pth file (GH-117802)

(cherry picked from commit 6dc661bc9f65e9923eafbcdbf18bcc57eebbf6a4)

[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)