comtypes 1.4.9__zip → 1.4.11__zip

{comtypes-1.4.9 → comtypes-1.4.11}/comtypes/typeinfo.py

@@ -3,21 +3,70 @@
 # generated by 'xml2py'
 # flags '..\tools\windows.xml -m comtypes -m comtypes.automation -w -r .*TypeLibEx -r .*TypeLib -o typeinfo.py'
 # then hacked manually
+import ctypes
 import sys
-from typing import Any, overload, TypeVar, TYPE_CHECKING
-from typing import List, Type, Tuple
-from typing import Optional, Union as _UnionT
-from typing import Callable, Sequence
 import weakref
-
-import ctypes
-from ctypes import HRESULT, POINTER, _Pointer, byref, c_int, c_void_p, c_wchar_p
-from ctypes.wintypes import DWORD, LONG, UINT, ULONG, WCHAR, WORD, INT, SHORT, USHORT
-from comtypes import BSTR, _CData, COMMETHOD, GUID, IID, IUnknown, STDMETHOD
-from comtypes.automation import DISPID, LCID, SCODE
-from comtypes.automation import DISPPARAMS, EXCEPINFO, VARIANT, VARIANTARG, VARTYPE
+from ctypes import (
+    HRESULT,
+    POINTER,
+    OleDLL,
+    WinDLL,
+    byref,
+    c_int,
+    c_void_p,
+    c_wchar_p,
+    create_unicode_buffer,
+)
+from ctypes.wintypes import (
+    DWORD,
+    HMODULE,
+    INT,
+    LONG,
+    LPWSTR,
+    SHORT,
+    UINT,
+    ULONG,
+    USHORT,
+    WCHAR,
+    WORD,
+)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+    overload,
+)
+from typing import Union as _UnionT
+
+from comtypes import BSTR, COMMETHOD, GUID, IID, STDMETHOD, IUnknown, _CData
+from comtypes._memberspec import PARAMFLAG_FHASCUSTDATA as PARAMFLAG_FHASCUSTDATA
+from comtypes._memberspec import PARAMFLAG_FHASDEFAULT as PARAMFLAG_FHASDEFAULT
+from comtypes._memberspec import PARAMFLAG_FIN as PARAMFLAG_FIN
+from comtypes._memberspec import PARAMFLAG_FLCID as PARAMFLAG_FLCID
+from comtypes._memberspec import PARAMFLAG_FOPT as PARAMFLAG_FOPT
+from comtypes._memberspec import PARAMFLAG_FOUT as PARAMFLAG_FOUT
+from comtypes._memberspec import PARAMFLAG_FRETVAL as PARAMFLAG_FRETVAL
+from comtypes._memberspec import PARAMFLAG_NONE as PARAMFLAG_NONE
+from comtypes.automation import (
+    DISPID,
+    DISPPARAMS,
+    EXCEPINFO,
+    LCID,
+    SCODE,
+    VARIANT,
+    VARIANTARG,
+    VARTYPE,
+)
 
 if TYPE_CHECKING:
+    from ctypes import _Pointer
+
     from comtypes import hints  # type: ignore
 
 
@@ -35,6 +84,7 @@ PVOID = c_void_p
 ULONG_PTR = ctypes.c_uint64 if is_64_bit else ctypes.c_ulong
 
 LPOLESTR = POINTER(OLECHAR)
+LPCOLESTR = c_wchar_p
 
 ################################################################
 # enums
@@ -163,15 +213,6 @@ VARFLAG_FREPLACEABLE = 2048
 VARFLAG_FIMMEDIATEBIND = 4096
 VARFLAGS = tagVARFLAGS
 
-PARAMFLAG_NONE = 0
-PARAMFLAG_FIN = 1
-PARAMFLAG_FOUT = 2
-PARAMFLAG_FLCID = 4
-PARAMFLAG_FRETVAL = 8
-PARAMFLAG_FOPT = 16
-PARAMFLAG_FHASDEFAULT = 32
-PARAMFLAG_FHASCUSTDATA = 64
-
 ################################################################
 # a helper
 
@@ -238,8 +279,6 @@ class ITypeLib(IUnknown):
         Returns the name with capitalization found in the type
         library, or None.
         """
-        from ctypes import create_unicode_buffer
-
         namebuf = create_unicode_buffer(name)
         found = BOOL()
         self.__com_IsName(namebuf, lHashVal, byref(found))  # type: ignore
@@ -568,13 +607,65 @@ IRecordInfo._methods_ = [
 
 ################################################################
 # functions
-_oleaut32 = ctypes.oledll.oleaut32
+_oleaut32 = OleDLL("oleaut32")
+
+_GetRecordInfoFromTypeInfo = _oleaut32.GetRecordInfoFromTypeInfo
+_GetRecordInfoFromTypeInfo.argtypes = [
+    POINTER(ITypeInfo),
+    POINTER(POINTER(IRecordInfo)),
+]
+_GetRecordInfoFromTypeInfo.restype = HRESULT
+
+_GetRecordInfoFromGuids = _oleaut32.GetRecordInfoFromGuids
+_GetRecordInfoFromGuids.argtypes = [
+    POINTER(GUID),
+    ULONG,
+    ULONG,
+    LCID,
+    POINTER(GUID),
+    POINTER(POINTER(IRecordInfo)),
+]
+_GetRecordInfoFromGuids.restype = HRESULT
+
+_LoadRegTypeLib = _oleaut32.LoadRegTypeLib
+_LoadRegTypeLib.argtypes = [POINTER(GUID), WORD, WORD, LCID, POINTER(POINTER(ITypeLib))]
+_LoadRegTypeLib.restype = HRESULT
+
+_LoadTypeLibEx = _oleaut32.LoadTypeLibEx
+_LoadTypeLibEx.argtypes = [LPCOLESTR, REGKIND, POINTER(POINTER(ITypeLib))]
+_LoadTypeLibEx.restype = HRESULT
+
+_LoadTypeLib = _oleaut32.LoadTypeLib
+_LoadTypeLib.argtypes = [LPCOLESTR, POINTER(POINTER(ITypeLib))]
+_LoadTypeLib.restype = HRESULT
+
+_UnRegisterTypeLib = _oleaut32.UnRegisterTypeLib
+_UnRegisterTypeLib.argtypes = [POINTER(GUID), WORD, WORD, LCID, SYSKIND]
+_UnRegisterTypeLib.restype = HRESULT
+
+_RegisterTypeLib = _oleaut32.RegisterTypeLib
+_RegisterTypeLib.argtypes = [POINTER(ITypeLib), LPCOLESTR, LPCOLESTR]
+_RegisterTypeLib.restype = HRESULT
+
+_CreateTypeLib2 = _oleaut32.CreateTypeLib2
+_CreateTypeLib2.argtypes = [SYSKIND, LPCOLESTR, POINTER(POINTER(ICreateTypeLib2))]
+_CreateTypeLib2.restype = HRESULT
+
+_QueryPathOfRegTypeLib = _oleaut32.QueryPathOfRegTypeLib
+_QueryPathOfRegTypeLib.argtypes = [POINTER(GUID), USHORT, USHORT, LCID, POINTER(BSTR)]
+_QueryPathOfRegTypeLib.restype = HRESULT
+
+_kernel32 = WinDLL("kernel32")
+
+_GetModuleFileNameW = _kernel32.GetModuleFileNameW
+_GetModuleFileNameW.argtypes = [HMODULE, LPWSTR, DWORD]
+_GetModuleFileNameW.restype = DWORD
 
 
 def GetRecordInfoFromTypeInfo(tinfo: ITypeInfo) -> IRecordInfo:
     """Return an IRecordInfo pointer to the UDT described in tinfo"""
     ri = POINTER(IRecordInfo)()
-    _oleaut32.GetRecordInfoFromTypeInfo(tinfo, byref(ri))
+    _GetRecordInfoFromTypeInfo(tinfo, byref(ri))
     return ri  # type: ignore
 
 
@@ -582,7 +673,7 @@ def GetRecordInfoFromGuids(
     rGuidTypeLib: str, verMajor: int, verMinor: int, lcid: int, rGuidTypeInfo: str
 ) -> IRecordInfo:
     ri = POINTER(IRecordInfo)()
-    _oleaut32.GetRecordInfoFromGuids(
+    _GetRecordInfoFromGuids(
         byref(GUID(rGuidTypeLib)),
         verMajor,
         verMinor,
@@ -598,33 +689,21 @@ def LoadRegTypeLib(
 ) -> ITypeLib:
     """Load a registered type library"""
     tlib = POINTER(ITypeLib)()
-    _oleaut32.LoadRegTypeLib(
-        byref(GUID(guid)), wMajorVerNum, wMinorVerNum, lcid, byref(tlib)
-    )
+    _LoadRegTypeLib(byref(GUID(guid)), wMajorVerNum, wMinorVerNum, lcid, byref(tlib))
     return tlib  # type: ignore
 
 
-if hasattr(_oleaut32, "LoadTypeLibEx"):
-
-    def LoadTypeLibEx(szFile: str, regkind: int = REGKIND_NONE) -> ITypeLib:
-        """Load, and optionally register a type library file"""
-        ptl = POINTER(ITypeLib)()
-        _oleaut32.LoadTypeLibEx(c_wchar_p(szFile), regkind, byref(ptl))
-        return ptl  # type: ignore
-
-else:
-
-    def LoadTypeLibEx(szFile: str, regkind: int = REGKIND_NONE) -> ITypeLib:
-        """Load, and optionally register a type library file"""
-        ptl = POINTER(ITypeLib)()
-        _oleaut32.LoadTypeLib(c_wchar_p(szFile), byref(ptl))
-        return ptl  # type: ignore
+def LoadTypeLibEx(szFile: str, regkind: int = REGKIND_NONE) -> ITypeLib:
+    """Load, and optionally register a type library file"""
+    ptl = POINTER(ITypeLib)()
+    _LoadTypeLibEx(c_wchar_p(szFile), regkind, byref(ptl))
+    return ptl  # type: ignore
 
 
 def LoadTypeLib(szFile: str) -> ITypeLib:
     """Load and register a type library file"""
     tlib = POINTER(ITypeLib)()
-    _oleaut32.LoadTypeLib(c_wchar_p(szFile), byref(tlib))
+    _LoadTypeLib(c_wchar_p(szFile), byref(tlib))
     return tlib  # type: ignore
 
 
@@ -636,36 +715,65 @@ def UnRegisterTypeLib(
     syskind: int = (SYS_WIN64 if is_64_bit else SYS_WIN32),
 ) -> int:
     """Unregister a registered type library"""
-    return _oleaut32.UnRegisterTypeLib(
-        byref(GUID(libID)), wVerMajor, wVerMinor, lcid, syskind
-    )
+    return _UnRegisterTypeLib(byref(GUID(libID)), wVerMajor, wVerMinor, lcid, syskind)
 
 
 def RegisterTypeLib(
     tlib: ITypeLib, fullpath: str, helpdir: Optional[str] = None
 ) -> int:
     """Register a type library in the registry"""
-    return _oleaut32.RegisterTypeLib(tlib, c_wchar_p(fullpath), c_wchar_p(helpdir))
+    return _RegisterTypeLib(tlib, c_wchar_p(fullpath), c_wchar_p(helpdir))
 
 
 def CreateTypeLib(filename: str, syskind: int = SYS_WIN32) -> ICreateTypeLib2:
     """Return a ICreateTypeLib2 pointer"""
     ctlib = POINTER(ICreateTypeLib2)()
-    _oleaut32.CreateTypeLib2(syskind, c_wchar_p(filename), byref(ctlib))
+    _CreateTypeLib2(syskind, c_wchar_p(filename), byref(ctlib))
     return ctlib  # type: ignore
 
 
 def QueryPathOfRegTypeLib(
     libid: str, wVerMajor: int, wVerMinor: int, lcid: int = 0
 ) -> str:
-    """Return the path of a registered type library"""
+    """
+    Retrieve the path of a registered type library.
+
+    This function interacts with the Windows registry to locate the path of a
+    registered type library given its GUID, version, and locale.
+
+    Args:
+        libid (str): The GUID of the type library as a string.
+        wVerMajor (int): The major version of the type library.
+        wVerMinor (int): The minor version of the type library.
+        lcid (int, optional): The locale ID of the type library.
+
+    Returns:
+        str: The path of the registered type library.
+
+    Raises:
+        OSError: If QueryPathOfRegTypeLib fails.
+    """
+
     pathname = BSTR()
-    _oleaut32.QueryPathOfRegTypeLib(
+    _QueryPathOfRegTypeLib(
         byref(GUID(libid)), wVerMajor, wVerMinor, lcid, byref(pathname)
     )
     return pathname.value.split("\0")[0]
 
 
+def GetModuleFileName(handle: Optional[int], maxsize: int) -> str:
+    """Returns the fullpath of the loaded module specified by the handle.
+    If the handle is NULL, returns the executable file path of the current process.
+
+    https://learn.microsoft.com/ja-jp/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibraryw
+    """
+    buf = create_unicode_buffer(maxsize)
+    length = _GetModuleFileNameW(handle, buf, maxsize)
+    if not length:
+        raise ctypes.WinError()
+    return buf.value[:length]
+
+
 ################################################################
 # Structures
 
@@ -1072,6 +1180,10 @@ class IProvideClassInfo(IUnknown):
     ]
 
 
+# Flags used to specify the kind of information requested from an object.
+GUIDKIND_DEFAULT_SOURCE_DISP_IID = 1
+
+
 class IProvideClassInfo2(IProvideClassInfo):
     _iid_ = GUID("{A6BC3AC0-DBAA-11CE-9DE3-00AA004BB851}")
     if TYPE_CHECKING:

{comtypes-1.4.9 → comtypes-1.4.11}/comtypes/viewobject.py

@@ -1,10 +1,8 @@
 # XXX need to find out what the share from comtypes.dataobject.
 from ctypes import *
-from ctypes.wintypes import _RECTL, SIZEL, HDC, tagRECT, tagPOINT
+from ctypes.wintypes import _RECTL, HDC, SIZEL, tagPOINT, tagRECT
 
-from comtypes import COMMETHOD
-from comtypes import GUID
-from comtypes import IUnknown
+from comtypes import COMMETHOD, GUID, IUnknown
 
 
 class tagPALETTEENTRY(Structure):

{comtypes-1.4.9 → comtypes-1.4.11/comtypes.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: comtypes
-Version: 1.4.9
+Version: 1.4.11
 Summary: Pure Python COM package
 Home-page: https://github.com/enthought/comtypes
 Download-URL: https://github.com/enthought/comtypes/releases
@@ -16,6 +16,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Dynamic: download-url
+Dynamic: license-file
 
 # comtypes
 

{comtypes-1.4.9 → comtypes-1.4.11}/comtypes.egg-info/SOURCES.txt

@@ -43,10 +43,13 @@ comtypes/_post_coinit/instancemethod.py
 comtypes/_post_coinit/misc.py
 comtypes/_post_coinit/unknwn.py
 comtypes/client/__init__.py
+comtypes/client/_activeobj.py
 comtypes/client/_code_cache.py
 comtypes/client/_constants.py
+comtypes/client/_create.py
 comtypes/client/_events.py
 comtypes/client/_generate.py
+comtypes/client/_managing.py
 comtypes/client/dynamic.py
 comtypes/client/lazybind.py
 comtypes/server/__init__.py
@@ -90,9 +93,11 @@ comtypes/test/test_dispifc_records.py
 comtypes/test/test_dispifc_safearrays.py
 comtypes/test/test_dispinterface.py
 comtypes/test/test_dyndispatch.py
+comtypes/test/test_errorinfo.py
 comtypes/test/test_excel.py
 comtypes/test/test_findgendir.py
 comtypes/test/test_getactiveobj.py
+comtypes/test/test_hresult.py
 comtypes/test/test_ie.py
 comtypes/test/test_ienum.py
 comtypes/test/test_imfattributes.py
@@ -130,6 +135,8 @@ comtypes/tools/typedesc.py
 comtypes/tools/typedesc_base.py
 comtypes/tools/codegenerator/__init__.py
 comtypes/tools/codegenerator/codegenerator.py
+comtypes/tools/codegenerator/comments.py
+comtypes/tools/codegenerator/heads.py
 comtypes/tools/codegenerator/helpers.py
 comtypes/tools/codegenerator/modulenamer.py
 comtypes/tools/codegenerator/namespaces.py

{comtypes-1.4.9 → comtypes-1.4.11}/pyproject.toml

@@ -3,53 +3,40 @@ requires = ["setuptools>=61.2"]
 build-backend = "setuptools.build_meta"
 
 [tool.ruff.lint]
+extend-select = ["I"]
 ignore = ["E402"]
 
 [tool.ruff.lint.per-file-ignores]
 # production
-"comtypes/_comobject.py" = ["E713", "E722", "F401"]
 "comtypes/_npsupport.py" = ["F401"]
 "comtypes/_vtbl.py" = ["E722"]
-"comtypes/connectionpoints.py" = ["F401", "F403", "F405"]
 "comtypes/automation.py" = ["F401", "F403", "F405"]
-"comtypes/errorinfo.py" = ["F403", "F405"]
 "comtypes/git.py" = ["F401", "F403", "F405"]
-"comtypes/logutil.py" = ["E401"]
-"comtypes/shelllink.py" = ["F401"]
 "comtypes/util.py" = ["F403", "F405"]
 "comtypes/viewobject.py" = ["F403", "F405"]
-"comtypes/_post_coinit/unknwn.py" = ["F821"]
-"comtypes/client/__init__.py" = ["F401", "F403"]
-"comtypes/client/_code_cache.py" = ["E401", "E711"]
 "comtypes/client/_constants.py" = ["F401"]
-"comtypes/client/_events.py" = ["F841"]
-"comtypes/client/lazybind.py" = ["F821"]
-"comtypes/server/__init__.py" = ["E401"]
 "comtypes/server/automation.py" = ["F403", "F405"]
 "comtypes/server/connectionpoints.py" = ["F401", "F403", "F405"]
-"comtypes/server/inprocserver.py" = ["E713", "E722", "F403", "F405", "F841"]
-"comtypes/server/localserver.py" = ["F401", "F403", "F405"]
-"comtypes/server/register.py" = ["F403", "F405", "E713", "E731"]
-"comtypes/tools/codegenerator/codegenerator.py" = ["E713", "E721"]
-"comtypes/tools/codegenerator/helpers.py" = ["F401"]
+"comtypes/server/inprocserver.py" = ["E722"]
+"comtypes/server/register.py" = ["E713"]
 "comtypes/tools/codegenerator/packing.py" = ["F821", "F841"]
-"comtypes/tools/tlbparser.py" = ["F401"]
 "comtypes/tools/typedesc.py" = ["F403", "F405"]
 "comtypes/tools/typedesc_base.py" = ["F401"]
+# gen directory
+"comtypes/gen/*" = ["E", "F", "I"]
+# stub
+"comtypes/hints.pyi" = ["I"]
 # tests
-"comtypes/test/TestComServer.py" = ["E401", "F401", "F403", "F405"]
 "comtypes/test/TestDispServer.py" = ["E401"]
 "comtypes/test/find_memleak.py" = ["E401", "F401", "F403", "F405"]
 "comtypes/test/setup.py" = ["F401"]
-"comtypes/test/test_BSTR.py" = ["E401", "F401", "F403", "F405"]
 "comtypes/test/test_agilent.py" = ["F401", "F841"]
 "comtypes/test/test_client.py" = ["F401"]
 "comtypes/test/test_dict.py" = ["F841"]
-"comtypes/test/test_ie.py" = ["F403", "F405", "F841"]
-"comtypes/test/test_outparam.py" = ["F403", "F405", "F841"]
+"comtypes/test/test_ie.py" = ["F841"]
+"comtypes/test/test_outparam.py" = ["F841"]
 "comtypes/test/test_sapi.py" = ["E401"]
-"comtypes/test/test_server.py" = ["E401", "E722", "F401", "F841"]
+"comtypes/test/test_server.py" = ["F401", "F841"]
 "comtypes/test/test_subinterface.py" = ["E401", "F401", "F403", "F405"]
-"comtypes/test/test_typeinfo.py" = ["F401"]
 "comtypes/test/test_urlhistory.py" = ["E401", "F401", "F403", "F405", "F841"]
 "comtypes/test/test_variant.py" = ["F401", "F821", "F841"]