C API: Add PyUnicodeWriter_WriteRawStr() function

Feature or enhancement

Python 3.14 added PyUnicodeWriter_WriteStr() function. In general, writing str(obj) is fine. But there is one exception: writing a str subclass should not call str(obj), otherwise the output can be surprising if the subclass overrides __str__().

The _json and _io were impacted by the str subclass issue. They have been fixed by using the internal C API (_PyUnicodeWriter_WriteStr()). Problem: the internal C API is not usable outside CPython.

The PyUnicodeWriter_WriteStr() documentation has been modified to document a workaround for str subclasses:

To write a str subclass which overrides the __str__() method, PyUnicode_FromObject() can be used to get the original string.

Instead of the workaround, I propose adding a PyUnicodeWriter_WriteRawStr() function which handles str subclasses as expected (read the string content, don't use the __str__() method).

Linked PRs

• gh-150974

Trước tiên, hãy xem xét PR được liên kết gh-150974, sau đó đọc tài liệu hiện có về PyUnicodeWriter_WriteStr và các tham chiếu trong _json và _io đến _PyUnicodeWriter_WriteStr. Công việc được xem là hoàn tất khi một API công khai PyUnicodeWriter_WriteRawStr() xử lý các lớp con của str mà không gọi str(), và hành vi được ghi lại trong tài liệu có thể sử dụng bên ngoài phần nội bộ của CPython.