https://github.com/python/cpython/commit/94df62542cdf1c9eb082abab1534cbd1fd425062
commit: 94df62542cdf1c9eb082abab1534cbd1fd425062
branch: main
author: scoder <[email protected]>
committer: vstinner <[email protected]>
date: 2026-05-13T10:10:37Z
summary:
gh-148829: Add PySentinel_CheckExact() (#149725)
files:
A Misc/NEWS.d/next/C_API/2026-05-12-16-47-21.gh-issue-149725.HZLBTZ.rst
M Doc/c-api/sentinel.rst
M Include/cpython/sentinelobject.h
M Lib/test/test_capi/test_object.py
M Modules/_testcapi/object.c
diff --git a/Doc/c-api/sentinel.rst b/Doc/c-api/sentinel.rst
index 89e0a28bf3b835..937cae18e86f50 100644
--- a/Doc/c-api/sentinel.rst
+++ b/Doc/c-api/sentinel.rst
@@ -14,8 +14,20 @@ Sentinel objects
.. c:function:: int PySentinel_Check(PyObject *o)
- Return true if *o* is a :class:`sentinel` object. The :class:`sentinel`
type
- does not allow subclasses, so this check is exact.
+ Return true if *o* is a :class:`sentinel` object or a subtype.
+ The :class:`sentinel` type does not currently allow subclasses,
+ so this check is exact.
+ Future Python versions may choose to allow subtyping.
+ This function always succeeds.
+
+ .. versionadded:: 3.15
+
+.. c:function:: int PySentinel_CheckExact(PyObject *o)
+
+ Return true if *o* is a :class:`sentinel` object, but not a subtype.
+ The :class:`sentinel` type does not currently allow subclasses.
+ Future Python versions may choose to allow subtyping.
+ This function always succeeds.
.. versionadded:: 3.15
diff --git a/Include/cpython/sentinelobject.h b/Include/cpython/sentinelobject.h
index 0b6ff0f17e6f8c..8d5b1886ce5436 100644
--- a/Include/cpython/sentinelobject.h
+++ b/Include/cpython/sentinelobject.h
@@ -9,7 +9,10 @@ extern "C" {
PyAPI_DATA(PyTypeObject) PySentinel_Type;
-#define PySentinel_Check(op) Py_IS_TYPE((op), &PySentinel_Type)
+#define PySentinel_CheckExact(op) Py_IS_TYPE((op), &PySentinel_Type)
+
+/* Alias as long as subclasses are not allowed. */
+#define PySentinel_Check(op) PySentinel_CheckExact(op)
PyAPI_FUNC(PyObject *) PySentinel_New(
const char *name,
diff --git a/Lib/test/test_capi/test_object.py
b/Lib/test/test_capi/test_object.py
index 635deaa73f7efa..e6fd068dc20d8d 100644
--- a/Lib/test/test_capi/test_object.py
+++ b/Lib/test/test_capi/test_object.py
@@ -71,6 +71,8 @@ def test_pysentinel_new(self):
self.assertIs(type(marker), sentinel)
self.assertTrue(_testcapi.pysentinel_check(marker))
self.assertFalse(_testcapi.pysentinel_check(object()))
+ self.assertTrue(_testcapi.pysentinel_checkexact(marker))
+ self.assertFalse(_testcapi.pysentinel_checkexact(object()))
self.assertEqual(marker.__name__, "CAPI_SENTINEL")
self.assertEqual(marker.__module__, __name__)
self.assertEqual(repr(marker), "CAPI_SENTINEL")
diff --git
a/Misc/NEWS.d/next/C_API/2026-05-12-16-47-21.gh-issue-149725.HZLBTZ.rst
b/Misc/NEWS.d/next/C_API/2026-05-12-16-47-21.gh-issue-149725.HZLBTZ.rst
new file mode 100644
index 00000000000000..97721430edbd69
--- /dev/null
+++ b/Misc/NEWS.d/next/C_API/2026-05-12-16-47-21.gh-issue-149725.HZLBTZ.rst
@@ -0,0 +1,2 @@
+Add :c:func:`PySentinel_CheckExact` for exact :class:`sentinel` type tests
+to accompany the existing :c:func:`PySentinel_Check`.
diff --git a/Modules/_testcapi/object.c b/Modules/_testcapi/object.c
index 6e5c8dcbb725fa..c62dc1144df688 100644
--- a/Modules/_testcapi/object.c
+++ b/Modules/_testcapi/object.c
@@ -572,6 +572,12 @@ pysentinel_check(PyObject *self, PyObject *obj)
return PyBool_FromLong(PySentinel_Check(obj));
}
+static PyObject *
+pysentinel_checkexact(PyObject *self, PyObject *obj)
+{
+ return PyBool_FromLong(PySentinel_CheckExact(obj));
+}
+
static PyMethodDef test_methods[] = {
{"call_pyobject_print", call_pyobject_print, METH_VARARGS},
@@ -604,6 +610,7 @@ static PyMethodDef test_methods[] = {
{"pyobject_dump", pyobject_dump, METH_VARARGS},
{"pysentinel_new", pysentinel_new, METH_VARARGS},
{"pysentinel_check", pysentinel_check, METH_O},
+ {"pysentinel_checkexact", pysentinel_checkexact, METH_O},
{NULL},
};
_______________________________________________
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]
