https://github.com/python/cpython/commit/1907e13f92f469ba2f815ba311a348b294ad0d46
commit: 1907e13f92f469ba2f815ba311a348b294ad0d46
branch: 3.14
author: Miss Islington (bot) <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2026-10-19T19:27:00Z
summary:

[3.14] gh-114150: Clarify that `ctypes.PYFUNCTYPE` can release the GIL during 
the call (GH-114151) (GH-159735)

(cherry picked from commit d42178a811d05c0ad3623034a12ff018a07e7ec7)

Co-authored-by: arrmansa <[email protected]>
Co-authored-by: Peter Bierma <[email protected]>

files:
M Doc/library/ctypes.rst

diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst
index fb74e7f3ee3719..f0a934b15ceb2a 100644
--- a/Doc/library/ctypes.rst
+++ b/Doc/library/ctypes.rst
@@ -1968,7 +1968,11 @@ See :ref:`ctypes-callback-functions` for examples.
 .. function:: PYFUNCTYPE(restype, *argtypes)
 
    The returned function prototype creates functions that use the Python 
calling
-   convention.  The function will *not* release the GIL during the call.
+   convention.  Unlike :func:`CFUNCTYPE` and :func:`WINFUNCTYPE`, ctypes does
+   *not* release the GIL before calling the foreign function, so the function
+   may safely use the Python C API. Note that this does not prevent the GIL
+   from being released *during* the call.
+
 
 Function prototypes created by these factory functions can be instantiated in
 different ways, depending on the type and number of the parameters in the call:

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to