From cbeb693133f5daaeb2f680710eab7ca6ca5be11c Mon Sep 17 00:00:00 2001 From: Petr Viktorin Date: Wed, 1 Oct 2025 06:16:06 +0200 Subject: [PATCH] Document that `PyInterpreterState_GetDict` returns a borrowed reference (GH-139451) (cherry picked from commit 80cdf3ef74f6622899c1c82af1e08492e4ab7a00) Co-authored-by: Petr Viktorin --- Doc/c-api/init.rst | 3 +++ Doc/data/refcounts.dat | 3 +++ 2 files changed, 6 insertions(+) diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst index 6a272a4f5fcb87..416bece23bcbb4 100644 --- a/Doc/c-api/init.rst +++ b/Doc/c-api/init.rst @@ -1547,6 +1547,9 @@ All of the following functions must be called after :c:func:`Py_Initialize`. This is not a replacement for :c:func:`PyModule_GetState()`, which extensions should use to store interpreter-specific state information. + The returned dictionary is borrowed from the interpreter and is valid until + interpreter shutdown. + .. versionadded:: 3.8 diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat index a6f1fc4e937c94..1cc1b44a5b8e3a 100644 --- a/Doc/data/refcounts.dat +++ b/Doc/data/refcounts.dat @@ -1144,6 +1144,9 @@ PyInterpreterState_Clear:PyInterpreterState*:interp:: PyInterpreterState_Delete:void::: PyInterpreterState_Delete:PyInterpreterState*:interp:: +PyInterpreterState_GetDict:PyObject*::0: +PyInterpreterState_GetDict:PyInterpreterState*:interp:: + PyInterpreterState_GetID:int64_t::: PyInterpreterState_GetID:PyInterpreterState*:interp::