gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (#137859)

bpo-38735: Don't fail when importing from / with sys.pycache_prefix set (GH-30456)

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

gh-131885: Use positional-only markers for the ``decimal`` module (#131990)

gh-137847: Add examples for UUIDv6-8 (#137848)

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

gh-137729: Fix support for locales with @-modifiers (GH-137253)

gh-127146: Emscripten: Add test_sample_profiler skips where needed (#137815)

Emscripten doesn't have the `socket.SO_REUSEADDR` constant; skip tests that
require that symbol to exist.

Emend an error in ``string.templatelib`` example output (#137890)

GH-137841: Open tzdata/zones file with UTF-8 encoding (#137872)

gh-135661: Fix parsing unterminated bogus comments in HTMLParser (GH-137873)

Bogus comments that start with "<![CDATA[" should not include the starting "!"
in its value.

gh-131591: fix formatting of remote debugger docs (#137225)

gh-137846: Add missing 'be' to profile doc. (#137856)

Insert 'be' into 'will interpreted'.

gh-137725: Convert faulthandler to Argument Clinic (#137726)

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

gh-90483: fix docs of `SubprocessTransport.get_pipe_transport ` (#137852)

gh-101359: clarify docs for `asyncio.Event.clear` (#137849)

gh-120492: Sync importlib_metadata 8.2.0 (#124033)

* Sync with importlib_metadata 8.2.0

Removes deprecated behaviors, including support for `PackageMetadata.__getitem__` returning None for missing keys and Distribution subclasses not implementing abstract methods.
Prioritizes valid dists to invalid dists when retrieving by name (python/cpython/#120492). Adds SimplePath to `importlib.metadata.__all__`.

* Add blurb

gh-92936: update `http.cookies` docs post GH-113663 (#137566)

* add versionchanged and example with quotes in cookie value

* update whatsnew with http.cookies change

* Update Doc/library/http.cookies.rst

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Update Doc/whatsnew/3.15.rst

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

* demonstrate json

* Update Doc/library/http.cookies.rst

Co-authored-by: Senthil Kumaran <senthil@python.org>
* Apply suggestions from code review

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

---------

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Senthil Kumaran <senthil@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

 gh-131178: Add tests for `site` command-line interface  (GH-133582)

gh-137777: Disband the 'Program Frameworks' chapter (#137796)

gh-137078: Fix keyword typo recognition when executed over files (#137079)

GH-123299: Copyedit 3.14 What's New: Removed (#137794)

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

gh-137808: use argument clinic for `_thread.lock` and `_thread.RLock` (#137809)

gh-137760: Update REPL constants documentation (gh-137798)

GH-123299: Copyedit 3.14 What's New: Optimizations (#137789)

Mention the "context manager" keyword in concurrent.futures documentation (#130976)

gh-137716:  Fix double period in AttributeError message for invalid mock assertions (#137717)

gh-135241: Make unpickling of booleans in protocol 0 more strict (GH-135242)

The Python pickle module looks for "00" and "01" but _pickle only looked
for 2 characters that parsed to 0 or 1, meaning some payloads like "+0" or
" 0" would lead to different results in different implementations.

gh-135661: Fix CDATA section parsing in HTMLParser (GH-135665)

"] ]>" and "]] >" no longer end the CDATA section.

Make CDATA section parsing  context depending.
Add private method HTMLParser._set_support_cdata() to change the context.
If called with True, "<[CDATA[" starts a CDATA section which ends with "]]>".
If called with False, "<[CDATA[" starts a bogus comments which ends with ">".

gh-137576: Fix for Basic REPL showing incorrect code in tracebacks with `PYTHONSTARTUP` (#137625)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>

Update link to translating in the devguide in `bugs.rst` (#137736)

gh-123299: Update What's new in Python 3.14: typos and misplaced item. (#136665)

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

gh-109975: Indicate the minimum version for PyREPL in the tutorial (#136046)

gh-133403: Run `mypy` on `Tools/build/check_warnings.py` (#137700)

gh-74185: repr() of ImportError now contains attributes name and path (#136770)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
Co-authored-by: ynir3 <ynir3@bloomberg.net>

gh-125854: Improve error messages for invalid category in the warnings module (GH-137750)

Include the type name if the category is a type, but not a Warning
subclass, instead of just 'type'.

gh-137749: Python 3.14 installer is for macOS 10.15 and later (#137753)

gh-130821: Add type information to error messages for invalid return type (GH-130835)

GH-137573: mark _PyOptimizer_Optimize as no inline (GH-137731)

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

gh-132339: Add support for OpenSSL 3.5 (GH-137720)

* Add OpenSSL 3.5.2 definitions to Modules/_ssl_data_35.h (moved from Modules/_ssl_data_34.h)

* Demote OpenSSL 3.1 to "old", remove it from CI

* Update all OpenSSL versions to latest patchlevel in CI config and multissltests defaults

* Add OpenSSL 3.5.2 to CI configuration and multissltests default list

* Fix a typo in the argument parser description of multissltests.py

Use the latest dev container image perpetually (#137734)

With `Tools/wasm/wasi` now selecting the appropriate WASI SDK based on the supported version, we can now use the `latest` label of the image.

gh-131788: make resource_tracker re-entrant safe (GH-131787)

* make resource_tracker re-entrant safe
* Update Lib/multiprocessing/resource_tracker.py
* trim trailing whitespace
* use f-string and args = [x, *y, z]
* raise self._reentrant_call_error

---------

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

gh-137400: Fix thread-safety issues when profiling all threads (gh-137518)

There were a few thread-safety issues when profiling or tracing all
threads via PyEval_SetProfileAllThreads or PyEval_SetTraceAllThreads:

* The loop over thread states could crash if a thread exits concurrently
  (in both the free threading and default build)
* The modification of `c_profilefunc` and `c_tracefunc` wasn't
  thread-safe on the free threading build.

Add internal doc describing the stack protection mechanism (GH137663)

gh-87281: Improve documentation for locale.setlocale() and locale.getlocale() (GH-137313)

Add a section explaining the locale name formats.

gh-137681: Always initialize exception handler for new instruction (#137655)

Always initialize exception handler for new instruction

gh-137226: Fix behavior of ForwardRef.evaluate with type_params (#137227)

The previous behavior was copied from earlier typing code. It works around the way
typing.get_type_hints passes its namespaces, but I don't think the behavior is logical
or correct.

gh-73487: Convert `_decimal` to use Argument Clinic (part 1) (#137606)

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

gh-64612: Remove  error handlers list under `open()` (GH-137304)

This was duplicated and out-of date.

gh-137668: Document that ord() supports also bytes and bytearray (GH-137669)

gh-131146: Fall back to `month_name` if `standalone_month_name`s aren't distinct (GH-137674)

Some systems reportedly don't expand '%OB' and '%Ob'.
In this case (and similar theoretically possible ones, like expanding to empty
string or 'OB'), fall back to the month_name & month_abbr.

GH-137630: Argument Clinic: Reduce use of 'as' for renaming in ``_interpretersmodule.c`` (#137680)

gh-133403: Run `mypy` on `Tools/build/mypy.ini` changes (#137692)

GH-137623: Begin enforcing docstring length in Argument Clinic (#137624)

gh-136672: Docs: Move Enum functions and add examples (GH-136791)

* Docs: Move Enum functions and add examples

When the `Enum` functions `_add_alias_` and `_add_value_alias_` were added in de6bca956432cc852a4a41e2a2cee9cdacd19f35, the documentation for them was done under `EnumType` instead of `Enum`.

This change moves them to the docs of the `Enum` class and adds an example for each function.

---------

Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

GH-137562: Fix github-issue number for deallocated objects in cache bug (GH-137614)

gh-137242: Add Android CI job (#137186)

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

GH-137630: Convert ``_interpreters`` to use Argument Clinic  (#137631)

gh-133403: Check `generate_stdlib_module_names` and `check_extension_modules` with mypy (#137546)

gh-137288: Update 3.14 magic numbers (GH-137665)

gh-135228: When @dataclass(slots=True) replaces a dataclass, make the original class collectible (take 2) (GH-137047)

Remove the `__dict__` and `__weakref__` descriptors from the original class when creating a dataclass from it.

An interesting hack, but more localized in scope than gh-135230.

This may be a breaking change if people intentionally keep the original class around
when using `@dataclass(slots=True)`, and then use `__dict__` or `__weakref__` on the
original class.

Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-126008: Improve docstrings for Tkinter cget and configure methods (GH-133303)

* Explain the behavior of Widget.configure() depending on arguments.
* Unify descriptions.
* Replace "resource" with "option".

gh-131885: Use positional-only markers for ``max()`` and ``min()`` (#131868)

GH-137426: Remove code deprecation of `importlib.abc.ResourceLoader` (GH-137567)

Enough other classes in `importlib.abc` inherit from the class and the deprecation was to redirect people to `TraversableResources`. The documentation now makes it clear the class only exists for backwards compatibility.

---------

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

gh-125897: Mark range function parameters as positional only (#125945)

gh-137400: Fix a crash when disabling profiling across all threads (gh-137471)

The `PyEval_SetProfileAllThreads` function and other related functions
had a race condition on `tstate->c_profilefunc` that could lead to a
crash when disable profiling or tracing on all threads while another
thread is starting to profile or trace a a call.

There are still potential crashes when threads exit concurrently with
profiling or tracing be enabled/disabled across all threads.

gh-115766: Fix IPv4Interface.is_unspecified (GH-137326)

gh-128813: cleanup C-API docs for PyComplexObject (GH-137579)

* move non-deprecated API up
* make a dedicated section for deprecated low-leved API

gh-135953: Profile a module or script with sampling profiler (#136777)

Fix documentation of hash in PyHash_FuncDef (#137595)

Because of a small typo, it wasn't showing up in the generated docs.

Add test for opening an SQLite with bytes path (GH-136331)

Update pre-commit hooks (#137591)

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

gh-137583: Only lock the SSL context, not the SSL socket (GH-137588)

Fixes a deadlock in 3.13.6.

gh-136571: Convert more code in datetime to Argument Clinic (GH-136573)

This adds signatures for some classes and methods.

date.fromisocalendar() can now raise OverflowError for arguments that
don't fit in the C int.

GH-132532: Add new DSL macros to better declare semantics of exits at ends of instructions/uops. (GH-137098)

gh-137562: Remove reference for GC_REACHABLE in comment (GH-137563)

GC_REACHABLE is obsolete

gh-137026: Add an explainer guide for asyncio (GH-137215)

* - Add an explainer guide (aka HOWTO, not how-to) for asyncio.

* Fix linter errors.

* - Enforce max line length of roughly 79 chars.
- Start sentences on new lines to minimize disruption of diffs.

* Add reference to subinterpreters.

* - Significantly reduce article size. Remove both example sections & "Which concurrency do I want" section.

* Align section-header lengths with section names.

* - Remove reference to deleted section.

* - Fix a variety of rote style guide items like title-alignment, use of ie and $, and so forth.
- Add links to other parts of the docs for keywords and objects like await, coro, task, future, etc.

* - One last title alignment.

* - Style nit.

* - Rework a variety of I statements.

* Lint fix.

* - Firm up commentary on yield from in corotuines.

* Update language comparing await and yield from.

* - Remove await-ing Tasks and futures section

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* - Address comments related to style & writing flow.

* per-thread event loop note.

* Add section describing coroutines roots in generators.

* Phrasing tweak.

* Use asyncio.create_task instead of asyncio.Task

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* style nits

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* Fix misnaming of async generator.

* phrasing nits.

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

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

* nits

* - Variety of style & grammar improvements thanks to ZeroIntensity's comments.

* - Make all directives start with a 3 space indent. Then 4 thereafter.

* - Use :linenos: instead of manually writing the line numbers.

* - Fix label typo for article.

* fix label link.

* Apply suggestions from code review

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* - introduce async-sleep name

* Phrasing

* nit

* ungendered octopus

* teammates

* jobs

* rework fella to penguin

* - remove byline; add seealso

* Change ref from asyncio to use seealso block.

* Remove typehints. Fix indentation in one code example.

* Slight rephrase for clarity.

* Make references point to asyncio. Wrap some long lines.

* - Variety of style/phrasing improvements based on PR feedback.

* phrasing.

* phrasing nit.

* Apply suggestions from code review

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* nit

* Apply suggestions from code review

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* fix backticks.

* nits

* nit

* add section on asyncio.run

* title change under the hood.

* modify task coro example.

* howtos article link.

* prefer await without backticks.

* phrasing tweak.

* Rework phrasing around how await tasks pauses and returns control in the await section.

* move code block to beforfe explanation in coroutine under the hood.

* phrasing.

* link to yield from.

* style nits

* nit

* - Modify language re: event-loop cycling endlessly.
- Discuss why await was designed to not yield for coros.

* - Add a note about debug=True on asyncio.run to await coro section.

* clarity nit

* - Add two other references in seealso block.

* nit

* Language simplification

* Apply suggestions from code review

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

* grammar fix.

* fix

* worker bees

* rework event loop paragraph to significantly deemphasize queues

* remove all references to queue besides the initial analogy.

* add note about garbage collection of tasks

* add practical note re: garbage collection

* phrasing nits

* re arrange note on task gc.

* line wrap nit

* Update Doc/howto/a-conceptual-overview-of-asyncio.rst

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
* link to debug mode docs.

* readd part2 prefix.

* simplify title.

* fix titles. tihnk I messed this up earlier.

* avoid idiom in title.

* fix titles once agian.

* Apply suggestions from code review

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
* rework task gc example.

* phrasing tweak.

* tewak.

* nit

* nit

* nit

* nit

---------

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-92936: allow double quote in cookie values (#113663)

* allow double quote in cookie values
* Update Lib/test/test_http_cookies.py

Co-authored-by: Senthil Kumaran <senthil@python.org>

gh-133722: Add Difflib theme to `_colorize` and 'color' option to `difflib.unified_diff` (#133725)

Replace "ordered arguments" with "positional arguments" in `unittest.mock` documentation (GH-137552)

gh-128813: deprecate cval field of the PyComplexObject struct (#137271)

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

Bump mypy to 1.17.1 (#137542)

[Doc] Remove unnecessary quotes from typing module (#137207)

* gh-106320: Remove private _PyInterpreterState functions (#106335)

Remove private _PyThreadState and _PyInterpreterState C API
functions: move them to the internal C API (pycore_pystate.h and
pycore_interp.h). Don't export most of these functions anymore, but
still export functions used by tests.

Remove _PyThreadState_Prealloc() and _PyThreadState_Init() from the C
API, but keep it in the stable API.

* Doc: minor change

* Revert "Doc: minor change"

This reverts commit ebfa0937c2caf0110ab1540f14956d56fe925092.

* [Doc] Remove unnecessary quotes from typing (See Also section)

* [Doc] Remove unnecessary quotes from typing

---------

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

GH-136155: Fail the EPUB check on fatal errors (#137351)

GH-135552: Add tests to check weakref clearing (GH-136304)

These are tests to ensure behaviour introduced by GH-136189 is working as expected.

Co-authored-by: Mikhail Borisov <43937008+fxeqxmulfx@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Neil Schemenauer <nas-github@arctrix.com>

gh-130102: drop "require numeric arguments" from pow() docs (#137456)

Co-authored-by: Senthil Kumaran <senthil@python.org>

GH-135552: Make the GC clear weakrefs later (GH-136189)

Fix a bug caused by the garbage collector clearing weakrefs too early.  The
weakrefs in the ``tp_subclasses`` dictionary are needed in order to correctly
invalidate type caches (for example, by calling ``PyType_Modified()``).
Clearing weakrefs before calling finalizers causes the caches to not be
correctly invalidated.  That can cause crashes since the caches can refer to
invalid objects.  Defer the clearing of weakrefs without callbacks until after
finalizers are executed.

gh-137412: fix `default_builtin_hashes` values in `test_hashlib.py` (#137413)

fix `default_builtin_hashes` in test_hashlib

gh-137291: Support perf profiler with an evaluation hook (#137292)

Support perf profiler with an evaluation hook

GH-119085: Move comment in Python/gc.c to correct place.

In GH-116206, the comment about moving reachable objects to next generation
got moved from its original place to a place where there is no code below
it. Put the comment back to where the actual movement of reachable objects
happens.

gh-137526: Fix broken link to drdobbs journal in difflib.rst (#137527)

add floss.fund manifest provenance (#137529)

ref: https://fundingjson.org/#wellknown

Remove redundant assignment in asyncio.streams.StreamReaderProtocol.connection_lost() (GH-137524)

The _stream_writer attribute was removed in a355f60 (gh-114914).

gh-137514: Add a free-threading wrapper for mutexes (GH-137515)

Add `FT_MUTEX_LOCK`/`FT_MUTEX_UNLOCK`, which call `PyMutex_Lock` and `PyMutex_Unlock` on the free-threaded build, and no-op otherwise.

gh-135336: Add fast path to json string encoding (#133239)

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-137440: Update comment in Python/hamt.c on importing for testing (GH-137441)

Switch from `_testcapi` to `_testinternalcapi`.

gh-137044: Support large limit values in getrlimit() and setrlimit() (GH-137338)

* Return large limit values as positive integers instead of negative integers
  in resource.getrlimit().
* Accept large values and reject negative values (except RLIM_INFINITY)
  for limits in resource.setrlimit().

gh-137463: Update `validate_abstract_methods` in `test_collections.py` (#137464)

Update `validate_abstract_methods` in `test_collections.py`

The test for missing abstract methods in `validate_abstract_methods` incorrectly attempted to instantiate the generated class `C` with an argument (`C(name)`), which always raises a `TypeError: C() takes no arguments`. Although the test originally passes, it passes for the wrong reason.

This change makes the test correctly validate the enforcement of abstract methods in ABCs.

gh-137499: Fixed dead link to NIST website (#137500)

gh-84683: Check `<prefix>/share/zoneinfo` for zoneinfo files on Windows (GH-28495)

Docs: Small clarity change for ``except*`` (#121073)

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

Docs: Use the correct example module in warnings.rst (#137402)