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)

gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386)

gh-107091: Fix some uses of :func: role (GH-107378)

:c:func: or :c:macro: should be used instead.

gh-107089: Improve Shelf.clear method performance (gh-107090)

gh-106881: Check for linux/limits.h before including it (#107397)

* Check for linux/limits.h before including it

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-107307: Update the importlib Docs for PEP 684 (gh-107400)

gh-105699: Use a _Py_hashtable_t for the PyModuleDef Cache (gh-106974)

This fixes a crasher due to a race condition, triggered infrequently when two isolated (own GIL) subinterpreters simultaneously initialize their sys or builtins modules.  The crash happened due the combination of the "detached" thread state we were using and the "last holder" logic we use for the GIL.  It turns out it's tricky to use the same thread state for different threads.  Who could have guessed?

We solve the problem by eliminating the one object we were still sharing between interpreters.  We replace it with a low-level hashtable, using the "raw" allocator to avoid tying it to the main interpreter.

We also remove the accommodations for "detached" thread states, which were a dubious idea to start with.

gh-104050: Argument clinic: complete type annotations (#107399)

gh-107305: Update the C-API Docs for PEP 684 (gh-107324)