comtypes 1.4.10__zip → 1.4.12__zip

{comtypes-1.4.10 → comtypes-1.4.12}/CHANGES.txt

@@ -1,6 +1,54 @@
 Comtypes CHANGELOG
 ==================
 
+Release 1.4.12
+--------------
+* Add support for coverage. By @moi15moi.
+* CI/CD Improvements for runners and the codecov badge. By @junkmd.
+* Add signed 32-bit hexadecimal converters. By @junkmd.
+* Add ``Test_Stat`` to ``test_stream``. By @junkmd.
+* Add client-side ``RegisterActiveObject``. By @junkmd.
+* Remove useless ``object`` inheritance from every class. By @moi15moi.
+* Modernize ``super()`` calls by removing explicit class and instance arguments. By @moi15moi.
+* Eliminate outdated encoding boilerplates. By @moi15moi.
+* Update byte string creation to use ``b""`` instead of ``str.encode("utf-8")``. By @moi15moi.
+* Introduce ``codecov.yml``. By @moi15moi.
+* Migrate exception catches from older aliases to ``OSError``. By @moi15moi.
+* Remove obsolete Python 2 compatibility code in ``test_variant``. By @junkmd.
+* Skip ``test_eval`` in INPROC server tests due to instability. By @junkmd.
+* Adjust structure sizes and alignments for 64-bit Python in ``viewobject.py``. By @junkmd.
+* Add ``test_viewobject``. By @junkmd.
+* Ensure ``test_npsupport`` passes with ``numpy>=2.0.0`` by explicitly setting ``dtype=numpy.int32``. By @junkmd.
+* Add tests for ``DictPropertyBag`` and type hints for ``IPropertyBag``. By @junkmd.
+* Fix ``numpy`` interoperability and enable ``datetime64`` tests. By @junkmd.
+* Revive and correct integer handling logic for ``VARIANT``s when setting values. By @junkmd.
+* Add tests for ``messageloop``. By @junkmd.
+* Revive ``util`` and add comprehensive tests. By @junkmd.
+* Refactor and enhance ``util`` with explicit imports and typing. By @junkmd.
+* Modernize ``npsupport`` by removing the patch for the ``np._typecodes``. By @junkmd.
+
+Release 1.4.11
+--------------
+* Improve ``PARAMFLAG_...`` and ``DISPATCH_...`` constants definitions and imports. By @junkmd.
+* Introduce the ``_CDataType`` alias from typeshed. By @junkmd.
+* Replace ``260`` literals/constant definitions with imports from ``ctypes.wintypes.MAX_PATH``. By @junkmd.
+* Replace ``client._code_cache._get_module_filename`` with ``typeinfo.GetModuleFileName``. By @junkmd.
+* Improve ``client._code_cache.SHGetSpecialFolderPath`` definition. By @junkmd.
+* Add type annotations to many modules. By @junkmd.
+* Add constants to many modules. By @junkmd.
+* Improve import block styles to many modules. By @junkmd.
+* Add ``SupportErrorInfoTest`` to ``test_comserver``. By @junkmd.
+* Add ``test_errorinfo``. By @junkmd.
+* Improve the type safety of ``errorinfo.ReportException``. By @junkmd.
+* Change the method of retrieving the values of each field in ``_...MemberSpec`` from unpacking to dot access. By @junkmd.
+* Split ``server.connectionpoints.ConnectionPointImpl._call_sinks``. By @junkmd.
+* Refactor ``create_vtbl_mapping``, ``create_dispimpl`` and ``_encode_idl``. By @junkmd.
+* Add ``test_hresult``. By @junkmd.
+* Add ``Test_Vtbl`` to ``test_comobject.py``. By @junkmd.
+* Delint ``IUnknown_AddRef`` and ``IUnknown_Release``. By @junkmd.
+* Convert ``assertRaises`` usage to context manager for improved readability. By @junkmd.
+* Remove the unused ``PATH`` variable from ``client/_generate.py``. By @moi15moi.
+
 Release 1.4.10
 --------------
 * Replace ``GetModuleFileNameA`` with ``GetModuleFileNameW`` to prevent a ``TypeError``. By @junkmd.

{comtypes-1.4.10/comtypes.egg-info → comtypes-1.4.12}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: comtypes
-Version: 1.4.10
+Version: 1.4.12
 Summary: Pure Python COM package
 Home-page: https://github.com/enthought/comtypes
 Download-URL: https://github.com/enthought/comtypes/releases
@@ -17,6 +17,7 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Dynamic: download-url
+Dynamic: license-file
 
 # comtypes
 
@@ -24,7 +25,7 @@ Dynamic: download-url
 [![PyPI version](https://badge.fury.io/py/comtypes.svg)](https://pypi.org/project/comtypes/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Python Requires](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fcomtypes%2Fjson&query=info.requires_python&label=Python Requires)](https://pypi.org/project/comtypes/)  
 [![PyPI - License](https://img.shields.io/pypi/l/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Downloads](https://img.shields.io/pypi/dm/comtypes)](https://pypi.org/project/comtypes/)  
 [![GitHub Repo stars](https://img.shields.io/github/stars/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/stargazers) [![GitHub forks](https://img.shields.io/github/forks/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/network/members) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)  
-[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme)
+[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme) [![Coverage](https://img.shields.io/codecov/c/github/enthought/comtypes)](https://app.codecov.io/github/enthought/comtypes)  
 
 
 `comtypes` is a lightweight pure Python [COM](https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal) package based on the [`ctypes`](https://docs.python.org/library/ctypes.html) foreign function interface library.

{comtypes-1.4.10 → comtypes-1.4.12}/README.md

@@ -4,7 +4,7 @@
 [![PyPI version](https://badge.fury.io/py/comtypes.svg)](https://pypi.org/project/comtypes/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Python Requires](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fcomtypes%2Fjson&query=info.requires_python&label=Python Requires)](https://pypi.org/project/comtypes/)  
 [![PyPI - License](https://img.shields.io/pypi/l/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Downloads](https://img.shields.io/pypi/dm/comtypes)](https://pypi.org/project/comtypes/)  
 [![GitHub Repo stars](https://img.shields.io/github/stars/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/stargazers) [![GitHub forks](https://img.shields.io/github/forks/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/network/members) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)  
-[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme)
+[![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme) [![Coverage](https://img.shields.io/codecov/c/github/enthought/comtypes)](https://app.codecov.io/github/enthought/comtypes)  
 
 
 `comtypes` is a lightweight pure Python [COM](https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal) package based on the [`ctypes`](https://docs.python.org/library/ctypes.html) foreign function interface library.

{comtypes-1.4.10 → comtypes-1.4.12}/comtypes/__init__.py

@@ -1,5 +1,5 @@
 # comtypes version numbers follow semver (http://semver.org/) and PEP 440
-__version__ = "1.4.10"
+__version__ = "1.4.12"
 
 try:
     from _ctypes import COMError  # noqa
@@ -26,7 +26,7 @@ import sys
 from ctypes import *  # noqa  # type: ignore
 from ctypes import HRESULT, OleDLL, WinDLL, _SimpleCData, c_int, c_ulong
 from ctypes.wintypes import DWORD, LPVOID
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Dict, Type
 
 if TYPE_CHECKING:
     from ctypes import _CData  # only in `typeshed`, private in runtime
@@ -172,10 +172,10 @@ def CoUninitialize():
 # global registries.
 
 # allows to find interface classes by guid strings (iid)
-com_interface_registry = {}
+com_interface_registry: Dict[str, Type["IUnknown"]] = {}
 
 # allows to find coclasses by guid strings (clsid)
-com_coclass_registry = {}
+com_coclass_registry: Dict[str, Type["CoClass"]] = {}
 
 
 ################################################################
@@ -213,12 +213,18 @@ from comtypes._post_coinit.misc import IPersist, IServiceProvider  # noqa
 
 
 from comtypes._post_coinit.instancemethod import instancemethod  # noqa
+from comtypes._post_coinit.activeobj import (  # noqa
+    ACTIVEOBJECT_STRONG,
+    ACTIVEOBJECT_WEAK,
+    GetActiveObject,
+    RegisterActiveObject,
+    RevokeActiveObject,
+)
 from comtypes._post_coinit.misc import (  # noqa
     _is_object,
     CoGetObject,
     CoCreateInstance,
     CoGetClassObject,
-    GetActiveObject,
     MULTI_QI,
     _COAUTHIDENTITY,
     COAUTHIDENTITY,

{comtypes-1.4.10 → comtypes-1.4.12}/comtypes/_comobject.py

@@ -5,7 +5,6 @@ from ctypes import (
     POINTER,
     FormatError,
     OleDLL,
-    Structure,
     WinDLL,
     byref,
     c_long,
@@ -29,11 +28,21 @@ from typing import (
 )
 from typing import Union as _UnionT
 
+import comtypes
 from comtypes import GUID, IPersist, IUnknown, _CoUninitialize, hresult
+from comtypes._memberspec import DISPATCH_METHOD as DISPATCH_METHOD
+from comtypes._memberspec import DISPATCH_PROPERTYGET as DISPATCH_PROPERTYGET
+from comtypes._memberspec import DISPATCH_PROPERTYPUT as DISPATCH_PROPERTYPUT
+from comtypes._memberspec import DISPATCH_PROPERTYPUTREF as DISPATCH_PROPERTYPUTREF
 from comtypes._vtbl import _MethodFinder, create_dispimpl, create_vtbl_mapping
 from comtypes.automation import DISPID, DISPPARAMS, EXCEPINFO, VARIANT
 from comtypes.errorinfo import ISupportErrorInfo
-from comtypes.typeinfo import IProvideClassInfo, IProvideClassInfo2, ITypeInfo
+from comtypes.typeinfo import (
+    GUIDKIND_DEFAULT_SOURCE_DISP_IID,
+    IProvideClassInfo,
+    IProvideClassInfo2,
+    ITypeInfo,
+)
 
 if TYPE_CHECKING:
     from ctypes import _CArgObject, _Pointer
@@ -46,11 +55,6 @@ _debug = logger.debug
 ################################################################
 # COM object implementation
 
-# so we don't have to import comtypes.automation
-DISPATCH_METHOD = 1
-DISPATCH_PROPERTYGET = 2
-DISPATCH_PROPERTYPUT = 4
-DISPATCH_PROPERTYPUTREF = 8
 
 ################################################################
 
@@ -140,7 +144,7 @@ _PostQuitMessage.argtypes = [INT]
 _PostQuitMessage.restype = None
 
 
-class LocalServer(object):
+class LocalServer:
     _queue: Optional[queue.Queue] = None
 
     def run(self, classobjects: Sequence["hints.localserver.ClassFactory"]) -> None:
@@ -182,7 +186,7 @@ class LocalServer(object):
                 _PostQuitMessage(0)
 
 
-class InprocServer(object):
+class InprocServer:
     def __init__(self) -> None:
         self.locks = c_long(0)
 
@@ -203,25 +207,25 @@ class InprocServer(object):
 _T_IUnknown = TypeVar("_T_IUnknown", bound=IUnknown)
 
 
-class COMObject(object):
+class COMObject:
     _com_interfaces_: ClassVar[List[Type[IUnknown]]]
     _outgoing_interfaces_: ClassVar[List[Type["hints.IDispatch"]]]
     _instances_: ClassVar[Dict["COMObject", None]] = {}
     _reg_clsid_: ClassVar[GUID]
     _reg_typelib_: ClassVar[Tuple[str, int, int]]
     __typelib: "hints.ITypeLib"
-    _com_pointers_: Dict[GUID, "_Pointer[_Pointer[Structure]]"]
-    _dispimpl_: Dict[Tuple[int, int], Callable[..., Any]]
+    _com_pointers_: Dict[GUID, "hints.LP_LP_Vtbl"]
+    _dispimpl_: Dict[Tuple[comtypes.dispid, int], Callable[..., Any]]
 
-    def __new__(cls, *args, **kw):
-        self = super(COMObject, cls).__new__(cls)
+    def __new__(cls, *args: Any, **kw: Any) -> "hints.Self":
+        self = super().__new__(cls)
         if isinstance(self, c_void_p):
             # We build the VTables only for direct instances of
             # CoClass, not for POINTERs to CoClass.
-            return self
+            return self  # type: ignore
         if hasattr(self, "_com_interfaces_"):
             self.__prepare_comobject()
-        return self
+        return self  # type: ignore
 
     def __prepare_comobject(self) -> None:
         # When a CoClass instance is created, COM pointers to all
@@ -326,10 +330,10 @@ class COMObject(object):
     def IUnknown_AddRef(
         self,
         this: Any,
-        __InterlockedIncrement: Callable[[c_long], int] = _InterlockedIncrement,
+        _increment: Callable[[c_long], int] = _InterlockedIncrement,
         _debug=_debug,
     ) -> int:
-        result = __InterlockedIncrement(self._refcnt)
+        result = _increment(self._refcnt)
         if result == 1:
             self.__keep__(self)
         _debug("%r.AddRef() -> %s", self, result)
@@ -343,14 +347,14 @@ class COMObject(object):
     def IUnknown_Release(
         self,
         this: Any,
-        __InterlockedDecrement: Callable[[c_long], int] = _InterlockedDecrement,
+        _decrement: Callable[[c_long], int] = _InterlockedDecrement,
         _debug=_debug,
     ) -> int:
         # If this is called at COM shutdown, _InterlockedDecrement()
         # must still be available, although module level variables may
         # have been deleted already - so we supply it as default
         # argument.
-        result = __InterlockedDecrement(self._refcnt)
+        result = _decrement(self._refcnt)
         _debug("%r.Release() -> %s", self, result)
         if result == 0:
             self._final_release_()
@@ -410,16 +414,15 @@ class COMObject(object):
         try:
             self.__typelib
         except AttributeError:
-            raise WindowsError(hresult.E_NOTIMPL)
+            raise OSError(hresult.E_NOTIMPL)
         return self.__typelib.GetTypeInfoOfGuid(self._reg_clsid_)
 
     ################################################################
     # IProvideClassInfo2::GetGUID implementation
 
     def IProvideClassInfo2_GetGUID(self, dwGuidKind: int) -> GUID:
-        # GUIDKIND_DEFAULT_SOURCE_DISP_IID = 1
-        if dwGuidKind != 1:
-            raise WindowsError(hresult.E_INVALIDARG)
+        if dwGuidKind != GUIDKIND_DEFAULT_SOURCE_DISP_IID:
+            raise OSError(hresult.E_INVALIDARG)
         return self._outgoing_interfaces_[0]._iid_
 
     ################################################################
@@ -516,10 +519,7 @@ class COMObject(object):
         #
         params = pDispParams[0]
 
-        if wFlags & (4 | 8):
-            # DISPATCH_PROPERTYPUT
-            # DISPATCH_PROPERTYPUTREF
-            #
+        if wFlags & (DISPATCH_PROPERTYPUT | DISPATCH_PROPERTYPUTREF):
             # How are the parameters unpacked for propertyput
             # operations with additional parameters?  Can propput
             # have additional args?
@@ -530,9 +530,7 @@ class COMObject(object):
             # DISPATCH_PROPERTYPUTREF is specified.
             return mth(this, *args)
 
-        else:
-            # DISPATCH_METHOD
-            # DISPATCH_PROPERTYGET
+        else:  # wFlags & (DISPATCH_METHOD | DISPATCH_PROPERTYGET)
             # the positions of named arguments
             #
             # 2to3 has problems to translate 'range(...)[::-1]'