gh-151159: Bump OpenSSL versions for iOS and Android (GH-151164)

gh-151159: Update macOS installer to use OpenSSL 3.5.7. (#151171)

gh-151159: Update Windows builds to use OpenSSL 3.5.7 (GH-151183)

GH-59633: Clarify dest collisions in argparse docs (#150987)

gh-151126: Add missing `PyErr_NoMemory` in `_winapi` module (#151154)

gh-150285: Fix too long docstrings in the concurrent package (GH-151076)

gh-150285: Fix too long docstrings in the asyncio package (GH-151074)

GH-61082: Clarify nargs='*' positional default behavior (#150989)

GH-54732: Tweak wording around empty lines in argument files (#150980)

Docs: add cross-references to improve navigation in `getpass.rst` (#151092)

gh-150898: Assume OpenSSL supports keylogging (#150870)

Since version 3.10, CPython requires OpenSSL 1.1.1 or higher.
Therefore, support for keylogging can be assumed.

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

Docs: Only add `profiling-sampling-visualization.{css,js}` to files when necessary (#151150)

gh-151039: Fix a crash when `_datetime` types outlive `_datetime` module (#151044)

gh-151130: Add more tests for PyWeakref_* C API (GH-151131)

gh-143008: Fix Null pointer dereferences in TextIOWrapper underlying stream access (#145957)

TextIOWrapper keeps its underlying stream in a member called
`self->buffer`. That stream can be detached by user code, such as custom
`.flush` implementations resulting in `self->buffer` being set to NULL.
The implementation often checked at the start of functions if
`self->buffer` is in a good state, but did not always recheck after
other Python code was called which could modify `self->buffer`.

The cases which need to be re-checked are hard to spot so rather than
rely on reviewer effort create better safety by making all self->buffer
access go through helper functions.

Thank you yihong0618 for the test, NEWS and initial implementation in
gh-143041.

Co-authored-by: yihong0618 <zouzou0208@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-151126: Fix missing `PyErr_NoMemory()` in `remove_unused_consts` (#151127)

gh-151070: Fix class referencing typo in collections.abc docs (GH-151088)

gh-150633: Minor improvement of a newly added test (#151103)

Minor improvement of a newly added test.

gh-150633: Properly handle null characters in the name when importing frozen modules (GH-150634)

gh-148932: Fix `profiling.sampling` on Windows virtual environments (#150541)

gh-151019: Fix test_os on 32-bit FreeBSD (#151087)

Remove references to server.handler_instance. This attribute has been
removed in 2022 by commit 3ae975f1ac880c47d51cca6c9e305547bd365be7.

Fix a typo in the `SECURITY.md` (#151086)

gh-106318: Add examples to the `str.isdigit()` method docs  (#144721)

Co-authored-by: Stan Ulbrych <stan@python.org>

gh-141623: operator.rst: don't use term "bitwise" (GH-141846)

Mention `frozendict` in `object.__hash__()` documentation (#148867)

gh-151059: [perf] Use `PyObject_CallMethodOneArg` in datetime's `call_tzinfo_method` (#151062)

gh-101100: Fix Sphinx warnings in 'Buffer Object Structures' documentation (#151058)

Docs: Fix missing colon in `bisect` example function (GH-151061)

gh-69619: Clarify "whitespace" in the `str.{l,r}strip()` documentation (#150901)

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

Update an error message in the 'Functional Programming HOWTO' (#151047)

gh-150599: Prevent bz2 decompressor reuse after errors (#150600)

gh-150885: Remove unused shutil._ensure_directory (GH-150883)

No longer used after gh-146581 (GH-146591).

gh-151021: Fix mmap empty searches past the end (GH-151023)

gh-150942: Speed up re.findall and re.sub/subn result building (gh-150943)

gh-150942: Speed up frame local item collection (gh-151002)

gh-148954: Escape methodname in xmlrpc.client.dumps() to prevent XML injection (GH-148968)

gh-50948: IDLE: Warn if saving a file will overwrite a newer version (GH-17578)

Co-authored-by: Guilherme Polo <ggpolo@gmail.com>
Co-authored-by: Priya Pappachan <priyapappachan010@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-150411: fix `gc_generation.count` race in free-threading (#150413)

gh-149083: Use sentinel for urllib.parse._UNSPECIFIED (#149612)

This was added in 3.15; let's use a real sentinel instead of an ad-hoc list object.

Delete mention encoding and errors for importlib.resources.path() (GH-143111)

Doc: fix order of PyLong_FromUnsignedLongLong (#150937)

gh-150534: Add C23 half-turn trigonometric *pi functions (GH-150555)

Add the the following functions to the math module:
acospi, asinpi, atanpi, atan2pi, cospi, sinpi, tanpi.

gh-149835: Use realpath() instead of abspath() in shutil.move() (GH-149986)

gh-84649: Use statx() in TimedRotatingFileHandler if available (ПР-150968)

This allows to support rotation based on the file birth time on Linux.

gh-150889:  Improve performance of unicodedata.normalize() (GH-150890)

Scan the nfc_first/nfc_last reindex tables comparing only .start, range-check
the candidate once, and terminate on a sentinel above every codepoint, so each
entry costs a single comparison. ~2x faster on non-Latin and combining-heavy
NFC/NFKC input; no new data tables.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

gh-148832: Use `-icf=0` in BOLT_APPLY_FLAGS (gh-148833)

gh-150662: Stop unbounded memory growth in Tachyon `--gecko` collector (#150845)

gh-150207: Raise MemoryError on tokenizer allocation failure instead of crashing (#150275)

Use `time.monotonic` in OrderedDict LRU cache example (#150986)

gh-110631: Fix wrong blocks indentation in difflib.rst (GH-110885)

gh-150436: Check returncode in Win32ProcessTestCase (#150972)

gh-149977: Fix extra output of `-m test test_lazy_import`, again (#150965)

gh-150818: Wire logger parent before publishing it in getLogger() (GH-150941)

gh-146527: Fix memory leak in _PyGC_Fini() (#150969)

Free generation_stats allocated by _PyGC_Init().

Fix Python/gc.c: Python/gc_free_threading.c was already fixed.

gh-53144: Improve charset support in the email package (GH-149942)

Defer to the codecs module for all aliases.
Use MIME/IANA names for all IANA registered charsets.
Fix email.contentmanager.set_text_content().

gh-84649: Fix unstable test_rollover_based_on_st_birthtime_only (GH-150954)

gh-150907: Fix dynamic_annotations.h when built with C++ and Valgrind (#150914)

Add extern "C++" scope for the C++ template.

Fix test_cppext when Python is built with --with-valgrind.

gh-149891: Add more encoding aliases (GH-149892)

Support all aliases officially registered in IANA, except
Extended_UNIX_Code_Packed_Format_for_Japanese.

New names:
KSC_5601, KS_C_5601-1989, iso-ir-149, GB_2312-80, windows-936, mac,
CCSID00858, CCSID01140, and a number of "cs"-prefixed names.

Fix csHPRoman8, which was not normalized.

gh-129011: Update docs for Raw I/O read, readinto, and write (#135328)

Update `RawIOBase` and `FileIO` documentation to match implementation
behavior around `.read`, `.readinto`, `.readall` and `.write`.

In particular:

 - They may make more than one system call (PEP-475)
 - Add warnings if `.write()` requires a wrapping retry loop (see: gh-126606)
    - "Raw I/O" `.write`` may not write all bytes
    - `buffering=0` example results in a "Raw I/O"

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-150899: Do not reset custom `-Xlazy_imports` mode in `test_lazy_imports` (#150900)

gh-62825: Fix encoding aliases "KS_C_5601-1987", "KS X 1001", etc (GH-150933)

They are now aliases of CP949 instead of EUC-KR.

gh-145177: Bump emscripten version to 4.0.19 (#150926)

Bumpts the emscripten version to 4.0.19.

Add shebang documentation for PyManager 26.3b1 (GH-150931)

gh-150886: Remove unused importlib._bootstrap._object_name (#150884)

Introduced in GH-23469 (bpo-26131, "Deprecate usage of load_module()")
to render an object's qualified name inside the load_module()
deprecation warnings.

Orphaned by gh-142205 (GH-97850, "Remove all uses and definitions of
load_module() from importlib"), which deleted the warning-building call
sites f"{_object_name(spec.loader)}.exec_module() not found; ..." and
left the helper with no caller.

A word-boundary search across Lib, Modules, Python, Objects and Include
finds zero references outside its own definition, and a GitHub code
search finds no downstream importers. The frozen importlib was
regenerated; importlib._bootstrap._object_name no longer exists at
runtime and the full test_importlib suite passes.

gh-150817: Speed up Flag bitwise operations (GH-150824)

Flag.__or__, __and__ and __xor__ walked both operands on every call to reject
None values. Run that scan only when one of the operand values is actually
None, so valid combinations skip it. The TypeError and its message are
unchanged for the invalid cases.

gh-150818: Speed up logging.getLogger() for existing loggers (GH-150825)

GH-148960: Ensure that asserts are ignored if `NDEBUG` is set (#150916)

gh-84649: Make TimedRotatingFileHandler use CTIME instead of MTIME (GH-24660)

The TimedRotatingFileHandler previously only used st_mtime attribute of the
log file to detect whether it has to be rotate yet or not. In cases when the
file is changed within the rotatation period the st_mtime is also updated
to the current time and the rotation never happens.

It's more appropriate to check the file creation time (st_ctime) instead.
Whenever available, the more appropriate st_birthtime will be in use. (This
feature is available on FreeBSD, MacOS and Windows at the moment.) If
the st_mtime would be newer than st_ctime (e.g.: because the inode
related to the file has been changed without any file content
modification), then the earliest attribute will be used.

gh-150913: Fix sqlite3.Blob validation for empty slice assignment (GH-150915)

ass_subscript_slice() returned early when the computed slice length
was zero, bypassing validation performed for non-empty slices.

gh-150750: Fix a race condition in `deque.index` with free-threading (#150779)

gh-106318: Add doctest role and a 'See also' to the `str.split()` docs (#144367)

bpo-38131: Improve messages when generating AST nodes from objects with wrong field values (GH-17715)

Fix 2 broken links in documentation (#150892)

Co-authored-by: Stan Ulbrych <stan@python.org>

gh-119670: Add `force` keyword only argument to `shlex.quote` (#148846)

There are propositions to add a single-quote-double-quote switch
(gh-90630), so to avoid hiccups of people passing `force` as a
positional and it being used for the single-double switch, we make
kwargs kwargs-only.

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

Manpage formatting tweaks & lint (GH-132338)

Following on from GH-132291 this is the second part of the patch from https://bugs.debian.org/1101406

This tweaks the formatting of a few bits of the manpage.

gh-145177: Fix Emscripten help text (#150874)

Removes some stray commas in help text.

gh-150032: Tidy up 3.15 pending removals (#149594)

Co-authored-by: Savannah Ostrowski <savannah@python.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>

Docs: Replace hardcoded `SOURCE_URI` with `patchlevel` check (#150850)

gh-132467: Document and test that generic aliases are not classes (#133504)

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

Correct Stable ABI documentation for METH_FASTCALL (GH-149593)

* Correct Stable ABI documentation for METH_FASTCALL

The current documentation says:

>
> METH_FASTCALL
>    Part of the Stable ABI since version 3.7.
>
> [...]
>
>   Added in version 3.7.
>
>    Changed in version 3.10: METH_FASTCALL is now part of the stable ABI.

so is contradictory about when it was added to the Stable ABI.  Looking at the header it seems like 3.10 is right.

gh-105812: Make use of the Sphinx `deco` role in documentation (#139598)

gh-141004: Document unstable perf map functions in `ceval.h` (GH-143492)

Fix a typo in `SSLSocket` docs (GH-150839)

gh-146636: Add Free-threaded Stable ABI migration guide (GH-150580)

Co-authored-by: Charlie Lin <tuug@gmx.us>
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-148613: Fix race in `gc_set_threshold` and `gc_get_threshold` (#150356)

gh-150723: Fix perf jitdump files on macOS (#150728)

The perf jitdump format defines the thread id field of the JR_CODE_LOAD
record as a 32-bit value, but on macOS it was declared as a uint64_t
(since pthread_threadid_np() returns a uint64_t). Those extra 8 bytes
plus alignment padding shifted every following field, so parsers reading
the file by the spec misread code_size as the code address and failed to
resolve any Python frames.

Declare thread_id as uint32_t on all platforms and truncate the macOS
thread id when writing the record. The value is only informational.
Symbols are resolved by address, and not thread ids so truncation is
safe here.

* Use mach_absolute_time for macOS jitdump timestamps

On macOS the jitdump file is consumed by profilers such as samply, which
timestamp their samples using mach_absolute_time(). The jitdump events were
stamped with clock_gettime(CLOCK_MONOTONIC), a different clock domain that
keeps advancing while the system is asleep, so the JIT code mappings could be
off by days relative to the samples and no Python frame would resolve. Stamp
jitdump events with mach_absolute_time() on macOS so they share the sampler's
clock domain. Linux continues to use CLOCK_MONOTONIC to stay aligned with perf.

Exercise the -Xperf_jit (jitdump) backend through samply and assert that
Python frames resolve, exercising the binary jitdump path end to end.
Skipped when samply is not installed.

gh-91099: fix[imaplib]: call Exception with string instance (#31823)

* bpo-46943: fix[imaplib]: call Exception with string instance

Adjust the behavior of 'login' to be similar to `authenticate()`,
where self.error is called with a str() instance.

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>

gh-150319: Replace all documentation which says "See PEP 585" (#150325)

* Replace all documentation which says "See PEP 585"

The following classes in the stdlib get simple updates:

- array.array
- asyncio.Future
- asyncio.Task
- collections.defaultdict
- collections.deque
- contextvars.ContextVar
- contextvars.Token
- ctypes.Array
- os.DirEntry
- re.Match
- re.Pattern
- string.templatelib.Interpolation
- string.templatelib.Template
- types.MappingProxyType
- queue.SimpleQueue
- weakref.ref

The following classes are documented publicly as functions, and are
therefore updated internally (`__class_getitem__.__doc__`) but not in the
public docs:

- functools.partial
- itertools.chain

The following builtin types have updates to `__class_getitem__.__doc__`
but not to any documentation pages:

- BaseExceptionGroup
- coroutines (from generators)
- dict
- enumerate
- frozendict
- frozenset
- generators (and async generators)
- list
- memoryview
- set
- slice
- tuple

Special cases:

- union objects are now documented as "supporting class-level []",
  rather than anything to do with generics.

- Templates might be generic over a single type (union, in theory) or
  over a TypeVarTuple. As this is not currently fully settled, it is
  marked with a comment and a mild hint that it is a single type is used
  (namely, "type" is singular rather than "types", plural)

* Apply suggestions from code review

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Correct several class getitem docs

And expand the text for tuples.

Co-authored-by: Jelle Zijlstra <906600+JelleZijlstra@users.noreply.github.com>
* Add notes on generic typing of builtins

* Fix typo in tuple.__class_getitem__ docstring

* Typo fix: malformed refs

Fix `generic` links which weren't marked as `:ref:`.

* Strike unnecessary docs on generic-ness

Co-authored-by: Jelle Zijlstra <906600+JelleZijlstra@users.noreply.github.com>
* Apply suggestions from code review

These are applied at both the originally indicated locations and in the
corresponding docstring definitions.

Co-authored-by: Alex Waygood <66076021+AlexWaygood@users.noreply.github.com>
* Update Doc/library/re.rst

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Objects/enumobject.c

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Remove tuple generic doc in 'stdtypes' page

This is covered in more detail in the cross-linked typing documentation.
The other copy of this documentation -- in the docstring for
`tuple.__class_getitem__` -- is left in place.

* Fix whitespace around new doc of generics

Per review, do not introduce or remove whitespace such that section
breaks are altered by the introduction of doc on various generic types.

In most cases, this is a removal of an extra line.

In one case (Arrays), it is the reintroduction of a line.

Additionally, two other minor fixes are included:
- incorrect indent on 'defaultdicts'
- make `mappingproxy.__class_getitem__.__doc__` consistent with other
  mapping type generic docs

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Move placement of memoryview generic note

Previous placement was at the end of the main docstring, which is
consistent with other types but places it after a section on various
methods (which makes it read somewhat inconsistently). Moving it up
helps resolve.

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Ensure sphinxdoc does not start sentences lowercase

Lowercase class names at the start of sentences are marked out with the
`class` role. In the case of `deque`, documentation already refers to
these as `Deques`, so this form is preferred.

* Apply suggestions from code review

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Fix line endings and wrap more tightly

Line endings fixed by pre-commit ; also re-wrapped the MappingProxyType
text which was too long.

* Use 'ContextVars' style in sphinx doc

---------

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Jelle Zijlstra <906600+JelleZijlstra@users.noreply.github.com>
Co-authored-by: Alex Waygood <66076021+AlexWaygood@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

Fix description of the function parameter of shutil.register_archive_format() (GH-145087)

Add link to new security policy (#150800)

gh-141627: Fix BufferedRandom inheritance documentation (GH-141629)

BufferedRandom does not inherit from BufferedReader and BufferedWriter
in the C implementation.

gh-101913: changed wording of docstring for _parsedate_tz (#134446)

Fixed incorrect word.

Co-authored-by: Gustaf <79180496+GGyll@users.noreply.github.com>

gh-148587: Document `sys.lazy_modules` (#150742)

Silence experimental coroutine deprecation warnings (#150788)

Co-authored-by: Zachary Ware <zach@python.org>

gh-149187: Document `frozendict()` under 'Built-in Functions' (#149185)

gh-150766: export `_PyGC_VisitFrameStack` and `_PyGC_VisitStackRef` functions (#150767)

gh-89554: Document _thread.LockType as a class (#150684)

_thread.LockType is a class (the type of lock objects), but was documented
with the ".. data::" directive, so ":class:" cross-references to it cannot
resolve against a py:class target.

Switch the entry to ".. class::", move it next to the lock methods, and
document acquire(), release() and locked() as methods of the class.  Keep
the old _thread.lock.* URL fragments working with raw HTML anchors.

gh-115119: Fix libmpdec detection when pkg-config files are missing (#150502)

The fallback for systems with no mpdecimal .pc files used AC_LINK_IFELSE
directly, which relied on LIBMPDEC_LIBS being set. On failure this was empty
so the link test ran without -lmpdec.

Use AC_CHECK_HEADER and AC_CHECK_LIB instead.

gh-149079: Fix O(n^2) canonical ordering in unicodedata.normalize() (GH-149080)

Replace the insertion sort used for canonical ordering of combining
characters with a hybrid approach: insertion sort for short runs (< 20)
and counting sort for longer runs, reducing worst-case complexity from
O(n^2) to O(n). This prevents denial of service via crafted Unicode
strings with many combining characters in alternating CCC order.

Co-authored-by: ch4n3-yoon <ch4n3.yoon@gmail.com>
Co-authored-by: Seokchan Yoon <13852925+ch4n3-yoon@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Maurycy Pawłowski-Wieroński <maurycy@maurycy.com>

gh-149805: Fix `SystemError` when compiling `__classdict__` class annotation (#149806)