Feature or enhancement

The free-threaded builds need a variant ofPyList_GetItem that returns a strong reference instead of a borrowed reference for thread-safety reasons. PEP 703 proposedPyList_FetchItem, but since thenPyDict_GetItemRef and functions with similar signatures have been added.

This proposesPyList_GetItemRef with the following signature:

PyObject *PyList_GetItemRef(PyObject *list, Py_ssize_t index)

Return astrong reference to the object at position index in the list pointed to by list. Ifindex is out of bounds (<0 or >=len(list)), return NULL and set an IndexError. Iflist is not a list instance, return NULL and set a TypeError.

Linked PRs

• gh-114329: AddPyList_GetItemRef function #114504
• gh-114329: Fix PyList_GetItemRef() limited C API definition #117520