gh-131269: Minor optimization in random.py (#131270)

gh-131435: random.randint optimization (gh-131436)

gh-131492, gh-131461: handle exceptions in GzipFile constructor while owning resources (#131462)

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

gh-88887: Cleanup `multiprocessing.resource_tracker.ResourceTracker` upon deletion (#130429)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

gh-131453: Add additional constants to winsound module (GH-131454)

GH-131296: fix clang-cl warnings in sysmodule.c (#131304)

gh-130080: fix warnings in tests (#131471)

GH-127705: Don't call _Py_ForgetReference before _Py_Dealloc (GH-131508)

GH-131498: Remove conditional stack effects (GH-131499)

* Adds some missing #includes

gh-127833: Use `productionlist` nodes to implement the `grammar-snippet` directive (#130376)

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

gh-127989: C API: Refer to "attached thread states" instead of the GIL (GH-127990)

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

GH-130296: Remove `_PyOpcode_max_stack_effect` as it is no longer used (GH-131493)

gh-131238: Remove includes from pycore_interp.h (#131495)

Remove also now unused includes in C files.

gh-111178: Fix function signatures for multiple tests (#131496)

Fix Windows build warnings (#131487)

Fix the following warnings:

* Modules\_io\fileio.c(1296,13): unused variable 'self'
* Modules\_io\winconsoleio.c(334,9): unused variable 'fd_is_own'
* Modules\faulthandler.c(409,11): unused variable 'flags'
* Modules\posixmodule.c(5699,9): unused variable 'pathError'
* PC\winreg.c(2077,5): suggest braces around initialization of
  subobject
* PC\winreg.c(34,13): unused variable 'errNotAHandle'
* Python\fileutils.c(132,12): result of comparison of constant
  1114111 with expression of type 'wchar_t' (aka 'unsigned short') is
  always false
* Python\fileutils.c(58,21): unused variable 'INCOMPLETE_CHARACTER'
* Python\sysmodule.c(2534,21): unused variable 'perf_map_state'

gh-131441: Add a set of asserts to test.test_capi.test_list (#131442)

gh-128421: add critical section around `traceback.tb_next` (#131322)

gh-131401: fix data races in exception handling (#131447)

GH-123599: Deprecate duplicate `pathname2url()` implementation (#127380)

Call `urllib.request.pathname2url()` from `pathlib.Path.as_uri()`, and
deprecate the duplicate implementation in `PurePath`.

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

gh-131238: Cleanup pycore_runtime.h includes (#131486)

gh-131238: Remove pycore_lock.h includes (#131483)

PyMutex type is now part of <Python.h>, it's no longer needed to
include <pycore_lock.h> to get it.

gh-131238: Move pycore_obmalloc.h include to pycore_runtime_structs.h (#131482)

Move pycore_obmalloc.h include from pycore_interp_structs.h to
pycore_runtime_structs.h.

Add also comment explaining the purpose of each include in
pycore_interp_structs.h, pycore_runtime_structs.h and
pycore_structs.h.

Remove <stdbool.h> and <stddef.h> from pycore_structs.h.

gh-131238: Use pycore_interp_structs.h header (#131481)

Replace pycore_runtime_structs.h include with pycore_interp_structs.h
include in internal headers.

gh-129598: ast: allow multi stmts for ast single with ';' (#129620)

gh-131238: Remove more includes from pycore_interp.h (#131480)

GH-123599: Remove duplicate `url2pathname()` implementation (#127237)

Call `urllib.request.url2pathname()` from `pathlib.Path.from_uri()` rather
than re-implementing it. This paves the way for solving the main issue
(ignoring local authorities and rejecting non-local ones) in urllib, not
pathlib.

gh-126835: Move constant tuple folding from ast_opt to CFG (#130769)

GH-131473: Add missing %(AdditionalOptions) reference to pythoncore.vcxproj (GH-131475)

GH-125866: Deprecate `nturl2path` module (#131432)

Deprecate the `nturl2path` module. Its functionality is merged into
`urllib.request`.

Add `tests.test_nturl2path` to exercise `nturl2path`, as it's no longer
covered by `test_urllib`.

GH-130956: Only emit AArch64 trampolines for long jumps (GH-131041)

gh-91349: Replace zlib with zlib-ng in Windows build (GH-131438)

GH-121970: Extract `pydoc_topics` into a new extension (#131256)

gh-131238: Remove many includes from pycore_interp.h (#131472)

gh-131117: Update tp_finalize example to use PyErr_GetRaisedException (#131118)

The tp_finalize C API doc used PyErr_Fetch() and PyErr_Restore() in
its example code. That API was deprecated in 3.12.

Update to point to the suggested replacement function
PyErr_GetRaisedException() which has a sample usage.

gh-130931: Add pycore_interpframe.h internal header (#131249)

Move _PyInterpreterFrame and associated functions
to a new pycore_interpframe.h header.

gh-90548: Make musl test skips smarter (fixes Alpine errors) (#131313)

* Make musl test skips smarter (fixes Alpine errors)

A relatively small number of tests fail when the underlying c library is
provided by musl.  This was originally reported in bpo-46390 by
Christian Heimes.  Among other changes, these tests were marked for
skipping in gh-31947/ef1327e3 as part of bpo-40280 (emscripten support),
but the skips were conditioned on the *platform* being emscripten (or
wasi, skips for which ere added in 9b50585e02).

In gh-131071 Victor Stinner added a linked_to_musl function to enable
skipping a test in test_math that fails under musl, like it does on a
number of other platforms.  This check can successfully detect that
python is running under musl on Alpine, which was the original problem
report in bpo-46390.

This PR replaces Victor's solution with an enhancement to
platform.libc_ver that does the check more cheaply, and also gets the
version number.  The latter is important because the math test being
skipped is due to a bug in musl that has been fixed, but as of this
checkin date has not yet been released.  When it is, the test skip can
be fixed to check for the minimum needed version.

The enhanced version of linked_to_musl is also used to do the skips of
the other tests that generically fail under musl, as opposed to
emscripten or wasi only failures.  This will allow these tests to be
skipped automatically on Alpine.

This PR does *not* enhance libc_ver to support emscripten and wasi, as
I'm not familiar with those platforms; instead it returns a version
triple of (0, 0, 0) for those platforms.  This means the musl tests will
be skipped regardless of musl version, so ideally someone will add
support to libc_ver for these platforms.

* Platform tests and bug fixes.

In adding tests for the new platform code I found a bug in the old code:
if a valid version is passed for version and it is greater than the
version found for an so *and* there is no glibc version, then the
version from the argument was returned.  The code changes here fix
that.

* Add support docs, including for some preexisting is_xxx's.

* Add news item about libc_ver enhancement.

* Prettify platform re expression using re.VERBOSE.

gh-131238: Remove pycore_runtime.h from pycore_pystate.h (#131356)

* Remove includes from pycore_pystate.h:

  * pycore_runtime_structs.h
  * pycore_runtime.h
  * pycore_tstate.h
  * pycore_interp.h

* Reorganize internal headers. Move _gc_thread_state from
  pycore_interp_structs.h to pycore_tstate.h.
* Add 3 new header files to PCbuild/pythoncore.vcxproj.

gh-111178: Fix function signatures in legacy_tracing.c (#131464)

gh-111178: Fix function signatures in _testbuffer.c (#131463)

gh-130587: Add hand-written docs for non-OP tokens (GH-130588)

Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>

gh-130931: Add pycore_typedefs.h internal header (#131396)

Declare _PyInterpreterFrame and _PyRuntimeState types before
declaring their structure members. Break reference cycles between
header files.

Docs: Fix documentation for "PyTypeObject Definition" (GH-130936)

The structure definition for `PyTypeObject` is in `Include/cpython/object.h`,
not in `Include/object.h`.

gh-111178: Fix function signatures for test_types (#131455)

gh-111178: Fix function signatures for test_iter (#131456)

gh-131263: Skip test_timerfd_negative on NetBSD to prevent system freeze (#131431)

gh-130655: Add tests for `gettext.find()` (GH-130691)

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

GH-131358: Add encoding alias cseuckr for euc_kr (#131370)

* Add encoding alias cseuckr for euc_kr

* Update Misc/NEWS.d/next/Library/2025-03-17-21-35-53.gh-issue-131358.YVZ6yo.rst

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

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

gh-131401: fix data race in `_PyErr_Restore` (#131406)

gh-131417: Mention asyncio Future and Task in docs for generic classes list (#131422)

Mention asyncio Future and Task in docs for generic classes list

Docs: fix shell command formatting (#131310)

replace "zypper in" with "zypper install" to avoid incorrect highlighting

gh-121468: Ensure PDB cleans up event loop policies after using asyncio. (#131388)

Adds teardown logic, plus a change to asyncio.run usage, to avoid warnings when
running the test suite single process.

GH-126367: `url2pathname()`: handle NTFS alternate data streams (#131428)

Adjust `url2pathname()` to decode embedded colon characters in Windows
URIs, rather than bailing out with an `OSError`.

gh-124666: Improve thread cleanup in test_android (#131427)

Ensures that failures in test setup don't result in dangling threads.

gh-130914: Make graphlib.TopologicalSorter.prepare() idempotent (#131317)

Closes #130914: Make graphlib.TopologicalSorter.prepare() idempotent

Relax the rules so that `.prepare()` can be called multiple times, provided that no work has been passed out by `.get_ready()` yet.

gh-118915: Document `PY_MONITORING_IS_INSTRUMENTED_EVENT` (GH-128026)

gh-114917: Fix typo in getaddrinfo emulation (#131413)

gh-131402: add HMAC-SHA3 NIST test cases (#131407)

Add NIST [1] tests for `HMAC-SHA-3/{224,256,384,512}`.

[1]: https://csrc.nist.gov/Projects/cryptographic-standards-and-guidelines/example-values

gh-130080: fix warnings in tests (#131400)

gh-131261: expat/refresh.sh: Expand list of manual steps (GH-131359)

gh-121284: Fix email address header folding with parsed encoded-word (GH-122754)

Email generators using email.policy.default may convert an RFC 2047
encoded-word to unencoded form during header refolding. In a structured
header, this could allow 'specials' chars outside a quoted-string,
leading to invalid address headers and enabling spoofing. This change
ensures a parsed encoded-word that contains specials is kept as an
encoded-word while the header is refolded.

[Better fix from @bitdancer.]

---------

Co-authored-by: R David Murray <rdmurray@bitdance.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>

gh-128002: fix tsan race in closing socket in `test_sslproto` (#131399)

gh-131311: Consolidate reference handling in PyCStructUnionType_update_stginfo to fix memory leak (GH-131312)

gh-114917: add support for AI_NUMERICSERV in getaddrinfo emulation (#114918)

gh-128002: fix tsan race in closing socket in `test_ssl` (#131397)

gh-130132: properly free resources in `urrlib.urlopen` examples (#130280)

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

gh-131094: Refine `math.isclose` docs (#131139)

gh-120144: Make it possible to use `sys.monitoring` for bdb and make it default for pdb (#124533)

gh-131002: clarify how to enforce sqlite3 column types for generated fields (#131006)

gh-119786: Fix _PyExecutorObject link at jit.md file (#131382)

gh-130080: implement PEP 765 (#130087)

GH-131278: Add option to build with computed gotos on Windows with clang-cl (GH-131279)

gh-131325: fix sendfile fallback implementation to drain data after writing to transport (#131376)

gh-116738: remove multiprocessing suppressions (#131319)

Fix test_pyrepl.TestDumbTerminal if PYTHON_BASIC_REPL set. (#131332)

Most of the tests that care already adjust PYTHON_BASIC_REPL as needed,
but this one doesn't, and it fails if the developer has the variable set.

GH-127705: Move mortal decrefs to internal header and make sure _PyReftracerTrack is called

GH-125174: Make immortality "sticky" (GH-131355)

* Use a higher threshold for immortality for INCREF than DECREF

gh-131268: Adjust _PYTHREAD_NAME_MAXLEN on BSD (#131345)

Adjust _PYTHREAD_NAME_MAXLEN constant on FreeBSD and NetBSD.
Initial patch by Xavier G.

gh-131281: Add include for pystats builds (#131369)

Add include to for pystats builds

GH-131291: Suppress clang-specific warning in python_uwp.cpp (GH-131292)

gh-116666: Add "token" glossary term (GH-130888)

Add glossary entry for `token`, and link to it.
Avoid talking about tokens in the SyntaxError intro (errors.rst); at this point
tokenization is too much of a technical detail. (Even to an advanced reader,
the fact that a *single* token is highlighted isn't too relevant. Also, we don't
need to guarantee that it's a single token.)

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

gh-126895: Fix readline module in free-threaded build (#131208)

The underlying readline library is not thread-safe so this adds `@critical_section` to functions that use it.

Docs: Fix incorrect sphinx markup for a class member (GH-130970)

gh-111178: fix UBSan failures in `Modules/_ssl.c` (GH-130719)

* fix UBSan failures for `PySSLContext`, `PySSLSocket`, `PySSLMemoryBIO`, `PySSLSession`

GH-131238: More refactoring of core header files (GH-131351)

Adds new pycore_stats.h header file to help break dependencies involving the pycore_code.h header.

gh-131261: Update libexpat to 2.7.0 (CVE-2024-8176) (#131272)

gh-131238: Add explicit includes to pycore headers (#131257)

gh-131238: Convert pycore_pystate.h static inline to functions (#131352)

Convert static inline functions to functions:

* _Py_IsMainThread()
* _PyInterpreterState_Main()
* _Py_IsMainInterpreterFinalizing()
* _Py_GetMainConfig()

gh-129843: fix pure Python implementation of `warnings.warn_explicit` (#129848)

The pure Python implementation of `warnings.warn_explicit` constructs a `WarningMessage`
with an incorrect source (it incorrectly sets the WarningMessage's line to the given `source`).

gh-127667: refactor and improve `_hashopenssl.c` error branches (#131145)

Refactor `_setException()` into different helpers that can be used separately:

- set_ssl_exception_from_errcode(): set an exception from an explicit SSL error code.
- raise_ssl_error(): set an exception from the last SSL error code or use a user-defined message.
- notify_ssl_error_occurred(): same as raise_ssl_error() but with a generic default message.

gh-131316: handle NULL values returned by HACL* functions  (#131324)

- Handle NULL returned by allocation functions.
- Handle NULL returned by copy functions.
- Suppress unused impossible return codes.

gh-130149: cleanup refactorization of `test_hmac.py` (#131318)

New features:

* refactor `hashlib_helper.requires_hashdigest` in prevision of a future
  `hashlib_helper.requires_builtin_hashdigest` for built-in hashes only
* add `hashlib_helper.requires_openssl_hashdigest` to request OpenSSL
   hashes, assuming that `_hashlib` exists.

Refactoring:

* split hmac.copy() test by implementation
* update how algorithms are discovered for RFC test cases
* simplify how OpenSSL hash digests are requested
* refactor hexdigest tests for RFC test vectors
* typo fix: `assert_hmac_hexdigest_by_new` -> `assert_hmac_hexdigest_by_name`

Improvements:

* strengthen contract on `hmac_new_by_name` and `hmac_digest_by_name`
* rename mixin classes to better match their responsibility

gh-93096: Update and document `pickletools` CLI (#131273)

GH-131238: Core header refactor (GH-131250)

* Moves most structs in pycore_ header files into pycore_structs.h and pycore_runtime_structs.h

* Removes many cross-header dependencies

gh-131339: test PyBytes_Size for a zero-size bytes object (#131340)

gh-127146: Update test skips for Emscripten 4.0.2 (#129474)

Updates test skips to reflect capabilities of Emscripten 4.0.2.

gh-119786: add `JUMP_BACKWARD` macro to the Jumps section (#131213)

add JUMP_BACKWARD opcode macro to the Jumps section

JUMP_BACKWARD opcode macro added to the Jumps section in
interpreter.md file at InternalDocs.

gh-131306: Remove unused code related to `BINARY_SUBSCR` (#131307)

gh-131327: Document winsound.SND_APPLICATION (#131328)

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

gh-131254: ensure that `BROWSER` is not set for `test_webbrowser` on macOS (#131276)

gh-131277: allow `EnvironmentVarGuard` to unset more than one environment variable at once (#131280)

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