gh-107630: Initialize Each Interpreter's refchain Properly (gh-107733)

This finishes fixing the crashes in Py_TRACE_REFS builds.  We missed this part in gh-107567.

gh-107178: Add the C API tests for the Abstract Objects Layer (GH-107179)

Cover all the Mapping Protocol, almost all the Sequence Protocol
(except PySequence_Fast) and a part of the Object Protocol.

Move existing tests to Lib/test/test_capi/test_abstract.py and
Modules/_testcapi/abstract.c.

Add also tests for PyDict C API.

gh-107715: Escape class name in regular expression (GH-107716)

This patch escapes the class name before embedding it in the regular expression
for `pat` in `doctest.DocTestFinder._find_lineno`. While class names do not
ordinarily contain special characters, it is possible to encounter these when a
class is created dynamically. Escaping the name will correctly return `None` in
this scenario, rather than potentially matching a different class or raising
`re.error` depending on the symbols used.

gh-106566: Optimize (?!) in regular expressions (GH-106567)

gh-100814: Fix exception for invalid callable value of Tkinter image option (GH-107692)

Passing a callable object as an option value to a Tkinter image now raises
the expected TclError instead of an AttributeError.

gh-95065: Argument Clinic: Pretty-print long C strings in generated code (#107712)

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

gh-107710: Speed up `logging.getHandlerNames` function (#107711)

gh-107713: Reduce usage of mocks in `test_clinic.py` (#107714)

Docs: Fix more Sphinx annotations in ctypes.rst (#107708)

gh-85160: Reduce memory usage of `singledispatchmethod` (#107706)

A small followup to #107148

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

gh-95065: Add Argument Clinic support for deprecating positional use of parameters (#95151)

It is now possible to deprecate passing parameters positionally with
Argument Clinic, using the new '* [from X.Y]' syntax.
(To be read as "keyword-only from Python version X.Y")

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

gh-104496: Use correct Tcl or Tk version in Tkinter tests (GH-107688)

In future Tcl and Tk versions can be desynchronized.

gh-107442: Document all valid types for ctypes _as_parameter_ (#107443)

Docs: Argument Clinic: Move the CConverter class to the reference (#107671)

Improve cross-references in `runpy` docs (#107673)

- Add links to `__main__` and `sys.path` where appropriate
- Ensure each paragraph never has more than one link to the same thing, to avoid visual clutter from too many links

gh-106368: Improve coverage reports for argument clinic (#107693)

Do not use deprecated ``logger.warn()`` in pyspecific (#107694)

gh-85160: improve performance of `functools.singledispatchmethod` (#107148)

Co-authored-by: mental <m3nta1@yahoo.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Docs: skip python-docs-theme 2023.7 to fix mobile menu (#107666)

Docs: Fix Sphinx annotations in Doc/library/ctypes.rst (#107672)

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

GH-84435: Make pyspecific directives translatable (#19470)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>

gh-104683: Improve consistency and test coverage of argument-clinic `__repr__` functions (#107667)

Docs: Argument Clinic: Improve 'How to write a custom converter' (#107328)

- Omit unneccesary wording and sentences
- Don't mention implementation details (no digression, explanation)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-107662: Switch 'any' and 'anext' in functions.rst (#107663)

Order was reversed in index at top, not in body.

GH-106684: raise `ResourceWarning` when `asyncio.StreamWriter` is not closed (#107650)

gh-107432 Fix incorrect indentation in annotations HOWTO (#107445)

gh-107432 Fix incorrect indentation in annotations document

Body text in https://docs.python.org/3/howto/annotations.html was
indented throughout, and was being rendered in blockquote elements.

gh-106812: Fix two tiny bugs in analysis.py (#107649)

This fixes two tiny defects in analysis.py that I didn't catch on time in #107564:

- `get_var_names` in `check_macro_consistency` should skip `UNUSED` names.
- Fix an occurrence of `is UNUSED` (should be `==`).

gh-106608: make uop trace variable length (#107531)

Executors are now more like tuples.

GH-84436: Skip refcounting for known immortals (GH-107605)

GH-70303: Emit FutureWarning when pathlib glob pattern ends with `**` (GH-105413)

In a future Python release, patterns with this ending will match both files
and directories. Users may add a trailing slash to remove the warning.

gh-106368: Argument clinic: improve coverage for `self.valid_line()` calls (#107641)

Docs: Only include Plausible for html, not for epub etc (#107637)

Only include Plausible for html, not for epub etc

gh-104683: Argument Clinic: Use CConverter.length_name where possible (#107638)

Also make it a cached property.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-106812: Refactor cases_generator to allow uops with array stack effects (#107564)

Introducing a new file, stacking.py, that takes over several responsibilities related to symbolic evaluation of push/pop operations, with more generality.

gh-104146: Argument clinic: remove dead code highlighted by the `vulture` tool (#107632)

gh-107600: Docs: Update ctypes.ArgumentError error message (#107601)

Docs: upgrade to python-docs-theme 2023.7 (#107617)

gh-104146: Argument clinic: Remove dead code flagged by mypy's `truthy-bool` check (#107627)

gh-107614: Normalise Argument Clinic error messages (#107615)

- always wrap the offending line, token, or name in quotes
- in most cases, put the entire error message on one line

Added tests for uncovered branches that were touched by this PR.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Add some GC stats to Py_STATS (GH-107581)

GH-107263: Increase C stack limit for most functions, except `_PyEval_EvalFrameDefault()` (GH-107535)

* Set C recursion limit to 1500, set cost of eval loop to 2 frames, and compiler mutliply to 2.

gh-106368: Increase Argument Clinic test coverage (#107611)

Add tests for directives and destinations

gh-107609: Fix duplicate module check in Argument Clinic (#107610)

Also remove duplicate module def from _testcapi.

GH-105481: Mark more files as generated (GH-107598)

gh-104146: Argument clinic: remove unused methods and variables (#107608)

gh-106368: Argument clinic tests: improve error message when `expect_success()` fails (#107606)

gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567)

The linked list of objects was a global variable, which broke isolation between interpreters, causing crashes. To solve this, we've moved the linked list to each interpreter.

gh-107446: Fix test_inspect.test_class_with_method_from_other_module when ran multiple times (#107451)

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

gh-107576: Ensure `__orig_bases__` are our own in `get_original_bases` (#107584)

Co-authored-by: Chris Bouchard <chris@upliftinglemma.net>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-107077: Raise SSLCertVerificationError even if the error is set via SSL_ERROR_SYSCALL (#107586)

Co-authored-by: T. Wouters <thomas@python.org>

gh-106368: Increase Argument Clinic test coverage (#107582)

Add tests for DSL parser state machine and docstring formatting

GH-107458: fix test_tools refleak (#107577)

gh-107455: ctypes: Improve error messages when converting to an incompatible type (#107456)

gh-104683: Rework Argument Clinic error handling (#107551)

Introduce ClinicError, and use it in fail(). The CLI runs main(),
catches ClinicError, formats the error message, prints to stderr
and exits with an error.

As a side effect, this refactor greatly improves the accuracy of
reported line numbers in case of error.

Also, adapt the test suite to work with ClinicError.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-107471: Fix Refleaks in test_import (gh-107569)

gh-107184 introduced a refleak in test_import.SubinterpImportTests (specifically test_singlephase_check_with_setting_and_override and test_single_init_extension_compat).  We fix it here by making sure _testsinglephase is removed from sys.modules whenever we clear the runtime's internal state for the module.

The underlying problem is strictly contained in the internal function _PyImport_ClearExtension() (AKA _testinternalcapi.clear_extension()), which is only used in tests.

(This also fixes an intermittent segfault introduced in the same place, in test_disallowed_reimport.)

gh-104683: Make Argument Clinic template strings class level members (#107556)

The motivation for this change is to clean up the output_templates()
method a little bit, as it accounts for ~10% of the lines of code in
clinic.py; removing some clutter helps readability.

Fix test_capi.test_misc when run with -R:: (#107566)

Should fix the buildbot failures.

This creates a new function each time that test is run, like Victor did for other tests.

GH-100964: Break cycles involving exception state when returning from generator (GH-107563)

gh-105481: simplify definition of pseudo ops in Lib/opcode.py (#107561)

gh-106368: Increase test coverage for Argument Clinic (#107514)

As per this commit, we've got approx. ~91% test coverage for clinic.py.

gh-107559: Argument Clinic: complain about non-ASCII chars in param docstrings (#107560)

Previously, only function docstrings were checked for non-ASCII characters.
Also, improve the warn() message.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-104146: Remove dead code from Argument Clinic (#107555)

gh-104683: Argument Clinic: Refactor and simplify 'add docstring' states (#107550)

Introduce docstring_append() helper, and use it for both parameter and
function docstrings. Remove docstring fixup from
do_post_block_processing_cleanup(); instead, make sure no fixup is needed.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-104683: Argument clinic: cleanup `DLSParser` `state_foo` methods (#107543)

Clarify `Self` interaction with subclasses (#107511)

gh-104683: Argument clinic: remove the `LandMine` class (#107541)

gh-105481: combine regen-opcode-targets with regen-opcode to avoid calculating the specialized opcodes in two places (#107540)

gh-105481: the ENABLE_SPECIALIZATION flag does not need to be generated by the build script, or exposed in opcode.py (#107534)

gh-107467: Restructure Argument Clinic command-line interface (#107469)

- Use ArgumentParser.error() to handle CLI errors
- Put the entire CLI in main()
- Rework ClinicExternalTest to call main() instead of using subprocesses

Co-authored-by: AlexWaygood <alex.waygood@gmail.com>

gh-106092: Fix use-after-free crash in frame_dealloc (#106875)

It was possible for the trashcan to delay the deallocation of a
PyFrameObject until after its corresponding _PyInterpreterFrame has
already been freed.  So frame_dealloc needs to avoid dereferencing the
f_frame pointer unless it first checks that the pointer still points
to the interpreter frame within the frame object.

Signed-off-by: Anders Kaseorg <andersk@mit.edu>

Remove newlines from bug template (#107525)

gh-89013: Improve the performance of methodcaller (lazy version) (gh-107201)

gh-99113: Add a What's New Entry for PEP 684 (gh-107520)

gh-105766: Document that Custom Allocators Must Be Thread-Safe (gh-107519)

gh-107306: Add a Doc Entry for Py_mod_multiple_interpreters (#107403)

It was added in 3.12 for PEP 684 (per-interpreter GIL).

gh-107507: Replace 'The goals of Argument Clinic' with a summary (#107508)

Summarise the goals of Argument Clinic in a single sentence.
Mention that Argument Clinic was introduced with PEP-436.

Use tstate->interp to get the interpreter state in bytecodes.c (GH-107506)

GH-104584: Fix incorrect uoperands (GH-107513)

gh-106762: Add news for `EnumMeta.__getattr__` removal (GH-107466)

GH-104909: Move unused cache entries from uops to macros (#107444)

There's no need to use a dummy uop to skip unused cache entries. The macro syntax lets you write `unused/1` instead.

Similarly, move `unused/5` from op `_LOAD_ATTR_INSTANCE_VALUE` to macro `LOAD_ATTR_INSTANCE_VALUE`.

gh-105578: Document that `AnyStr` is deprecated in py313 (#107116)

It will not be removed until Python 3.18.

gh-105578: Add more usage examples to `typing.AnyStr` docs (#107045)

``typing.AnyStr`` has different semantics to ``str | bytes``, which often leads to user confusion

gh-87799: Improve the textual representation of IPv4-mapped IPv6 addresses (#29345)

Represent IPv4-mapped IPv6 address as x:x:x:x:x:x:d.d.d.d,
where the 'x's are the hexadecimal values
of the six high-order 16-bit pieces of the address,
and the 'd's are the decimal values
of the four low-order 8-bit pieces of the address
(standard IPv4 representation).

---------

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

gh-105751: Remove obsolete `object` base class in some ctypes tests (#107460)

no-issue: Fix typo in import.c (gh-107498)

gh-106368: Add test for Argument Clinic misbehaving custom converter_init() (#107496)

gh-104280: Add test cases for DTrace probes (#107125)

gh-46376: Return existing pointer when possible in ctypes (#107131)

Update macOS installer screens to 3.13. (GH-107475)

gh-99079: Update macOS installer to use OpenSSL 3.0.9. (GH-107474)

gh-107427: Update the description of UNPACK_SEQUENCE (gh-107429)

gh-106263: Fix segfault in `signaldict_repr`  in `_decimal` module (#106270)

Co-authored-by: sunmy2019 <59365878+sunmy2019@users.noreply.github.com>

gh-104683: Argument clinic: pass `clinic` as a parameter where possible (#107435)

gh-104683: Argument clinic: Make the `filename` parameter to `Clinic` required (#107439)

add Kumar Aditya as CODEOWNER for import.c (#107441)

Fix the documentation for PyCode_New add `qualname` parameter (#107186)

gh-107422: Remove outdated `TypedDict` example from typing docs (#107436)

Improve the GitHub issue templates (#107150)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-104050: Argument clinic: enable mypy's `--warn-return-any` setting (#107405)

gh-107369: optimize textwrap.indent() (#107374)