move byref-related definitions from ctypes/__init__.pyi to _ctypes.pyi (#10137)

stdlib/_ctypes.pyi

@@ -2,7 +2,7 @@ import sys
 from _typeshed import ReadableBuffer, WriteableBuffer
 from abc import abstractmethod
 from collections.abc import Iterable, Iterator, Mapping, Sequence
-from ctypes import CDLL, _CArgObject
+from ctypes import CDLL
 from typing import Any, Generic, TypeVar, overload
 from typing_extensions import Self, TypeAlias
 
@@ -89,6 +89,10 @@ class _Pointer(Generic[_CT], _PointerLike, _CData):
 def POINTER(type: type[_CT]) -> type[_Pointer[_CT]]: ...
 def pointer(__arg: _CT) -> _Pointer[_CT]: ...
 
+class _CArgObject: ...
+
+def byref(obj: _CData, offset: int = ...) -> _CArgObject: ...
+
 class _CField:
     offset: int
     size: int

stdlib/ctypes/__init__.pyi

@@ -8,6 +8,7 @@ from _ctypes import (
     Structure as Structure,
     Union as Union,
     _CanCastTo as _CanCastTo,
+    _CArgObject as _CArgObject,
     _CData as _CData,
     _CDataMeta as _CDataMeta,
     _CField as _CField,
@@ -18,6 +19,7 @@ from _ctypes import (
     _StructUnionMeta as _StructUnionMeta,
     addressof as addressof,
     alignment as alignment,
+    byref as byref,
     get_errno as get_errno,
     pointer as pointer,
     resize as resize,
@@ -120,8 +122,6 @@ if sys.platform == "win32":
 
 def PYFUNCTYPE(restype: type[_CData] | None, *argtypes: type[_CData]) -> type[_FuncPointer]: ...
 
-class _CArgObject: ...
-
 # Any type that can be implicitly converted to c_void_p when passed as a C function argument.
 # (bytes is not included here, see below.)
 _CVoidPLike: TypeAlias = _PointerLike | Array[Any] | _CArgObject | int
@@ -131,8 +131,6 @@ _CVoidPLike: TypeAlias = _PointerLike | Array[Any] | _CArgObject | int
 # when memmove(buf, b'foo', 4) was intended.
 _CVoidConstPLike: TypeAlias = _CVoidPLike | bytes
 
-def byref(obj: _CData, offset: int = ...) -> _CArgObject: ...
-
 _CastT = TypeVar("_CastT", bound=_CanCastTo)
 
 def cast(obj: _CData | _CArgObject | int, typ: type[_CastT]) -> _CastT: ...

tests/stubtest_allowlists/py3_common.txt

@@ -339,7 +339,6 @@ _ctypes.PyObj_FromPtr
 _ctypes.Py_DECREF
 _ctypes.Py_INCREF
 _ctypes.buffer_info
-_ctypes.byref
 _ctypes.call_cdeclfunction
 _ctypes.call_function