gh-111489: Add PyTuple_FromArray() function

[vstinner]

• Issue: [C API] Make _PyTuple_FromArray() function public #111489

---

📚 Documentation preview 📚: https://cpython-previews--139691.org.readthedocs.build/

[vstinner]

cc @serhiy-storchaka @encukou

[vstinner]

@serhiy-storchaka: I addressed your comments. Please review the updated PR.

[serhiy-storchaka]

Is not the empty tuple singleton a CPython implementation detail?

[vstinner]

The whole file is a CPython implementation detail (_testcapi), no?

[vstinner]

I updated the PR for the latest review.

[serhiy-storchaka]

LGTM. 👍

[serhiy-storchaka]

I would prefer to formulate this in words more similar to PyTuple_New() or PyTuple_Pack() ("Return a new tuple object of size ... "), but this is not so important.

[encukou]

Implementation looks good, thanks! Do you want to open a WG vote for this?

[vstinner]

Do you want to open a WG vote for this?

I created capi-workgroup/decisions#79.

[vstinner]

I exchanged array and size parameters, new API:

PyObject* PyTuple_FromArray(Py_ssize_t size, PyObject *const *array)

[vstinner]

I exchanged array and size parameters, new API: (...)

Sorry, I changed my preference back to (array, size) as before :-) See the API discussion at: capi-workgroup/decisions#79

[vstinner]

I created capi-workgroup/decisions#79.

The C API Working Group accepted this API.

[vstinner]

Merged. Thanks for your review @serhiy-storchaka and @encukou!

[vstinner]

I added the function to pythoncapi-compat: python/pythoncapi-compat@89e023e