Docs: make a tutorial example more precise (#125066)

Based on discussion here:

https://discuss.python.org/t/omission-in-the-documentation/66816

gh-125072: Add label for assignment expressions; update tracked section for assignment expression topic (#125074)

gh-124502: Add PyUnicode_Equal() function (#124504)

gh-122392: IDLE - Fix overlapping lines in browsers (#122392) (#124975)

Increase currently inadequate vertical spacing for the IDLE browsers (path,
module, and stack) on high-resolution monitors.
---------

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

gh-124653: Relax (again) detection of queue API for logging handlers  (GH-124897)

Use _PyLong_GetOne() and _PyLong_GetZero() in long_invmod() (#125044)

These functions cannot fail.

gh-124182: Explain naming rules for struct sequence types (#124335)

gh-124956: Use `#undef` for temp macros in `_csv.c` (#124957)

GH-121459: Streamline PyObject* to PyStackRef conversions by disallowing NULL pointers. (GH-124894)

gh-125018: Fix role syntax (#125050)

gh-120762: make_ssl_certs: Don't set extensions for the temporary CSR (GH-125045)

gh-120762: make_ssl_certs: Don't set extensions for the CSR

`openssl req` fails with openssl 3.2.2 because the config line

    authorityKeyIdentifier = keyid:always,issuer:always

is not supported for certificate signing requests (since the issuing
certificate authority is not known).

David von Oheimb, the OpenSSL dev that made the change, commented in:
https://github.com/openssl/openssl/issues/22966#issuecomment-1858396738 :

> This problem did not show up in older OpenSSL versions because of a bug:
> the `req` app ignored the `-extensions` option unless `-x505` is given,
> which I fixed in https://github.com/openssl/openssl/pull/16865.

(I assume `-x505` is a typo for `-x509`.)

In our `make_cert_key` function:

If `sign` is true:
- We don't pass `-x509` to `req`, so in this case it should be safe to
  omit the `-extensions` argument. (Old OpenSSL ignores it, new OpenSSL
  fails on it.)
- The extensions are passed to the `ca` call later in the function.
  There they take effect, and `authorityKeyIdentifier` is valid.

If `sign` is false, this commit has no effect except rearranging the
CLI arguments.

GH-119866: Spill the stack around escaping calls. (GH-124392)

* Spill the evaluation around escaping calls in the generated interpreter and JIT.

* The code generator tracks live, cached values so they can be saved to memory when needed.

* Spills the stack pointer around escaping calls, so that the exact stack is visible to the cycle GC.

gh-125018: Add importlib.metadata semantic link targets (#125027)

This allows direct intersphinx references to APIs via references
like `` :func:`importlib.metadata.version` ``.

---------

Co-authored-by: Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

gh-111178: Fix function signatures in fileio.c (#125043)

* Add "fileio_" prefix to getter functions.
* Small refactoring.

gh-121249: Support _Complex types in the struct module (#121613)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

GH-116968: Remove branch from advance_backoff_counter (GH-124469)

GH-109975: Announce final release in What's New in Python 3.13 (#125007)

Prepare What's New in Python 3.13 for final release

gh-125025: `_thread` docs: fix/update the *caveats* list (GH-125026)

Doc: Simplify the definition of 'soft deprecated' (#124988)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>

gh-125010: Fix `use-after-free` in AST `repr()` (#125015)

gh-119535: python𝜋 (#119536)

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>

gh-125008: Fix `tokenize.untokenize` roundtrip for `\n{{` (#125013)

gh-122951: Simplify the grammar of the assignment rule (#124998)

gh-111178: Fix function signatures in genobject.c (#124970)

* Add "CAST" macros.
* Rename parameters/variables "o" to "ag", "ags", "agw" or "agt"
  in some functions.

gh-112804: Clamping timeout value for _PySemaphore_PlatformWait (gh-124914)

* gh-112804: Clamping timeout value for _PySemaphore_PlatformWait

* Address code review

* nit

gh-124552 : Improve the accuracy of possible breakpoint check in bdb (#124553)

gh-119786: Replace a Sphinx role with a link to `Python/errors.c` (#124990)

gh-117151: increase default buffer size of shutil.copyfileobj() to 256k. (GH-119783)

* gh-117151: increase default buffer size of shutil.copyfileobj() to 256k.

it was set to 16k in the 1990s.
it was raised to 64k in 2019. the discussion at the time mentioned another 5% improvement by raising to 128k and settled for a very conservative setting.

it's 2024 now, I think it should be revisited to match modern hardware. I am measuring 0-15% performance improvement when raising to 256k on various types of disk. there is no downside as far as I can tell.

this function is only intended for sequential copy of full files (or file like objects). it's the typical use case that benefits from larger operations.

for reference, I came across this function while trying to profile pip that is using it to copy files when installing python packages.

* add news

---------

Co-authored-by: rmorotti <romain.morotti@man.com>

gh-119786: move a few more details on exception handling from devguide to InternalDocs (#124989)

gh-124871: fix 'visited' tracking in compiler's reachability analysis (#124952)

gh-124962: Convert leftover rst to markup in `InternalDocs/compiler.md` (#124971)

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

Fix console prompt syntax in What's New in Python 3.8 (#124968)

gh-118658: Modify cert generation script to extract cert3.pem (GH-124598)

gh-111178: Fix function signatures in _threadmodule.c (#124964)

gh-109975: Suggest ``pynntp`` instead of ``nntplib`` (#124830)

The ``nntplib`` library has been deleted from PyPI by its author.

gh-111178: Fix function signatures in classobject.c (#124943)

gh-111178: Fix function signatures in bytearrayobject.c (#124940)

gh-111178: Fix function signatures in Python-ast.c (#124942)

gh-123961: Convert `curses.window` static type into a heap type (#124934)

gh-124613: Deactivate perf support in tests if the jit is set (#124794)

gh-124613: Deactivate the JIT during perf tests

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

GH-109975: Copyedit 3.13 What's New: Remove references to the incremental GC (#124947)

Simplify partial() rough equivalent code (gh-124941)

gh-124889: Remove redundant artificial rules in PEG parser (#124893)

Cache in C PEG-generator reworked:
we save artificial rules in cache by Node string representation as a key instead of Node object itself.
As a result total count of artificial rules in parsers.c is lowered from 283 to 170.
More natural number ordering is used for the names of artificial rules.

Auxiliary method CCallMakerVisitor._generate_artificial_rule_call is added.
Its purpose is abstracting work with artificial rules cache.

Explicit using of "is_repeat1" kwarg is added to visit_Repeat0 and visit_Repeat1 methods.
Its slightly improve code readabitily.

gh-123961: Clean up curses C API/capsule (#124907)

gh-115145: Update documentation about ``PyThreadState_DeleteCurrent`` (gh-124920)

gh-121982: ``csv``: Add a test case for invalid ``quoting`` constant. (#121983)

Test invalid quoting constant

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

gh-124858: fix happy eyeballs refcyles (#124859)

GH-118093: Don't lose confidence when tracing through 100% biased branches (GH-124813)

GH-119726: Deduplicate AArch64 trampolines within a trace (GH-123872)

gh-111178: Fix function signatures in funcobject.c (#124908)

gh-120619: Optimize through `_Py_FRAME_GENERAL` (GH-124518)

* Optimize through _Py_FRAME_GENERAL

* refactor

gh-87135: Hang non-main threads that attempt to acquire the GIL during finalization (GH-105805)

Instead of surprise crashes and memory corruption, we now hang threads that attempt to re-enter the Python interpreter after Python runtime finalization has started. These are typically daemon threads (our long standing mis-feature) but could also be threads spawned by extension modules that then try to call into Python. This marks the `PyThread_exit_thread` public C API as deprecated as there is no plausible safe way to accomplish that on any supported platform in the face of things like C++ code with finalizers anywhere on a thread's stack. Doing this was the least bad option.

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

gh-111178: Fix function signatures in longobject.c (#124895)

* Add _PyLong_CAST() macro.
* Move forward declarations to the top of longobject.c.
* Change long_add(), long_sub(), long_mul(), long_neg(),
  long_lshift(), long_abs() to take PyLongObject* and return
  PyLongObject*. Avoid CHECK_BINOP() test.
* Add long_add_method(), long_sub_method(), long_mul_method(),
  long_neg_method(), long_lshift_method(), and long_abs_method()
  which take PyObject* and return PyObject*. Implement CHECK_BINOP()
  test.
* Add long_lshift_int64() function.
* _PyLong_DivmodNear() calls long_lshift_int64(obj, 1) instead of
  long_lshift_obj(obj, one).

gh-111178: Fix function signatures in methodobject.c (#124902)

gh-111178: Fix function signatures in weakrefobject.c (#124903)

gh-124213: Fix incorrect context manager use in in_systemd_nspawn_sync_suppressed() (#124892)

Fix the incorrect use of `os.open()` result as a context manager,
while it is actually a numeric file descriptor.

I have missed the problem, because in the original version the
`os.open()` call would always fail, and I failed to test the final
version in all possible scenarios properly.

gh-120378: Fix crash caused by integer overflow in `curses` (#124555)

This is actually an upstream problem in curses, and has been reported
to them already:
https://lists.gnu.org/archive/html/bug-ncurses/2024-09/msg00101.html

This is a nice workaround in the meantime to prevent the segfault.

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

gh-111178: Fix function signatures in moduleobject.c (#124900)

gh-111178: Fix function signatures in setobject.c (#124888)

gh-111178: Fix locale_free() signature (#124896)

gh-85935: Improve tests for invalid arguments in test_argparse (GH-124891)

Check also specific error messages.

gh-111178: Fix function signatures in tupleobject.c (#124804)

gh-111178: Fix function signatures in bytesobject.c (#124806)

gh-122864: Fix a ``test_funcattrs.test___builtins__`` when executing directly (#124845)

Previously when executing ``test_functattrs.test___builtins__`` directly, it failed because the fact, that ``__builtins__`` is refers to the built-in module ``builtins`` while it's expects a ``__builtins__.__dict__``. But when this test is being run from another module, then ``__builtins__`` is refers to ``builtins.__dict__``. Now this part of the behaviour is covered.
---------

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

GH-124820: Move `-mno-outline-atomics` flag to aarch64 Linux JIT builds only (#124821)

gh-58282: Fix support of tuple metavar for positional arguments in argparse (GH-124782)

Previously, formatting help output or error message for positional argument
with a tuple metavar raised exception.

Co-authored-by: Cyker Way <cykerway@gmail.com>

gh-124835: `tomllib.loads`: Raise TypeError not AttributeError. Improve message (#124587)

Minor code beautifications in statistics.py (gh-124866)

gh-66436: Improved prog default value for argparse.ArgumentParser (GH-124799)

It can now have one of three forms:

* basename(argv0) -- for simple scripts
* python arv0 -- for directories, ZIP files, etc
* python -m module -- for imported modules

Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>

Highlight `datetime.timedelta.seconds` vs `.total_seconds()` in docs. (GH-124811)

Thanks to the reviewers for suggesting the use of a "caution" section instead of "warning" or "note".

gh-116750: Add clear_tool_id function to unregister events and callbacks (#124568)

gh-124218: Refactor per-thread reference counting (#124844)

Currently, we only use per-thread reference counting for heap type objects and
the naming reflects that. We will extend it to a few additional types in an
upcoming change to avoid scaling bottlenecks when creating nested functions.

Rename some of the files and functions in preparation for this change.

gh-124296: Remove private dictionary version tag (PEP 699) (#124472)

gh-124842: Fix test.support.import_helper.make_legacy_pyc() (GH-124843)

For source file "path/to/file.py" it created file with incorrect path
"/absolute/path/to/path/to/file.pyc" instead of "path/to/file.pyc".

gh-124487: Updated installer messages and internal docs regarding minimum Windows version (GH-124822)

gh-124594: Create and reuse the same context for the entire asyncio REPL session (#124595)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

gh-118974: Add `decorator` argument to `make_dataclass` (gh-122723)

This is to allow the `dataclasses.make_dataclass` infrastructure to be used with another decorator that's compliant with `typing.dataclass_transform`. The new `decorator` argument to `dataclasses.make_dataclass` is `dataclasses.dataclass`, which used to be hard coded.

Doc: Fix archive filenames for standard builds (#124826)

GH-109975: Copyedit 3.13 What's New: Link to installing free-threaded binaries on macOS (#124831)

GH-109975: Copyedit 3.13 What's New: Note delayed expected release date for Python 3.13.0 (GH-124827)

Note delayed expected release date of 3.13.0

gh-124309: Revert eager task factory fix to prevent breaking downstream (#124810)

* Revert "GH-124639: add back loop param to staggered_race (#124700)"

This reverts commit e0a41a5dd12cb6e9277b05abebac5c70be684dd7.

* Revert "gh-124309: Modernize the `staggered_race` implementation to support eager task factories (#124390)"

This reverts commit de929f353c413459834a2a37b2d9b0240673d874.

gh-124785: Revert "gh-116510: Fix crash due to shared immortal interned strings (gh-124646)" (gh-124807)

Revert "gh-116510: Fix crash due to shared immortal interned strings. (gh-124646)"

This reverts commit 98b2ed7e239c807f379cd2bf864f372d79064aac.

Minor edit for code clarification in annotationlib. (#124805)

gh-116810: fix memory leak in ssl module (GH-123249)

Resolve a memory leak introduced in CPython 3.10's :mod:`ssl` when the :attr:`ssl.SSLSocket.session` property was accessed. Speeds up read and write access to said property by no longer unnecessarily cloning session objects via serialization.

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Antoine Pitrou <antoine@python.org>

gh-115142: Skip some test cases in ``Lib/test/test_compile`` if ``_testinternalcapi`` is not available (#124474)

* Skip some test cases if "_testinternalcapi" is not available and if the test suite is
   running on another implementation than CPython.

gh-124613, regrtest: Detect JIT in build info (#124793)

gh-124613: Don't run perf tests in JIT builds (#124792)

* gh-124613: Don't run perf tests in JIT builds

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>
* Apply suggestions from code review

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

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-124487: Require at least Windows 10 SDK and update install check (GH-124672)

gh-124642: Dictionaries aren't marking objects as weakref'd (#124643)

Dictionaries aren't marking objects as weakref'd

Doc: Run HTML and non-HTML daily builds separately (#124493)

gh-124722: Fix leak in `test_detach_materialized_dict_no_memory` (GH-124769)

gh-124400: Use the normal command path for breakpoint commands (#124401)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

gh-124720: Update "Using Python on a Mac" document (#124721)

Update "Using Python on a Mac" section of the "Python Setup and Usage"
document and include information on installing free-threading support.

gh-111495: Add tests for `PyCodec_*` C API (#123343)

gh-123961: Add a global state to _curses (#124729)

gh-123290: Fix decref in _curses update_lines_cols() (#124767)

functools: Give up on lazy-importing types (#124736)

PR #121089 added an eager import for types.MethodType, but
still left the existing hacks for lazily importing from types.

We could also create MethodType internally in functools.py (e.g.,
by using `type(Placeholder.__repr__)`, but it feels not worth it at
this point, so instead I unlazified all the usages of types in the
module.

Docs: improve generic `typing.NamedTuple` example (#124739)

gh-58573: Fix conflicts between abbreviated long options in the parent parser and subparsers in argparse (GH-124631)

Check for ambiguous options if the option is consumed, not when it is
parsed.

gh-116850: Fix argparse for namespaces with not directly writable dict (GH-124667)

It now always uses setattr() instead of setting the dict item to modify
the namespace. This allows to use a class as a namespace.