C API: Soft deprecate functions modifying str objects (PyUnicodeObject)

Python 3.14 added PyUnicodeWriter C API which is a safe way to create a Unicode object. IMO it's now time to soft deprecate the legacy way to create a str object using PyUnicode_New(): deprecate functions like PyUnicode_CopyCharacters() and PyUnicode_Resize().

The PyUnicode_New() API is more fragile. It's possible that a str object is "used" before it's fully initialized, which make following functions (modifying the str) fail or crash. It can also be exposed in Python by mistake before it's fully initialized.

PyUnicodeWriter has a different design than PyUnicode_New(): it's designed to append multiple strings, whereas PyUnicode_New() gives a direct access to an array of characters in a specific format (Py_UCS1, Py_UCS2 or Py_UCS4: 1, 2 or 4 bytes per character).

If PyUnicodeWriter doesn't fit well with existing code, it's possible to allocate an array of characters, write into this array, and then call PyUnicode_FromKindAndData() to create a str object.

Another option is to create a UTF-8 encode string and then call PyUnicode_FromString().

Linked PRs

• gh-157711
• gh-157712
• gh-157715

Revisa primero los PR vinculados gh-157711, gh-157712 y gh-157715; después, inspecciona los puntos de entrada de la C API PyUnicode_New(), PyUnicode_CopyCharacters() y PyUnicode_Resize(). Se considera terminado cuando se haya llegado a un acuerdo sobre qué funciones legacy reciben un tratamiento de soft-deprecation y se haya documentado o probado el comportamiento resultante de la API.