pywin32: Use PEP 570 positional-only argument syntax and fix arguments (#11321)

Author: Avasam

stubs/pywin32/@tests/stubtest_allowlist_win32.txt

@@ -72,3 +72,6 @@ win32com.axdebug.gateways
 win32comext.axdebug.gateways
 # failed to import, ModuleNotFoundError: No module named 'win32comext.axdebug.axdebug'
 win32comext.axdebug.axdebug
+
+# Stubtest doesn't agree with win32.lib.pywintypes.error.__init__ being positional-only
+.+?\.error.__init__

stubs/pywin32/_win32typing.pyi

@@ -11,103 +11,105 @@ error: TypeAlias = com_error  # noqa: Y042
 
 class internal_error(Exception): ...
 
-def CoCreateFreeThreadedMarshaler(unk: _win32typing.PyIUnknown) -> _win32typing.PyIUnknown: ...
+def CoCreateFreeThreadedMarshaler(unk: _win32typing.PyIUnknown, /) -> _win32typing.PyIUnknown: ...
 def CoCreateInstanceEx(
     clsid: _win32typing.PyIID,
     unkOuter: _win32typing.PyIUnknown,
     context,
     serverInfo: tuple[Incomplete, Incomplete, Incomplete, Incomplete],
     iids: list[_win32typing.PyIID],
+    /,
 ) -> _win32typing.PyIUnknown: ...
 def CoCreateInstance(
-    __clsid: _win32typing.PyIID, __unkOuter: _win32typing.PyIUnknown | None, __context: int, __iid: _win32typing.PyIID
+    clsid: _win32typing.PyIID, unkOuter: _win32typing.PyIUnknown | None, context: int, iid: _win32typing.PyIID, /
 ) -> _win32typing.PyIUnknown: ...
 def CoFreeUnusedLibraries() -> None: ...
 def CoInitialize() -> None: ...
-def CoInitializeEx(flags) -> None: ...
+def CoInitializeEx(flags, /) -> None: ...
 def CoInitializeSecurity(
-    sd: _win32typing.PySECURITY_DESCRIPTOR, authSvc, reserved1, authnLevel, impLevel, authInfo, capabilities, reserved2
+    sd: _win32typing.PySECURITY_DESCRIPTOR, authSvc, reserved1, authnLevel, impLevel, authInfo, capabilities, reserved2, /
 ) -> None: ...
-def CoGetInterfaceAndReleaseStream(stream: _win32typing.PyIStream, iid: _win32typing.PyIID) -> _win32typing.PyIUnknown: ...
-def CoMarshalInterThreadInterfaceInStream(iid: _win32typing.PyIID, unk: _win32typing.PyIUnknown) -> _win32typing.PyIStream: ...
+def CoGetInterfaceAndReleaseStream(stream: _win32typing.PyIStream, iid: _win32typing.PyIID, /) -> _win32typing.PyIUnknown: ...
+def CoMarshalInterThreadInterfaceInStream(iid: _win32typing.PyIID, unk: _win32typing.PyIUnknown, /) -> _win32typing.PyIStream: ...
 def CoMarshalInterface(
-    Stm: _win32typing.PyIStream, riid: _win32typing.PyIID, Unk: _win32typing.PyIUnknown, DestContext, flags
+    Stm: _win32typing.PyIStream, riid: _win32typing.PyIID, Unk: _win32typing.PyIUnknown, DestContext, flags, /
 ) -> None: ...
-def CoUnmarshalInterface(Stm: _win32typing.PyIStream, riid: _win32typing.PyIID): ...
-def CoReleaseMarshalData(Stm: _win32typing.PyIStream) -> None: ...
-def CoGetObject(name: str, iid: _win32typing.PyIID, bindOpts: Incomplete | None = ...) -> _win32typing.PyIUnknown: ...
+def CoUnmarshalInterface(Stm: _win32typing.PyIStream, riid: _win32typing.PyIID, /): ...
+def CoReleaseMarshalData(Stm: _win32typing.PyIStream, /) -> None: ...
+def CoGetObject(name: str, iid: _win32typing.PyIID, bindOpts: Incomplete | None = ..., /) -> _win32typing.PyIUnknown: ...
 def CoUninitialize() -> None: ...
-def CoRegisterClassObject(iid: _win32typing.PyIID, factory: _win32typing.PyIUnknown, context, flags): ...
+def CoRegisterClassObject(iid: _win32typing.PyIID, factory: _win32typing.PyIUnknown, context, flags, /): ...
 def CoResumeClassObjects() -> None: ...
-def CoRevokeClassObject(reg) -> None: ...
-def CoTreatAsClass(clsidold: _win32typing.PyIID, clsidnew: _win32typing.PyIID) -> None: ...
-def CoWaitForMultipleHandles(Flags, Timeout, Handles: list[int]): ...
-def Connect(cls) -> _win32typing.PyIDispatch: ...
+def CoRevokeClassObject(reg, /) -> None: ...
+def CoTreatAsClass(clsidold: _win32typing.PyIID, clsidnew: _win32typing.PyIID, /) -> None: ...
+def CoWaitForMultipleHandles(Flags, Timeout, Handles: list[int], /): ...
+def Connect(cls, /) -> _win32typing.PyIDispatch: ...
 def CreateGuid() -> _win32typing.PyIID: ...
 def CreateBindCtx() -> _win32typing.PyIBindCtx: ...
-def CreateFileMoniker(filename: str) -> _win32typing.PyIMoniker: ...
-def CreateItemMoniker(delim: str, item: str) -> _win32typing.PyIMoniker: ...
-def CreatePointerMoniker(IUnknown: _win32typing.PyIUnknown) -> _win32typing.PyIMoniker: ...
+def CreateFileMoniker(filename: str, /) -> _win32typing.PyIMoniker: ...
+def CreateItemMoniker(delim: str, item: str, /) -> _win32typing.PyIMoniker: ...
+def CreatePointerMoniker(IUnknown: _win32typing.PyIUnknown, /) -> _win32typing.PyIMoniker: ...
 def CreateTypeLib(): ...
 def CreateTypeLib2(): ...
-def CreateStreamOnHGlobal(hGlobal: int | None = ..., DeleteOnRelease: bool = ...) -> _win32typing.PyIStream: ...
-def CreateILockBytesOnHGlobal(hGlobal: int | None = ..., DeleteOnRelease: bool = ...) -> _win32typing.PyILockBytes: ...
-def EnableQuitMessage(threadId) -> None: ...
+def CreateStreamOnHGlobal(hGlobal: int | None = ..., DeleteOnRelease: bool = ..., /) -> _win32typing.PyIStream: ...
+def CreateILockBytesOnHGlobal(hGlobal: int | None = ..., DeleteOnRelease: bool = ..., /) -> _win32typing.PyILockBytes: ...
+def EnableQuitMessage(threadId, /) -> None: ...
 def FUNCDESC() -> _win32typing.FUNCDESC: ...
-def GetActiveObject(cls) -> _win32typing.PyIUnknown: ...
-def GetClassFile(fileName) -> _win32typing.PyIID: ...
-def GetFacilityString(scode) -> str: ...
+def GetActiveObject(cls, /) -> _win32typing.PyIUnknown: ...
+def GetClassFile(fileName, /) -> _win32typing.PyIID: ...
+def GetFacilityString(scode, /) -> str: ...
 def GetRecordFromGuids(
-    iid: _win32typing.PyIID, verMajor, verMinor, lcid, infoIID: _win32typing.PyIID, data: Incomplete | None = ...
+    iid: _win32typing.PyIID, verMajor, verMinor, lcid, infoIID: _win32typing.PyIID, data: Incomplete | None = ..., /
 ): ...
-def GetRecordFromTypeInfo(TypeInfo: _win32typing.PyITypeInfo): ...
-def GetRunningObjectTable(reserved: int = ...) -> _win32typing.PyIRunningObjectTable: ...
-def GetScodeString(scode) -> str: ...
-def GetScodeRangeString(scode) -> str: ...
-def GetSeverityString(scode) -> str: ...
-def IsGatewayRegistered(__iid: _win32typing.PyIID | None) -> int: ...
-def LoadRegTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid) -> _win32typing.PyITypeLib: ...
-def LoadTypeLib(libFileName: str) -> _win32typing.PyITypeLib: ...
-def MakePyFactory(iid: _win32typing.PyIID) -> _win32typing.PyIClassFactory: ...
+def GetRecordFromTypeInfo(TypeInfo: _win32typing.PyITypeInfo, /): ...
+def GetRunningObjectTable(reserved: int = ..., /) -> _win32typing.PyIRunningObjectTable: ...
+def GetScodeString(scode, /) -> str: ...
+def GetScodeRangeString(scode, /) -> str: ...
+def GetSeverityString(scode, /) -> str: ...
+def IsGatewayRegistered(iid: _win32typing.PyIID | None, /) -> int: ...
+def LoadRegTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid, /) -> _win32typing.PyITypeLib: ...
+def LoadTypeLib(libFileName: str, /) -> _win32typing.PyITypeLib: ...
+def MakePyFactory(iid: _win32typing.PyIID, /) -> _win32typing.PyIClassFactory: ...
 def MkParseDisplayName(
-    displayName: str, bindCtx: _win32typing.PyIBindCtx | None = ...
+    displayName: str, bindCtx: _win32typing.PyIBindCtx | None = ..., /
 ) -> tuple[_win32typing.PyIMoniker, Incomplete, _win32typing.PyIBindCtx]: ...
-def New(cls) -> _win32typing.PyIDispatch: ...
-def ObjectFromAddress(address, iid: _win32typing.PyIID) -> _win32typing.PyIUnknown: ...
-def ObjectFromLresult(lresult, iid: _win32typing.PyIID, wparm) -> _win32typing.PyIUnknown: ...
+def New(cls, /) -> _win32typing.PyIDispatch: ...
+def ObjectFromAddress(address, iid: _win32typing.PyIID, /) -> _win32typing.PyIUnknown: ...
+def ObjectFromLresult(lresult, iid: _win32typing.PyIID, wparm, /) -> _win32typing.PyIUnknown: ...
 def OleInitialize() -> None: ...
 def OleGetClipboard() -> _win32typing.PyIDataObject: ...
 def OleFlushClipboard() -> None: ...
-def OleIsCurrentClipboard(dataObj: _win32typing.PyIDataObject): ...
-def OleSetClipboard(dataObj: _win32typing.PyIDataObject) -> None: ...
-def OleLoadFromStream(stream: _win32typing.PyIStream, iid: _win32typing.PyIID) -> None: ...
-def OleSaveToStream(persist: _win32typing.PyIPersistStream, stream: _win32typing.PyIStream) -> None: ...
-def OleLoad(storage: _win32typing.PyIStorage, iid: _win32typing.PyIID, site: _win32typing.PyIOleClientSite) -> None: ...
-def ProgIDFromCLSID(clsid) -> str: ...
-def PumpWaitingMessages(__firstMessage: int = ..., __lastMessage: int = ...) -> int: ...
+def OleIsCurrentClipboard(dataObj: _win32typing.PyIDataObject, /): ...
+def OleSetClipboard(dataObj: _win32typing.PyIDataObject, /) -> None: ...
+def OleLoadFromStream(stream: _win32typing.PyIStream, iid: _win32typing.PyIID, /) -> None: ...
+def OleSaveToStream(persist: _win32typing.PyIPersistStream, stream: _win32typing.PyIStream, /) -> None: ...
+def OleLoad(storage: _win32typing.PyIStorage, iid: _win32typing.PyIID, site: _win32typing.PyIOleClientSite, /) -> None: ...
+def ProgIDFromCLSID(clsid, /) -> str: ...
+def PumpWaitingMessages(firstMessage: int = ..., lastMessage: int = ..., /) -> int: ...
 def PumpMessages() -> None: ...
-def QueryPathOfRegTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid) -> str: ...
-def ReadClassStg(storage: _win32typing.PyIStorage) -> _win32typing.PyIID: ...
-def ReadClassStm(Stm: _win32typing.PyIStream) -> _win32typing.PyIID: ...
-def RegisterTypeLib(typelib: _win32typing.PyITypeLib, fullPath: str, lcid, helpDir: str | None = ...) -> None: ...
-def UnRegisterTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid, syskind) -> str: ...
-def RegisterActiveObject(obUnknown: _win32typing.PyIUnknown, clsid: _win32typing.PyIID, flags): ...
-def RevokeActiveObject(handle) -> None: ...
-def RegisterDragDrop(hwnd: int, dropTarget: _win32typing.PyIDropTarget) -> None: ...
-def RevokeDragDrop(hwnd: int) -> None: ...
+def QueryPathOfRegTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid, /) -> str: ...
+def ReadClassStg(storage: _win32typing.PyIStorage, /) -> _win32typing.PyIID: ...
+def ReadClassStm(Stm: _win32typing.PyIStream, /) -> _win32typing.PyIID: ...
+def RegisterTypeLib(typelib: _win32typing.PyITypeLib, fullPath: str, lcid, helpDir: str | None = ..., /) -> None: ...
+def UnRegisterTypeLib(iid: _win32typing.PyIID, versionMajor, versionMinor, lcid, syskind, /) -> str: ...
+def RegisterActiveObject(obUnknown: _win32typing.PyIUnknown, clsid: _win32typing.PyIID, flags, /): ...
+def RevokeActiveObject(handle, /) -> None: ...
+def RegisterDragDrop(hwnd: int, dropTarget: _win32typing.PyIDropTarget, /) -> None: ...
+def RevokeDragDrop(hwnd: int, /) -> None: ...
 def DoDragDrop() -> None: ...
-def StgCreateDocfile(name: str, mode, reserved: int = ...) -> _win32typing.PyIStorage: ...
-def StgCreateDocfileOnILockBytes(lockBytes: _win32typing.PyILockBytes, mode, reserved=...) -> _win32typing.PyIStorage: ...
+def StgCreateDocfile(name: str, mode, reserved: int = ..., /) -> _win32typing.PyIStorage: ...
+def StgCreateDocfileOnILockBytes(lockBytes: _win32typing.PyILockBytes, mode, reserved=..., /) -> _win32typing.PyIStorage: ...
 def StgOpenStorageOnILockBytes(
     lockBytes: _win32typing.PyILockBytes,
     stgPriority: _win32typing.PyIStorage,
     snbExclude: Incomplete | None = ...,
     reserved: int = ...,
+    /,
 ) -> _win32typing.PyIStorage: ...
-def StgIsStorageFile(name: str): ...
+def StgIsStorageFile(name: str, /): ...
 def STGMEDIUM() -> _win32typing.PySTGMEDIUM: ...
 def StgOpenStorage(
-    name: str, other: _win32typing.PyIStorage, mode, snbExclude: Incomplete | None = ..., reserved=...
+    name: str, other: _win32typing.PyIStorage, mode, snbExclude: Incomplete | None = ..., reserved=..., /
 ) -> _win32typing.PyIStorage: ...
 def StgOpenStorageEx(
     Name: str, Mode, stgfmt, Attrs, riid: _win32typing.PyIID, StgOptions: Incomplete | None = ...
@@ -123,20 +125,20 @@ def StgCreateStorageEx(
 ) -> _win32typing.PyIStorage: ...
 def TYPEATTR() -> _win32typing.TYPEATTR: ...
 def VARDESC() -> _win32typing.VARDESC: ...
-def WrapObject(ob, gatewayIID: _win32typing.PyIID, interfaceIID: _win32typing.PyIID) -> _win32typing.PyIUnknown: ...
-def WriteClassStg(storage: _win32typing.PyIStorage, iid: _win32typing.PyIID) -> None: ...
-def WriteClassStm(Stm: _win32typing.PyIStream, clsid: _win32typing.PyIID) -> None: ...
-def UnwrapObject(ob: _win32typing.PyIUnknown) -> _win32typing.PyIDispatch: ...
-def FmtIdToPropStgName(fmtid: _win32typing.PyIID): ...
-def PropStgNameToFmtId(Name: str) -> _win32typing.PyIID: ...
-def CoGetCallContext(riid: _win32typing.PyIID) -> _win32typing.PyIServerSecurity: ...
-def CoGetObjectContext(riid: _win32typing.PyIID) -> _win32typing.PyIContext: ...
-def CoGetCancelObject(riid: _win32typing.PyIID, ThreadID: int = ...) -> _win32typing.PyICancelMethodCalls: ...
-def CoSetCancelObject(Unk: _win32typing.PyIUnknown) -> None: ...
+def WrapObject(ob, gatewayIID: _win32typing.PyIID, interfaceIID: _win32typing.PyIID, /) -> _win32typing.PyIUnknown: ...
+def WriteClassStg(storage: _win32typing.PyIStorage, iid: _win32typing.PyIID, /) -> None: ...
+def WriteClassStm(Stm: _win32typing.PyIStream, clsid: _win32typing.PyIID, /) -> None: ...
+def UnwrapObject(ob: _win32typing.PyIUnknown, /) -> _win32typing.PyIDispatch: ...
+def FmtIdToPropStgName(fmtid: _win32typing.PyIID, /): ...
+def PropStgNameToFmtId(Name: str, /) -> _win32typing.PyIID: ...
+def CoGetCallContext(riid: _win32typing.PyIID, /) -> _win32typing.PyIServerSecurity: ...
+def CoGetObjectContext(riid: _win32typing.PyIID, /) -> _win32typing.PyIContext: ...
+def CoGetCancelObject(riid: _win32typing.PyIID, ThreadID: int = ..., /) -> _win32typing.PyICancelMethodCalls: ...
+def CoSetCancelObject(Unk: _win32typing.PyIUnknown, /) -> None: ...
 def CoEnableCallCancellation() -> None: ...
 def CoDisableCallCancellation() -> None: ...
-def CreateURLMonikerEx(*args, **kwargs): ...  # incomplete
-def new(__iid: _win32typing.PyIID | str): ...
+def CreateURLMonikerEx(*args): ...  # incomplete
+def new(iid: _win32typing.PyIID | str, /): ...
 
 ACTIVEOBJECT_STRONG: int
 ACTIVEOBJECT_WEAK: int
@@ -446,7 +448,7 @@ VT_VARIANT: int
 VT_VECTOR: int
 VT_VOID: int
 
-def connect(*args, **kwargs): ...  # incomplete
+def connect(*args): ...  # incomplete
 
 dcom: int
 fdexNameCaseInsensitive: int

stubs/pywin32/pythoncom.pyi

@@ -16,11 +16,11 @@ CBF_SKIP_CONNECT_CONFIRMS: int
 CBF_SKIP_DISCONNECTS: int
 CBF_SKIP_REGISTRATIONS: int
 
-def CreateConversation(*args, **kwargs): ...  # incomplete
-def CreateServer(*args, **kwargs): ...  # incomplete
-def CreateServerSystemTopic(*args, **kwargs): ...  # incomplete
-def CreateStringItem(*args, **kwargs): ...  # incomplete
-def CreateTopic(*args, **kwargs): ...  # incomplete
+def CreateConversation(*args): ...  # incomplete
+def CreateServer(*args): ...  # incomplete
+def CreateServerSystemTopic(*args): ...  # incomplete
+def CreateStringItem(*args): ...  # incomplete
+def CreateTopic(*args): ...  # incomplete
 
 MF_CALLBACKS: int
 MF_CONV: int