_ctypes: add stubs (#8582)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: hauntsaninja <hauntsaninja@gmail.com>

Author: junkmd

stdlib/VERSIONS

@@ -27,6 +27,7 @@ _collections_abc: 3.3-
 _compat_pickle: 3.1-
 _compression: 3.5-
 _csv: 2.7-
+_ctypes: 2.7-
 _curses: 2.7-
 _decimal: 3.3-
 _dummy_thread: 3.0-3.8

stdlib/_ctypes.pyi

@@ -0,0 +1,16 @@
+import sys
+from ctypes import _CArgObject, _PointerLike
+from typing_extensions import TypeAlias
+
+if sys.platform == "win32":
+    # Description, Source, HelpFile, HelpContext, scode
+    _COMError_Details: TypeAlias = tuple[str | None, str | None, str | None, int | None, int | None]
+
+    class COMError(Exception):
+        hresult: int
+        text: str | None
+        details: _COMError_Details
+
+        def __init__(self, hresult: int, text: str | None, details: _COMError_Details) -> None: ...
+
+    def CopyComPointer(src: _PointerLike, dst: _PointerLike | _CArgObject) -> int: ...

tests/stubtest_allowlists/darwin.txt

@@ -26,6 +26,10 @@ selectors.DefaultSelector.fileno
 socket.PF_SYSTEM
 socket.SYSPROTO_CONTROL
 
+_ctypes.dlclose
+_ctypes.dlopen
+_ctypes.dlsym
+
 posix.NGROUPS_MAX
 posix.error.characters_written
 resource.error.characters_written

tests/stubtest_allowlists/linux.txt

@@ -23,6 +23,10 @@ selectors.DefaultSelector.fileno
 spwd.struct_spwd.sp_nam
 spwd.struct_spwd.sp_pwd
 
+_ctypes.dlclose
+_ctypes.dlopen
+_ctypes.dlsym
+
 # ==========
 # Allowlist entries that cannot or should not be fixed
 # ==========

tests/stubtest_allowlists/py311.txt

@@ -12,6 +12,7 @@ _collections_abc.MappingView.__class_getitem__
 _collections_abc.ValuesView.__reversed__
 _csv.Reader
 _csv.Writer
+_ctypes.CTYPES_MAX_ARGCOUNT
 _operator.attrgetter.__vectorcalloffset__
 _operator.itemgetter.__vectorcalloffset__
 argparse._MutuallyExclusiveGroup.add_mutually_exclusive_group

tests/stubtest_allowlists/py3_common.txt

@@ -339,6 +339,32 @@ turtle.ScrolledCanvas.onResize
 wave.Wave_read.initfp
 wave.Wave_write.initfp
 
+_ctypes.Array
+_ctypes.CFuncPtr
+_ctypes.FUNCFLAG_CDECL
+_ctypes.FUNCFLAG_PYTHONAPI
+_ctypes.FUNCFLAG_USE_ERRNO
+_ctypes.FUNCFLAG_USE_LASTERROR
+_ctypes.POINTER
+_ctypes.PyObj_FromPtr
+_ctypes.Py_DECREF
+_ctypes.Py_INCREF
+_ctypes.RTLD_GLOBAL
+_ctypes.RTLD_LOCAL
+_ctypes.Structure
+_ctypes.Union
+_ctypes.addressof
+_ctypes.alignment
+_ctypes.buffer_info
+_ctypes.byref
+_ctypes.call_cdeclfunction
+_ctypes.call_function
+_ctypes.get_errno
+_ctypes.pointer
+_ctypes.resize
+_ctypes.set_errno
+_ctypes.sizeof
+
 # ==========
 # Allowlist entries that cannot or should not be fixed
 # ==========

tests/stubtest_allowlists/win32.txt

@@ -26,6 +26,13 @@ ssl.SSLSocket.recvmsg
 ssl.SSLSocket.recvmsg_into
 ssl.SSLSocket.sendmsg
 winreg.HKEYType.handle
+_ctypes.FUNCFLAG_HRESULT
+_ctypes.FUNCFLAG_STDCALL
+_ctypes.FormatError
+_ctypes.FreeLibrary
+_ctypes.LoadLibrary
+_ctypes.get_last_error
+_ctypes.set_last_error
 
 
 # ==========