comtypes 1.4.5__zip → 1.4.7__zip

{comtypes-1.4.5 → comtypes-1.4.7}/comtypes/typeinfo.py

@@ -3,47 +3,23 @@
 # generated by 'xml2py'
 # flags '..\tools\windows.xml -m comtypes -m comtypes.automation -w -r .*TypeLibEx -r .*TypeLib -o typeinfo.py'
 # then hacked manually
-import os
 import sys
-from typing import (
-    Any,
-    Callable,
-    List,
-    Optional,
-    overload,
-    Sequence,
-    Type,
-    TypeVar,
-    Tuple,
-    Union as _UnionT,
-)
+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
-from comtypes import (
-    BSTR,
-    _CData,
-    COMMETHOD,
-    _GUID,
-    GUID,
-    IID,
-    IUnknown,
-    STDMETHOD,
-    TYPE_CHECKING,
-)
-from comtypes.automation import (
-    DISPID,
-    DISPPARAMS,
-    EXCEPINFO,
-    LCID,
-    SCODE,
-    VARIANT,
-    VARIANTARG,
-    VARTYPE,
-    tagVARIANT,
-)
+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
+
+if TYPE_CHECKING:
+    from comtypes import hints  # type: ignore
+
 
 _CT = TypeVar("_CT", bound=_CData)
 _T_IUnknown = TypeVar("_T_IUnknown", bound=IUnknown)
@@ -242,7 +218,9 @@ class ITypeLib(IUnknown):
             """Return an ITypeComp pointer."""
             ...
 
-        def GetDocumentation(self, index: int) -> Tuple[str, str, int, Optional[str]]:
+        def GetDocumentation(
+            self, index: int
+        ) -> Tuple[str, Optional[str], int, Optional[str]]:
             """Return documentation for a type description."""
             ...
 
@@ -250,11 +228,11 @@ class ITypeLib(IUnknown):
             """Release TLIBATTR"""
             ...
 
-    _GetLibAttr: Callable[[], "_Pointer[TLIBATTR]"]
-
     def GetLibAttr(self) -> "TLIBATTR":
         """Return type library attributes"""
-        return _deref_with_release(self._GetLibAttr(), self.ReleaseTLibAttr)
+        return _deref_with_release(
+            self._GetLibAttr(), self.ReleaseTLibAttr  # type: ignore
+        )
 
     def IsName(self, name: str, lHashVal: int = 0) -> Optional[str]:
         """Check if there is type information for this name.
@@ -364,27 +342,30 @@ class ITypeInfo(IUnknown):
             """Releases a VARDESC previously returned by VarDesc"""
             ...
 
-    _GetTypeAttr: Callable[[], "_Pointer[TYPEATTR]"]
-    _GetFuncDesc: Callable[[int], "_Pointer[FUNCDESC]"]
-    _GetVarDesc: Callable[[int], "_Pointer[VARDESC]"]
-    _GetDocumentation: Callable[[int], Tuple[str, str, int, Optional[str]]]
-
-    def GetTypeAttr(self):
+    def GetTypeAttr(self) -> "TYPEATTR":
         """Return the TYPEATTR for this type"""
-        return _deref_with_release(self._GetTypeAttr(), self.ReleaseTypeAttr)
+        return _deref_with_release(
+            self._GetTypeAttr(), self.ReleaseTypeAttr  # type: ignore
+        )
 
-    def GetDocumentation(self, memid):
+    def GetDocumentation(
+        self, memid: int
+    ) -> Tuple[str, Optional[str], int, Optional[str]]:
         """Return name, docstring, helpcontext, and helpfile for 'memid'."""
-        name, doc, helpcontext, helpfile = self._GetDocumentation(memid)
-        return fix_name(name), fix_name(doc), helpcontext, fix_name(helpfile)
+        name, doc, helpctx, helpfile = self._GetDocumentation(memid)  # type: ignore
+        return fix_name(name), fix_name(doc), helpctx, fix_name(helpfile)
 
-    def GetFuncDesc(self, index):
+    def GetFuncDesc(self, index: int) -> "FUNCDESC":
         """Return FUNCDESC for index"""
-        return _deref_with_release(self._GetFuncDesc(index), self.ReleaseFuncDesc)
+        return _deref_with_release(
+            self._GetFuncDesc(index), self.ReleaseFuncDesc  # type: ignore
+        )
 
-    def GetVarDesc(self, index):
+    def GetVarDesc(self, index: int) -> "VARDESC":
         """Return VARDESC for index"""
-        return _deref_with_release(self._GetVarDesc(index), self.ReleaseVarDesc)
+        return _deref_with_release(
+            self._GetVarDesc(index), self.ReleaseVarDesc  # type: ignore
+        )
 
     def GetNames(self, memid: int, count: int = 1) -> List[str]:
         """Return names for memid"""
@@ -478,13 +459,12 @@ class ICreateTypeLib2(ICreateTypeLib):
 class ICreateTypeInfo(IUnknown):
     _iid_ = GUID("{00020405-0000-0000-C000-000000000046}")
     # C:/Programme/gccxml/bin/Vc71/PlatformSDK/oaidl.h 915
-    _SetFuncAndParamNames: Callable[[int, "ctypes.Array[c_wchar_p]", int], int]
 
     def SetFuncAndParamNames(self, index: int, *names: str) -> int:
         rgszNames = (c_wchar_p * len(names))()
         for i, n in enumerate(names):
             rgszNames[i] = n
-        return self._SetFuncAndParamNames(index, rgszNames, len(names))
+        return self._SetFuncAndParamNames(index, rgszNames, len(names))  # type: ignore
 
 
 class IRecordInfo(IUnknown):
@@ -500,6 +480,27 @@ class IRecordInfo(IUnknown):
         # XXX Should SysFreeString the array contents. How to?
         return result
 
+    if TYPE_CHECKING:
+        # fmt: off
+        # def RecordInit
+        # def RecordClear
+        def RecordCopy(  # noqa
+            self, pvExisting: hints.Incomplete, pvNew: hints.Incomplete
+        ) -> hints.Hresult: ...
+        def GetGuid(self) -> GUID: ...  # noqa
+        def GetName(self) -> str: ...  # noqa
+        def GetSize(self) -> int: ...  # noqa
+        def GetTypeInfo(self) -> ITypeInfo: ...  # noqa
+        # def GetField
+        # def GetFieldNoCopy
+        # def PutField
+        # def PutFieldNoCopy
+        def IsMatchingType(self, value: "IRecordInfo") -> bool: ...  # noqa
+        # def RecordCreate
+        def RecordCreateCopy(self, pvSource: hints.Incomplete) -> int: ...  # noqa
+        def RecordDestroy(self, pvRecord: hints.Incomplete) -> hints.Hresult: ...  # noqa
+        # fmt: on
+
 
 IRecordInfo._methods_ = [
     COMMETHOD([], HRESULT, "RecordInit", (["in"], c_void_p, "pvNew")),
@@ -1201,7 +1202,7 @@ class N11tagELEMDESC5DOLLAR_204E(ctypes.Union):
 class tagPARAMDESC(ctypes.Structure):
     # C:/Programme/gccxml/bin/Vc71/PlatformSDK/oaidl.h 609
     if TYPE_CHECKING:
-        pparamdescex: "tagPARAMDESCEX"
+        pparamdescex: "_Pointer[tagPARAMDESCEX]"
         wParamFlags: int
 
 

{comtypes-1.4.5 → comtypes-1.4.7/comtypes.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: comtypes
-Version: 1.4.5
+Version: 1.4.7
 Summary: Pure Python COM package
 Home-page: https://github.com/enthought/comtypes
 Download-URL: https://github.com/enthought/comtypes/releases
@@ -13,7 +13,7 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 
@@ -24,47 +24,40 @@ License-File: LICENSE.txt
 [![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)  
 [![Tidelift Subscription](https://tidelift.com/badges/package/pypi/comtypes)](https://tidelift.com/subscription/pkg/pypi-comtypes?utm_source=pypi-comtypes&utm_medium=readme)
 
-## About
 
-`comtypes` is a lightweight `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) FFI library.
+`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` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`.
+`comtypes` allows you to define, call, and implement custom and dispatch-based COM interfaces in pure Python.
 
-This package works on Windows only.
+`comtypes` requires Windows and Python 3.8 or later.
+- Version [1.4.6](https://pypi.org/project/comtypes/1.4.6/) is the last version to support Python 3.7.
+- Version [1.2.1](https://pypi.org/project/comtypes/1.2.1/) is the last version to support Python 2.7 and 3.3–3.6.
+- `comtypes` does not work with Python 3.8.1 as reported in [GH-202](https://github.com/enthought/comtypes/issues/202). This bug has been fixed in Python >= 3.8.2.
+- Certain `comtypes` functions may not work correctly in Python 3.8 and 3.9 as reported in [GH-212](https://github.com/enthought/comtypes/issues/212). This bug has been fixed in Python >= 3.10.10 and >= 3.11.2.
 
-Available on `Python` 3.7-3.12.
-- [`comtypes==1.2.1`](https://pypi.org/project/comtypes/1.2.1/) is the last version supporting `Python` 2.7 and 3.3-3.6.
-- In `Python` 3.7.6 and 3.8.1, `comtypes` would not work as reported in [GH-202](https://github.com/enthought/comtypes/issues/202).  
-This bug has been fixed in `Python` >= 3.7.7 and >= 3.8.2.
-- In `Python` 3.8 and 3.9, some of `comtypes` functionalities may not work correctly as reported in [GH-212](https://github.com/enthought/comtypes/issues/212).  
-This bug has been fixed in `Python` >= 3.10.10 and >= 3.11.2.
-
-## Where to get it
-
-The source code is currently hosted on GitHub at:
-https://github.com/enthought/comtypes
-
-An installer for the latest released version is available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes).
+## Installation
 
+`comtypes` is available on [PyPI](https://pypi.org/project/comtypes) and can be installed with `pip`:
 ```sh
 # PyPI
 pip install comtypes
 ```
 
-## Dependencies
+The source code is currently hosted [here](https://github.com/enthought/comtypes) on GitHub.
+
+### Dependencies
 
-`comtypes` requires no third-party packages to run - this is truly **pure** `Python` package.
+`comtypes` is a pure Python package — it has no additional required dependencies.
 
-Optional features include the follows...
-- to process arrays as `numpy`'s `ndarray`
-- type hints be interpreted by `mypy` or several static type checkers
+Optional functionalities can be enabled by installing:
+- `numpy`, in order to process arrays as `numpy`'s `ndarray`.
+- `mypy` or other static type checkers, in order to interpret type hints.
 
-But these third-parties are not required as a prerequisite for runtime.
+None of these packages, however, are required in order to run `comtypes`.
 
-## Community of the developers
+## Community
 
-Tracking issues, reporting bugs and contributing to the codebase and documentation are on GitHub at:
-https://github.com/enthought/comtypes
+The [GitHub repository](https://github.com/enthought/comtypes) is used for tracking issues, reporting bugs, and contributing to the codebase and documentation.
 
 ## For Enterprise
 
@@ -77,17 +70,17 @@ This project and the maintainers of thousands of other packages are working with
 ## Frequently Asked Questions
 
 ### Q: Why does this package not support platforms other than Windows?
-**A:** [The Microsoft Component Object Model (COM)](https://learn.microsoft.com/en-us/windows/win32/com/com-technical-overview) is a technology that is unique to Windows and is not supported on other platforms.
+**A:** The [Microsoft Component Object Model (COM)](https://learn.microsoft.com/en-us/windows/win32/com/com-technical-overview) is a technology that is unique to Windows and is not supported on other platforms.
 
 [The phrase _"COM is a platform-independent"_ in the MS documentation](https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal) means that COM maintains compatibility across different versions of Windows, and does NOT imply that it is supported on Linux or Mac.
 
-As long as COM is not supported outside of Windows, this project does not plan to port to other platforms.
+For as long as COM is not supported outside of Windows, there is no plan to port `comtypes` to other platforms.
 
 ### Q: Why does `cannot import name 'COMError' from '_ctypes'` error occur when using this package on platforms other than Windows?
-**A:** The [`_ctypes`](https://github.com/python/cpython/blob/main/Modules/_ctypes/_ctypes.c) is part of the internal implementation of the [`ctypes`](https://github.com/python/cpython/blob/main/Lib/ctypes/) standard library that exists for Python on all platforms.  
-However, `COMError` and COM-related features are implemented only in Python for Windows.
+**A:** The [`_ctypes`](https://github.com/python/cpython/blob/main/Modules/_ctypes/_ctypes.c) is part of the internal implementation of the [`ctypes`](https://github.com/python/cpython/blob/main/Lib/ctypes/) standard library that exists for Python on all platforms.
+However, `COMError` and COM-related features are only implemented in Python for Windows.
 
-In cross-platform software development, care must be taken to ensure that codebase dependent on `comtypes` does not execute in environments other than Windows.
+In cross-platform software development, care must be taken to ensure that codebases that depend on `comtypes` do not execute in environments other than Windows.
 
 ### Q: Despite a script that depends on `comtypes` having run successfully before, a error (`ImportError`, `NameError`, or `SyntaxError`) is raised now, and the same error occurs again and again.
 
@@ -102,7 +95,6 @@ After deleting these partial modules and running the script again, `comtypes.cli
 
 However, if the script implementation does not use `comtypes.client.GetModule` or processes generated files, it may not be a solution.
 
-## Documentation:
+## Documentation
 
-The documentation is currently hosted on pythonhosted at:
-https://pythonhosted.org/comtypes
+The documentation is currently hosted [here](https://pythonhosted.org/comtypes) on PythonHosted.

{comtypes-1.4.5 → comtypes-1.4.7}/comtypes.egg-info/SOURCES.txt

@@ -95,19 +95,25 @@ comtypes/test/test_ie.py
 comtypes/test/test_ienum.py
 comtypes/test/test_imfattributes.py
 comtypes/test/test_inout_args.py
-comtypes/test/test_istream.py
 comtypes/test/test_jscript.js
 comtypes/test/test_midl_safearray_create.py
+comtypes/test/test_monikers.py
 comtypes/test/test_msscript.py
 comtypes/test/test_npsupport.py
 comtypes/test/test_outparam.py
+comtypes/test/test_persist.py
 comtypes/test/test_propputref.py
 comtypes/test/test_pump_events.py
+comtypes/test/test_recordinfo.py
 comtypes/test/test_safearray.py
 comtypes/test/test_sapi.py
 comtypes/test/test_server.py
+comtypes/test/test_shelllink.py
 comtypes/test/test_showevents.py
+comtypes/test/test_storage.py
+comtypes/test/test_stream.py
 comtypes/test/test_subinterface.py
+comtypes/test/test_typeannotator.py
 comtypes/test/test_typeinfo.py
 comtypes/test/test_urlhistory.py
 comtypes/test/test_variant.py

{comtypes-1.4.5 → comtypes-1.4.7}/setup.cfg

@@ -18,7 +18,7 @@ classifiers =
 	Topic :: Software Development :: Libraries :: Python Modules
 
 [options]
-python_requires = >=3.7
+python_requires = >=3.8
 packages = 
 	comtypes
 	comtypes._post_coinit

comtypes-1.4.5/comtypes/tools/codegenerator/modulenamer.py

@@ -1,24 +0,0 @@
-import comtypes
-
-
-def name_wrapper_module(tlib):
-    """Determine the name of a typelib wrapper module"""
-    libattr = tlib.GetLibAttr()
-    modname = "_%s_%s_%s_%s" % (
-        str(libattr.guid)[1:-1].replace("-", "_"),
-        libattr.lcid,
-        libattr.wMajorVerNum,
-        libattr.wMinorVerNum,
-    )
-    return "comtypes.gen.%s" % modname
-
-
-def name_friendly_module(tlib):
-    """Determine the friendly-name of a typelib module.
-    If cannot get friendly-name from typelib, returns `None`.
-    """
-    try:
-        modulename = tlib.GetDocumentation(-1)[0]
-    except comtypes.COMError:
-        return
-    return "comtypes.gen.%s" % modulename