gh-109599: Add types.CapsuleType

Doc/library/types.rst

@@ -472,6 +472,12 @@ Standard names are defined for the following types:
 
       .. versionadded:: 3.12
 
+.. class:: CapsuleType
+
+   The type of :ref:`capsule objects<capsules>`.
+
+   .. versionadded:: 3.13
+
 
 Additional Utility Classes and Functions
 ----------------------------------------

Lib/test/test_sys.py

@@ -1,5 +1,6 @@
 import builtins
 import codecs
+import _datetime
 import gc
 import locale
 import operator
@@ -1581,7 +1582,7 @@ def delx(self): del self.__x
             x = property(getx, setx, delx, "")
             check(x, size('5Pi'))
         # PyCapsule
-        # XXX
+        check(_datetime.datetime_CAPI, size('6P'))
         # rangeiterator
         check(iter(range(1)), size('3l'))
         check(iter(range(2**65)), size('3P'))

Lib/test/test_types.py

@@ -4,6 +4,7 @@
 import collections.abc
 from collections import namedtuple
 import copy
+import _datetime
 import gc
 import inspect
 import pickle
@@ -636,6 +637,9 @@ def test_traceback_and_frame_types(self):
         self.assertIsInstance(exc.__traceback__, types.TracebackType)
         self.assertIsInstance(exc.__traceback__.tb_frame, types.FrameType)
 
+    def test_capsule_type(self):
+        self.assertIsInstance(_datetime.datetime_CAPI, types.CapsuleType)
+
 
 class UnionTests(unittest.TestCase):
 

Lib/types.py

@@ -1,6 +1,8 @@
 """
 Define names for built-in types that aren't directly accessible as a builtin.
 """
+
+import _socket
 import sys
 
 # Iterators in Python aren't a matter of type but of protocol.  A large
@@ -330,4 +332,6 @@ def wrapped(*args, **kwargs):
 NoneType = type(None)
 NotImplementedType = type(NotImplemented)
 
+CapsuleType = type(_socket.CAPI)
+
 __all__ = [n for n in globals() if n[:1] != '_']