gh-114203: skip locking if object is already locked by two-mutex critical section (#141476)

gh-141488: Add `Py_` prefix to Include/datetime.h macros (#141493)

Add PyManager troubleshooting steps for direct launch of script files (GH-141530)

gh-116146: Avoid empty braces in _testembed.c (GH-141556)

gh-139653: Remove assertions in _Py_InitializeRecursionLimits() (#141551)

These checks were invalid and failed randomly on FreeBSD
and Alpine Linux.

GH-141509: Fix warning about remaining subinterpreters (GH-141528)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

GH-141312: Allow only integers to longrangeiter_setstate state (GH-141317)

This fixes an assertion error when the new computed start is not an integer.

gh-139344: Remove pending removal notice for undeprecated importlib.resources API (GH-141507)

gh-122255: Synchronize warnings in C and Python implementations of the warnings module (GH-122824)

In the linecache module and in the Python implementation of the
warnings module, a DeprecationWarning is issued when
m.__loader__ differs from m.__spec__.loader (like in the C
implementation of the warnings module).

gh-131229: Temporarily skip `test_basic_multiple_interpreters_deleted_no_reset` (GH-141552)

This is a temporary band-aid to unblock other PRs.

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

gh-141004: Document `PyOS_InterruptOccurred` (GH-141526)

gh-141376: Remove exceptions from `make smelly` (GH-141392)

* Don't ignore initialized data and BSS
* Remove exceptions for _init and _fini

gh-131510: Use PyUnstable_Unicode_GET_CACHED_HASH() (GH-141520)

Replace code that directly accesses PyASCIIObject.hash with
PyUnstable_Unicode_GET_CACHED_HASH().

Remove redundant "assert(PyUnicode_Check(op))" from
PyUnstable_Unicode_GET_CACHED_HASH(), _PyASCIIObject_CAST() already
implements the check.

gh-139596: Cease caching config.cache & ccache in GH Actions (#141451)

gh-116146: Add C-API to create module from spec and initfunc (GH-139196)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-140550: Use a bool for the Py_mod_gil value (GH-141519)

This needs a single bit, but was stored as a void* in the module
struct. This didn't matter due to packing, but now that there's
another bool in the struct, we can save a bit of memory by
making md_gil a bool.

Variables that changed type are renamed, to detect conflicts.

gh-140790: pdb: Initialize instance variables in Pdb.__init__ (#140791)

Initialize lineno, stack, curindex, curframe, currentbp, and _user_requested_quit attributes in `Pdb.__init__``.

gh-140601: Add ResourceWarning to iterparse when not closed (GH-140603)

When iterparse() opens a file by filename and is not explicitly closed,
emit a ResourceWarning to alert developers of the resource leak.

Signed-off-by: Osama Abdelkader <osama.abdelkader@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-137969: Fix double evaluation of `ForwardRef`s which rely on globals (#140974)

gh-139109: A new tracing JIT compiler frontend for CPython (GH-140310)

This PR changes the current JIT model from trace projection to trace recording. Benchmarking: better pyperformance (about 1.7% overall) geomean versus current https://raw.githubusercontent.com/facebookexperimental/free-threading-benchmarking/refs/heads/main/results/bm-20251108-3.15.0a1%2B-7e2bc1d-JIT/bm-20251108-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-7e2bc1d-vs-base.svg, 100% faster Richards on the most improved benchmark versus the current JIT. Slowdown of about 10-15% on the worst benchmark versus the current JIT. **Note: the fastest version isn't the one merged, as it relies on fixing bugs in the specializing interpreter, which is left to another PR**. The speedup in the merged version is about 1.1%. https://raw.githubusercontent.com/facebookexperimental/free-threading-benchmarking/refs/heads/main/results/bm-20251112-3.15.0a1%2B-f8a764a-JIT/bm-20251112-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-f8a764a-vs-base.svg

Stats: 50% more uops executed, 30% more traces entered the last time we ran them. It also suggests our trace lengths for a real trace recording JIT are too short, as a lot of trace too long aborts https://github.com/facebookexperimental/free-threading-benchmarking/blob/main/results/bm-20251023-3.15.0a1%2B-eb73378-CLANG%2CJIT/bm-20251023-vultr-x86_64-Fidget%252dSpinner-tracing_jit-3.15.0a1%2B-eb73378-pystats-vs-base.md .

This new JIT frontend is already able to record/execute significantly more instructions than the previous JIT frontend. In this PR, we are now able to record through custom dunders, simple object creation, generators, etc. None of these were done by the old JIT frontend. Some custom dunders uops were discovered to be broken as part of this work gh-140277

The optimizer stack space check is disabled, as it's no longer valid to deal with underflow.

Pros:
* Ignoring the generated tracer code as it's automatically created, this is only additional 1k lines of code. The maintenance burden is handled by the DSL and code generator.
* `optimizer.c` is now significantly simpler, as we don't have to do strange things to recover the bytecode from a trace.
* The new JIT frontend is able to handle a lot more control-flow than the old one.
* Tracing is very low overhead. We use the tail calling interpreter/computed goto interpreter to switch between tracing mode and non-tracing mode. I call this mechanism dual dispatch, as we have two dispatch tables dispatching to each other. Specialization is still enabled while tracing.
* Better handling of polymorphism. We leverage the specializing interpreter for this.

Cons:
* (For now) requires tail calling interpreter or computed gotos. This means no Windows JIT for now :(. Not to fret, tail calling is coming soon to Windows though https://github.com/python/cpython/pull/139962

Design:
* After each instruction, the `record_previous_inst` function/label is executed. This does as the name suggests.
* The tracing interpreter lowers bytecode to uops directly so that it can obtain "fresh" values at the point of lowering.
* The tracing version behaves nearly identical to the normal interpreter, in fact it even has specialization! This allows it to run without much of a slowdown when tracing. The actual cost of tracing is only a function call and writes to memory.
* The tracing interpreter uses the specializing interpreter's deopt to naturally form the side exit chains. This allows it to side exit chain effectively, without repeating much code. We force a re-specializing when tracing a deopt.
* The tracing interpreter can even handle goto errors/exceptions, but I chose to disable them for now as it's not tested.
* Because we do not share interpreter dispatch, there is should be no significant slowdown to the original specializing interpreter on tailcall and computed got with JIT disabled. With JIT enabled, there might be a slowdown in the form of the JIT trying to trace.
* Things that could have dynamic instruction pointer effects are guarded on. The guard deopts to a new instruction --- `_DYNAMIC_EXIT`.

gh-141004: Document `PyErr_RangedSyntaxLocationObject` (#141521)

PyErr_RangedSyntaxLocationObject

gh-140873: Add support of non-descriptor callables in functools.singledispatchmethod() (GH-140884)

gh-139653: Add PyUnstable_ThreadState_SetStackProtection() (#139668)

Add PyUnstable_ThreadState_SetStackProtection() and
PyUnstable_ThreadState_ResetStackProtection() functions
to set the stack base address and stack size of a Python
thread state.

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

gh-141004: Document `PyCode_Optimize` (GH-141378)

gh-141004: Document C APIs for dictionary keys, values, and items (GH-141009)

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

gh-137959: Fix `TIER1_TO_TIER2` macro name in JIT InternalDocs (GH-141496)

JIT InternalDocs fix

gh-139871: Add `bytearray.take_bytes([n])` to efficiently extract `bytes` (GH-140128)

Update `bytearray` to contain a `bytes` and provide a zero-copy path to
"extract" the `bytes`. This allows making several code paths more efficient.

This does not move any codepaths to make use of this new API. The documentation
changes include common code patterns which can be made more efficient with
this API.

---

When just changing `bytearray` to contain `bytes` I ran pyperformance on a
`--with-lto --enable-optimizations --with-static-libpython` build and don't see
any major speedups or slowdowns with this; all seems to be in the noise of
my machine (Generally changes under 5% or benchmarks that don't touch
bytes/bytearray).

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Maurycy Pawłowski-Wieroński <5383+maurycy@users.noreply.github.com>

gh-140601: Refactor ElementTree.iterparse() tests (GH-141499)

Split existing tests on smaller methods and move them to separate class.
Rename variable "content" to "it".
Use BytesIO instead of StringIO.
Add few more tests.

gh-135801: Add the module parameter to compile() etc (GH-139652)

Many functions related to compiling or parsing Python code, such as
compile(), ast.parse(), symtable.symtable(),
and importlib.abc.InspectLoader.source_to_code() now allow to pass
the module name used when filtering syntax warnings.

gh-140260: fix data race in `_struct` module initialization with subinterpreters (#140909)

gh-137109: refactor warning about threads when forking (#141438)

* gh-137109: refactor warning about threads when forking

This splits the OS API specific functionality to get the number of threads out
from the fallback Python method and warning raising code itself.  This way the
OS APIs can be queried before we've run
`os.register_at_fork(after_in_parent=...)` registered functions which
themselves may (re)start threads that would otherwise be detected.

This is best effort.  If the OS APIs are either unavailable or fail, the
warning generating code still falls back to looking at the Python threading
state after the CPython interpreter world has been restarted and the
after_in_parent calls have been made.  The common case for most Linux and macOS
environments should work today.

This also lines up with the existing TODO refactoring, we may choose to expose
this API to get the number of OS threads in the `os` module in the future.

* NEWS entry

* avoid "function-prototype" compiler warning?

gh-141004: Document `PyRun_InteractiveOneObject` (GH-141405)

gh-124111: Fix TCL 9 thread detection (GH-128103)

gh-141442: Add escaping to iOS testbed arguments (#141443)

Xcode concatenates the test argument array, losing quoting in the process.

gh-140936: Fix JIT assertion crash at finalization if some generator is alive (GH-140969)

Add details about JIT build infrastructure and updating dependencies to `Tools/jit` (#141167)

gh-141412: Use reliable target URL for urllib example (GH-141428)

The endpoint used for demonstrating reading URLs is no longer
stable. This change substitutes a target over which we have more
control.

GH-140479: Update JIT builds to use LLVM 21 (#140973)

gh-141004: Document `PyType_SUPPORTS_WEAKREFS` (GH-141408)

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

gh-141004: Document `Py_MATH_{E, PI, TAU}` constants (#141373)

gh-132657: add regression test for `PySet_Contains` with unhashable type (#141411)

gh-87710: Update mime type for ``.ai`` (#141239)

gh-141464: a typo in profiling sampling when can not run warning in linux (#141465)

gh-141004: soft-deprecate Py_INFINITY macro (#141033)

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

gh-98896: resource_tracker: use json&base64 to allow arbitrary shared memory names (GH-138473)

gh-131116: Fix inspect.getdoc() to work with cached_property objects (GH-131165)

gh-141042: fix sNaN's packing for mixed floating-point formats (#141107)

gh-141311: Avoid assertion in BytesIO.readinto() (GH-141333)

Fix error in assertion which causes failure if pos is equal to PY_SSIZE_T_MAX.
Fix undefined behavior in read() and readinto() if pos is larger that the size
of the underlying buffer.

gh-141370: document undefined behavior of Py_ABS() (GH-141439)

gh-85524: Raise "UnsupportedOperation" on FileIO.readall (#141214)

io.UnsupportedOperation is a subclass of OSError and recommended by
io.IOBase for this case; matches other read methods on io.FileIO.

gh-141376: Rename _AsyncioDebug to _Py_AsyncioDebug (GH-141391)

gh-75593: Add support of bytes and path-like paths in wave.open() (GH-140951)

GH-116946: revert eliminate the need for the GC in the `_thread.lock` and `_thread.RLock`  (#141448)

Revert "GH-116946: eliminate the need for the GC in the `_thread.lock` and `_thread.RLock` (#141268)"

This reverts commit fbebca289d811669fc1980e3a135325b8542a846.

gh-103847: fix cancellation safety of `asyncio.create_subprocess_exec` (#140805)

GH-116946: eliminate the need for the GC in the `_thread.lock` and `_thread.RLock` (#141268)

GH-137618: Require Python 3.10 to Python 3.15 for PYTHON_FOR_REGEN (GH-137619)

* Require Python 3.11 to Python 3.15 for PYTHON_FOR_REGEN

* NEWS

* keep allowing python 3.10

---------

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

gh-137928: remove redundant size validation in multiprocessing.heap (GH-137929)

remove redundant size check, malloc does it

---------

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

gh-138621: Increase test coverage for csv.DictReader and csv.Sniffer (GH-138622)

* Increase test coverage for csv.DictReader and csv.Sniffer

Previously there were no tests for the DictReader fieldnames
setter, the case where a StopIteration was encountered when trying
to determine the fieldnames from the content or the case where
Sniffer could not find a delimiter.

* Revert whitespace change to comment

* Add a test that csv.Sniffer.has_header checks up to 20 rows

* Replace name and age with letter and offset

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

---------

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

gh-137952: update `csv.Sniffer().has_header()` docs to describe the actual off-by-onish behavior (GH-137953)

* checks 21, not 20
* Say "header" instead of "first row" to disambiguate per review.

---------

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Maurycy Pawłowski-Wieroński <maurycy@maurycy.com>

gh-138775: fix handle `python -m base64` stdin correct with EOF signal (GH-138776)

* fix: handle  stdin correct with EOF single.
* fix: flollow the comments when pipe stdin use buffer
* Apply suggestions from code review
* fix: apply review comments in Lib/base64.py
* fix: address comments
* Reword comment and NEWS entry.

---------

Signed-off-by: yihong0618 <zouzou0208@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

gh-120950: Fix overflow in math.log() with large int-like argument (GH-121011)

Handling of arbitrary large int-like argument is now consistent with
handling arbitrary large int arguments.

gh-139462: Make the ProcessPoolExecutor BrokenProcessPool exception report which child process terminated (GH-139486)

Report which process terminated as cause of BPE

gh-132686: Add parameters inherit_class_doc and fallback_to_class_doc for inspect.getdoc() (GH-132691)

GH-139596: Cease caching config.cache & ccache in GH Actions (GH-139623)

* Cease caching config.cache in GH Actions\
* Remove ccache action

gh-141314: Fix TextIOWrapper.tell() assertion failure with standalone carriage return (GH-141331)

The assertion was checking wrong variable (skip_back vs skip_bytes).

gh-141004: Document `PyBytes_Repr` and `PyBytes_DecodeEscape` (GH-141407)

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

gh-116738: use `PyMutex` in `lzma` module (#140711)

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

gh-141004: Document `PyFile_OpenCode` and `PyFile_OpenCodeObject` (GH-141413)

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

gh-140476: optimize `PySet_Add` for `frozenset` in free-threading (#140440)

Avoids critical section in `PySet_Add` when adding items to newly created frozensets.

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

gh-137339: Clarify host and port parameter behavior in smtplib.SMTP{_SSL} initialization (#137340)

This also documents the previously undocumented default_port parameter.

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

gh-141367: Use actual SPECIALIZATION_THRESHOLD value in specialization related test (GH-141417)

Add documentation for Python install manager's install_dir, global_dir and download_dir (GH-140223)

gh-139533: fix refs to code without proper markups on turtledemo doc (GH-139534)

gh-139533: fix refs to code without proper markups on turtledemo documentation

gh-140193: Forward port test_exec_set_nomemory_hang from 3.13 (GH-140187)

* chore: test_exec_set_nomemory_hang from 3.13

Signed-off-by: yihong0618 <zouzou0208@gmail.com>
* fix: apply comments

Signed-off-by: yihong0618 <zouzou0208@gmail.com>
* Update Lib/test/test_exceptions.py

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Lib/test/test_exceptions.py

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* fix: windows too long name 60 times is enough

Signed-off-by: yihong0618 <zouzou0208@gmail.com>
---------

Signed-off-by: yihong0618 <zouzou0208@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

gh-141415: Remove unused variables and comment in `_pyrepl.windows_console.py` (#141416)

gh-141004: Document `PyType_Unwatch` (GH-141414)

gh-140942: Add MIME type for .cjs extension (#140937)

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

gh-132657: optimize `PySet_Contains` for `frozenset` (#141183)

gh-141169: Re-raise exception from findfuncptr (GH-141349)

gh-141004: document Py_INFINITY and Py_NAN macros (#141145)

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

gh-141376: Fix exported symbols (GH-141377)

* gh-141376: Fix exported symbols

* _io module: add "_Py_" prefix to "spec" variables. For example,
  rename bufferedrandom_spec to _Py_bufferedrandom_spec.
* typevarobject.c: add "static" to "spec" and "slots" variables.
* import.c: add "static" to "pkgcontext" variable.

* No longer export textiowrapper_slots

gh-140379: add hyperlinks to list and set (GH-140399)

add hyperlinks to list and set

gh-140485: Catch ChildProcessError in multiprocessing resource tracker (GH-141132)

gh-140578: Doc: Remove sencence implying that concurrent.futures.ThreadPoolExecutor does not exist (#140689)

* Doc: Remove sencence implying that concurrent.futures.ThreadPoolExecutor does not exist

Closes #140578

* Add NEWS.d entry for gh-140578

---------

Co-authored-by: Louis Paternault <spalax@gresille.org>

gh-141004: Document missing frame APIs (GH-141189)

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

gh-141004: Document `PyType_FastSubclass` (GH-141313)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

GH-141212: Fix possible memory leak in gc_mark_span_push (gh-141213)

gh-141004: Deprecate Py_MATH_El and Py_MATH_PIl macros (#141035)

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

gh-141174: Improve `annotationlib._Stringifier` test coverage (#141220)

* Test `_Stringifier.__convert_to_ast()` for containers

* Test partial evaluation of `ForwardRef`s in `_Stringifier`

gh-141343: Fix swapped words in `sorted` doc (GH-141348)

gh-141174: Improve `annotationlib.call_annotate_function()` test coverage (#141176)

* Test passing unsupported Format values to call_annotate_function()

* Test call_evaluate_function with fake globals that raise errors

* Fix typo and comparison in test_fake_global_evaluation

gh-141174: Improve `ForwardRef` test coverage (#141175)

* Test unsupported format in ForwardRef.evaluate()

* Test dict cell closure with multiple variables

* Test all options in ForwardRef repr

* Test ForwardRef being a final class

gh-141341: Rename COMPILER macro to _Py_COMPILER on Windows (#141342)

gh-141174: Improve `annotationlib.get_annotations()` test coverage (#141286)

* Test `get_annotations(format=Format.VALUE)` for stringized annotations on custom objects

* Test `get_annotations(format=Format.VALUE)` for stringized annotations on wrapped partial functions

* Update test_stringized_annotations_with_star_unpack() to actually test stringized annotations

* Test __annotate__ returning a non-dict

* Test passing globals and locals to stringized `get_annotations()`

gh-137530: generate an __annotate__ function for dataclasses __init__ (GH-137711)

gh-136702: Clear codec caches for refleak tests; use test.support helpers (GH-141345)

This should fix refleak buildbots.

gh-139707: Specify `winreg`, `msvcrt` and `winsound` module availability in docs (GH-140429)

gh-140500: Update download.html instructions (#141320)

Co-authored-by: Joseph Anthony Pasquale Holsten <joseph@josephholsten.com>

gh-141004: Document `pyctype.h` macros (GH-141272)

gh-141004: Document `Py_DTSF_*` macros (GH-141310)