comtypes 1.4.8__zip → 1.4.10__zip

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

@@ -1,6 +1,46 @@
 Comtypes CHANGELOG
 ==================
 
+Release 1.4.10
+--------------
+* Replace ``GetModuleFileNameA`` with ``GetModuleFileNameW`` to prevent a ``TypeError``. By @junkmd.
+* Refactor ``server.register``. By @junkmd.
+* ``PythonClass`` and ``PythonPath`` are no longer registered in the registry for a frozen server. By @junkmd.
+* Use ``WinDLL``/``OleDLL`` instead of ``windll``/``oledll``. By @moi15moi.
+* In ``tools.tlbparser``, replace ``windll.oleaut32.QueryPathOfRegTypeLib`` with ``typeinfo.QueryPathOfRegTypeLib``. By @moi15moi.
+* Adjust ``QueryPathOfRegTypeLib`` docstring. By @moi15moi.
+* Reserve blank lines in the generated modules. By @junkmd.
+* Refactor ``tools`` subpackage. By @junkmd.
+* Add ``ActiveObjTest`` to ``test_comserver``. By @junkmd.
+* Replace deprecated install command in CI pipelines. By @moi15moi.
+* Remove unused parameters in ``_shutdown``. By @moi15moi.
+* Delete ``preview.bat``. By @moi15moi.
+* Remove unnecessary ``ruff`` lint rules from ``pyproject.toml``. By @moi15moi.
+* Refactor some code from ``client/__init__.py`` into modules. By @junkmd.
+* Remove workarounds for Windows CE in ``find_memleak``. By @junkmd.
+* Format import blocks and add ``extend-select = ["I"]`` to ``[tool.ruff.lint]``. By @junkmd.
+
+Release 1.4.9
+--------------
+* Separate patch processing within ``_com_interface_meta`` into a module. By @junkmd.
+* Replace ``Literal`` and ``Protocol`` with runtime-referable symbols. By @junkmd.
+* Refactor from ``%`` string formatting to f-strings in many modules. By @newwingbird.
+* Refactor from ``%`` string formatting to f-strings in ``_post_coinit.unknwn``. By @junkmd.
+* Remove the script entry point in ``comtypes.shelllink``. By @cosmastech.
+* Move the modules that define IDL stuff and ``instancemethod``. By @junkmd.
+* Allow the definition of the ``_midlSAFEARRAY(HRESULT)`` type. By @davidschranz.
+* Split ``server/w_getopt.py`` into production code and test code. By @junkmd.
+* Add docstrings to the module defining the ``GUID`` symbol. By @junkmd.
+* Fix broken unregistration of 64bit type libraries. By @forderud.
+* Replace alias definitions with ``ctypes.wintypes`` imports. By @fmtabler.
+* Revive ``pywin32`` related tests. By @junkmd.
+* Revive comserver related tests. By @junkmd.
+* Separate the part that creates entries from ``server.register.Registrar`` and refactor it. By @junkmd.
+* Add ``Test_Registrar_...``. By @junkmd.
+* Many typing improvements. By @junkmd.
+* Separate ``vtbl`` creation within ``_comobject`` into a module. By @junkmd.
+* Migrate the documentation from PythonHosted to ReadTheDocs. By @junkmd.
+
 Release 1.4.8
 --------------
 * Remove Python 3.7 and add Python 3.13 to the CI pipelines. By @junkmd.

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: comtypes
-Version: 1.4.8
+Version: 1.4.10
 Summary: Pure Python COM package
 Home-page: https://github.com/enthought/comtypes
 Download-URL: https://github.com/enthought/comtypes/releases
@@ -16,6 +16,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
+Dynamic: download-url
 
 # comtypes
 
@@ -99,4 +100,4 @@ However, if the script implementation does not use `comtypes.client.GetModule` o
 
 ## Documentation
 
-The documentation is currently hosted [here](https://pythonhosted.org/comtypes) on PythonHosted.
+The documentation is currently hosted [here](https://comtypes.readthedocs.io/) on ReadTheDocs.

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

@@ -80,4 +80,4 @@ However, if the script implementation does not use `comtypes.client.GetModule` o
 
 ## Documentation
 
-The documentation is currently hosted [here](https://pythonhosted.org/comtypes) on PythonHosted.
+The documentation is currently hosted [here](https://comtypes.readthedocs.io/) on ReadTheDocs.

{comtypes-1.4.8 → comtypes-1.4.10}/comtypes/GUID.py

@@ -1,6 +1,8 @@
-from ctypes import oledll, windll
-from ctypes import byref, c_byte, c_ushort, c_ulong, c_wchar_p, Structure
-from typing import Any, TYPE_CHECKING
+"""comtypes.GUID module"""
+
+from ctypes import HRESULT, POINTER, OleDLL, Structure, WinDLL, byref, c_wchar_p
+from ctypes.wintypes import BYTE, DWORD, LPVOID, WORD
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from comtypes import hints  # type: ignore
@@ -10,24 +12,13 @@ def binary(obj: "GUID") -> bytes:
     return bytes(obj)
 
 
-BYTE = c_byte
-WORD = c_ushort
-DWORD = c_ulong
-
-_ole32 = oledll.ole32
-
-_StringFromCLSID = _ole32.StringFromCLSID
-_CoTaskMemFree = windll.ole32.CoTaskMemFree
-_ProgIDFromCLSID = _ole32.ProgIDFromCLSID
-_CLSIDFromString = _ole32.CLSIDFromString
-_CLSIDFromProgID = _ole32.CLSIDFromProgID
-_CoCreateGuid = _ole32.CoCreateGuid
-
 # Note: Comparing GUID instances by comparing their buffers
 # is slightly faster than using ole32.IsEqualGUID.
 
 
 class GUID(Structure):
+    """Globally unique identifier structure."""
+
     _fields_ = [("Data1", DWORD), ("Data2", WORD), ("Data3", WORD), ("Data4", BYTE * 8)]
 
     def __init__(self, name=None):
@@ -92,6 +83,37 @@ class GUID(Structure):
         return guid
 
 
+REFCLSID = POINTER(GUID)
+LPOLESTR = LPCOLESTR = c_wchar_p
+LPCLSID = POINTER(GUID)
+
+_ole32_nohresult = WinDLL("ole32")
+_ole32 = OleDLL("ole32")
+
+_StringFromCLSID = _ole32.StringFromCLSID
+_StringFromCLSID.argtypes = [REFCLSID, POINTER(LPOLESTR)]
+_StringFromCLSID.restype = HRESULT
+
+_CoTaskMemFree = _ole32_nohresult.CoTaskMemFree
+_CoTaskMemFree.argtypes = [LPVOID]
+_CoTaskMemFree.restype = None
+
+_ProgIDFromCLSID = _ole32.ProgIDFromCLSID
+_ProgIDFromCLSID.argtypes = [REFCLSID, POINTER(LPOLESTR)]
+_ProgIDFromCLSID.restype = HRESULT
+
+_CLSIDFromString = _ole32.CLSIDFromString
+_CLSIDFromString.argtypes = [LPCOLESTR, LPCLSID]
+_CLSIDFromString.restype = HRESULT
+
+_CLSIDFromProgID = _ole32.CLSIDFromProgID
+_CLSIDFromProgID.argtypes = [LPCOLESTR, LPCLSID]
+_CLSIDFromProgID.restype = HRESULT
+
+_CoCreateGuid = _ole32.CoCreateGuid
+_CoCreateGuid.argtypes = [POINTER(GUID)]
+_CoCreateGuid.restype = HRESULT
+
 GUID_null = GUID()
 
 __all__ = ["GUID"]

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

@@ -1,5 +1,5 @@
 # comtypes version numbers follow semver (http://semver.org/) and PEP 440
-__version__ = "1.4.8"
+__version__ = "1.4.10"
 
 try:
     from _ctypes import COMError  # noqa
@@ -15,33 +15,30 @@ except ImportError as e:
     raise ImportError(msg) from e
 
 import atexit
+import logging
+import sys
 
 # HACK: Workaround for projects that depend on this package
 # There should be several projects around the world that depend on this package
 # and indirectly reference the symbols of `ctypes` from `comtypes`.
 # If we remove the wildcard import from `ctypes`, they might break. So it is
 # left in the following line.
-from ctypes import *  # noqa
-from ctypes import HRESULT  # noqa
-from ctypes import _Pointer, _SimpleCData  # noqa
-from ctypes import c_int, c_ulong, oledll, windll
-import logging
-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
 
 if TYPE_CHECKING:
     from ctypes import _CData  # only in `typeshed`, private in runtime
+
     from comtypes import hints as hints  # noqa  # type: ignore
 else:
     _CData = _SimpleCData.__mro__[:-1][-1]
 
-from comtypes.GUID import GUID
 from comtypes import patcher  # noqa
 from comtypes._npsupport import interop as npsupport  # noqa
 from comtypes._tlib_version_checker import _check_version  # noqa
-from comtypes._py_instance_method import instancemethod  # noqa
-from comtypes._idl_stuff import defaultvalue, helpstring, dispid  # noqa
-from comtypes._idl_stuff import STDMETHOD, DISPMETHOD, DISPPROPERTY, COMMETHOD  # noqa
+from comtypes.GUID import GUID
 
 _all_slice = slice(None, None, None)
 
@@ -75,7 +72,6 @@ class ReturnHRESULT(Exception):
 
 _GUID = GUID
 IID = GUID
-DWORD = c_ulong
 
 wireHWND = c_ulong
 
@@ -124,8 +120,18 @@ EOAC_NONE = 0
 
 ################################################################
 # Initialization and shutdown
-_ole32 = oledll.ole32
-_ole32_nohresult = windll.ole32  # use this for functions that don't return a HRESULT
+_ole32 = OleDLL("ole32")
+
+_CoInitializeEx = _ole32.CoInitializeEx
+_CoInitializeEx.argtypes = [LPVOID, DWORD]
+_CoInitializeEx.restype = HRESULT
+
+_ole32_nohresult = WinDLL("ole32")  # use this for functions that don't return a HRESULT
+
+_CoUninitialize = _ole32_nohresult.CoUninitialize
+_CoUninitialize.argtypes = []
+_CoUninitialize.restype = None
+
 
 COINIT_MULTITHREADED = 0x0
 COINIT_APARTMENTTHREADED = 0x2
@@ -141,7 +147,7 @@ def CoInitializeEx(flags=None):
     if flags is None:
         flags = getattr(sys, "coinit_flags", COINIT_APARTMENTTHREADED)
     logger.debug("CoInitializeEx(None, %s)", flags)
-    _ole32.CoInitializeEx(None, flags)
+    _CoInitializeEx(None, flags)
 
 
 # COM is initialized automatically for the thread that imports this
@@ -159,7 +165,7 @@ CoInitializeEx()
 # in which we are using COM
 def CoUninitialize():
     logger.debug("CoUninitialize()")
-    _ole32_nohresult.CoUninitialize()
+    _CoUninitialize()
 
 
 ################################################################
@@ -172,6 +178,19 @@ com_interface_registry = {}
 com_coclass_registry = {}
 
 
+################################################################
+# IDL stuff
+
+from comtypes._memberspec import (  # noqa
+    COMMETHOD,
+    DISPMETHOD,
+    DISPPROPERTY,
+    STDMETHOD,
+    defaultvalue,
+    dispid,
+    helpstring,
+)
+
 ################################################################
 # IUnknown, the root of all evil...
 from comtypes._post_coinit import _shutdown
@@ -193,6 +212,7 @@ from comtypes._post_coinit.misc import IPersist, IServiceProvider  # noqa
 ################################################################
 
 
+from comtypes._post_coinit.instancemethod import instancemethod  # noqa
 from comtypes._post_coinit.misc import (  # noqa
     _is_object,
     CoGetObject,