Deprecate and Then Remove PyGILState_GetThisThreadState()

Feature or enhancement

Proposal:

(See https://docs.python.org/3/c-api/init.html#c.PyGILState_GetThisThreadState.)

PyGILState_GetThisThreadState() was added as part of the PEP 311 implementation. However, it wasn't part of that proposal. It isn't clear that it was even meant to be public API.

If a user wants to know what the current thread state is then they should use PyThreadState_Get(). PyGILState_GetThisThreadState() is subtly different and surfaces some of the tricky PyGILState corner cases that PyThreadState_Get() blissfully ignores. A real issue here is that users are reasonably likely to stumble across PyGILState_GetThisThreadState() and, due to the name, use it instead of the proper API.

I can think of one thing that PyGILState_GetThisThreadState() does exclusively: it will tell you what existing thread state PyGILState_Ensure() will use, if any. It isn't clear to me if that's a meaningful use case.

Ultimately, I expect we would be fine to get rid of PyGILState_GetThisThreadState(). If still useful for core development, it could be moved to the internal C-API.

Has this already been discussed elsewhere?

No response given

Links to previous discussion of this feature:

No response

Bắt đầu với mục trong tài liệu C-API cho PyGILState_GetThisThreadState() và so sánh hành vi được nêu với PyThreadState_Get(). Xác định phạm vi đã thống nhất của việc ngừng sử dụng và loại bỏ, bao gồm cả việc có cần giữ lại bất kỳ cách sử dụng C-API nội bộ nào hay không; công việc được coi là hoàn tất khi có kế hoạch được maintainer phê duyệt cùng với các thay đổi tương ứng trong tài liệu và phần triển khai.