comtypes 1.4.8__zip → 1.4.9__zip

comtypes-1.4.8/comtypes/_idl_stuff.py

@@ -1,67 +0,0 @@
-from comtypes._memberspec import _ComMemberSpec, _DispMemberSpec, _resolve_argspec
-
-
-class helpstring(str):
-    "Specifies the helpstring for a COM method or property."
-
-
-class defaultvalue(object):
-    "Specifies the default value for parameters marked optional."
-
-    def __init__(self, value):
-        self.value = value
-
-
-class dispid(int):
-    "Specifies the DISPID of a method or property."
-
-
-# XXX STDMETHOD, COMMETHOD, DISPMETHOD, and DISPPROPERTY should return
-# instances with more methods or properties, and should not behave as an unpackable.
-
-
-def STDMETHOD(restype, name, argtypes=()) -> _ComMemberSpec:
-    "Specifies a COM method slot without idlflags"
-    return _ComMemberSpec(restype, name, argtypes, None, (), None)
-
-
-def DISPMETHOD(idlflags, restype, name, *argspec) -> _DispMemberSpec:
-    "Specifies a method of a dispinterface"
-    return _DispMemberSpec("DISPMETHOD", name, tuple(idlflags), restype, argspec)
-
-
-def DISPPROPERTY(idlflags, proptype, name) -> _DispMemberSpec:
-    "Specifies a property of a dispinterface"
-    return _DispMemberSpec("DISPPROPERTY", name, tuple(idlflags), proptype, ())
-
-
-# tuple(idlflags) is for the method itself: (dispid, 'readonly')
-
-# sample generated code:
-#     DISPPROPERTY([5, 'readonly'], OLE_YSIZE_HIMETRIC, 'Height'),
-#     DISPMETHOD(
-#         [6], None, 'Render', ([], c_int, 'hdc'), ([], c_int, 'x'), ([], c_int, 'y')
-#     )
-
-
-def COMMETHOD(idlflags, restype, methodname, *argspec) -> _ComMemberSpec:
-    """Specifies a COM method slot with idlflags.
-
-    XXX should explain the sematics of the arguments.
-    """
-    # collect all helpstring instances
-    # We should suppress docstrings when Python is started with -OO
-    # join them together(does this make sense?) and replace by None if empty.
-    helptext = "".join(t for t in idlflags if isinstance(t, helpstring)) or None
-    paramflags, argtypes = _resolve_argspec(argspec)
-    if "propget" in idlflags:
-        name = "_get_%s" % methodname
-    elif "propput" in idlflags:
-        name = "_set_%s" % methodname
-    elif "propputref" in idlflags:
-        name = "_setref_%s" % methodname
-    else:
-        name = methodname
-    return _ComMemberSpec(
-        restype, name, argtypes, paramflags, tuple(idlflags), helptext
-    )

comtypes-1.4.8/comtypes/server/__init__.py

@@ -1,70 +0,0 @@
-import comtypes.client, ctypes
-
-
-################################################################
-# Interfaces
-class IClassFactory(comtypes.IUnknown):
-    _iid_ = comtypes.GUID("{00000001-0000-0000-C000-000000000046}")
-    _methods_ = [
-        comtypes.STDMETHOD(
-            comtypes.HRESULT,
-            "CreateInstance",
-            [
-                ctypes.POINTER(comtypes.IUnknown),
-                ctypes.POINTER(comtypes.GUID),
-                ctypes.POINTER(ctypes.c_void_p),
-            ],
-        ),
-        comtypes.STDMETHOD(comtypes.HRESULT, "LockServer", [ctypes.c_int]),
-    ]
-
-    def CreateInstance(self, punkouter=None, interface=None, dynamic=False):
-        if dynamic:
-            if interface is not None:
-                raise ValueError("interface and dynamic are mutually exclusive")
-            realInterface = comtypes.automation.IDispatch
-        elif interface is None:
-            realInterface = comtypes.IUnknown
-        else:
-            realInterface = interface
-        obj = ctypes.POINTER(realInterface)()
-        self.__com_CreateInstance(punkouter, realInterface._iid_, ctypes.byref(obj))
-        if dynamic:
-            return comtypes.client.dynamic.Dispatch(obj)
-        elif interface is None:
-            # An interface was not specified, so return the best.
-            return comtypes.client.GetBestInterface(obj)
-        # An interface was specified and obj is already that interface.
-        return obj
-
-
-# class IExternalConnection(IUnknown):
-#     _iid_ = GUID("{00000019-0000-0000-C000-000000000046}")
-#     _methods_ = [
-#         STDMETHOD(HRESULT, "AddConnection", [c_ulong, c_ulong]),
-#         STDMETHOD(HRESULT, "ReleaseConnection", [c_ulong, c_ulong, c_ulong])]
-
-# The following code is untested:
-
-ACTIVEOBJECT_STRONG = 0x0
-ACTIVEOBJECT_WEAK = 0x1
-
-oleaut32 = ctypes.oledll.oleaut32
-
-
-def RegisterActiveObject(comobj, weak=True):
-    punk = comobj._com_pointers_[comtypes.IUnknown._iid_]
-    clsid = comobj._reg_clsid_
-    if weak:
-        flags = ACTIVEOBJECT_WEAK
-    else:
-        flags = ACTIVEOBJECT_STRONG
-    handle = ctypes.c_ulong()
-    oleaut32.RegisterActiveObject(
-        punk, ctypes.byref(clsid), flags, ctypes.byref(handle)
-    )
-    return handle.value
-
-
-def RevokeActiveObject(handle):
-    oleaut32.RevokeActiveObject(handle, None)

comtypes-1.4.8/comtypes/server/w_getopt.py

@@ -1,75 +0,0 @@
-class GetoptError(Exception):
-    pass
-
-
-def w_getopt(args, options):
-    """A getopt for Windows.
-
-    Options may start with either '-' or '/', the option names may
-    have more than one letter (/tlb or -RegServer), and option names
-    are case insensitive.
-
-    Returns two elements, just as getopt.getopt.  The first is a list
-    of (option, value) pairs in the same way getopt.getopt does, but
-    there is no '-' or '/' prefix to the option name, and the option
-    name is always lower case.  The second is the list of arguments
-    which do not belong to an option.
-
-    Different from getopt.getopt, a single argument not belonging to an option
-    does not terminate parsing.
-    """
-    opts = []
-    arguments = []
-    while args:
-        if args[0][:1] in "/-":
-            arg = args[0][1:]  # strip the '-' or '/'
-            arg = arg.lower()
-
-            if arg + ":" in options:
-                try:
-                    opts.append((arg, args[1]))
-                except IndexError:
-                    raise GetoptError("option '%s' requires an argument" % args[0])
-                args = args[1:]
-            elif arg in options:
-                opts.append((arg, ""))
-            else:
-                raise GetoptError("invalid option '%s'" % args[0])
-            args = args[1:]
-        else:
-            arguments.append(args[0])
-            args = args[1:]
-
-    return opts, arguments
-
-
-if __debug__:
-    if __name__ == "__main__":
-        import unittest
-
-        class TestCase(unittest.TestCase):
-            def test_1(self):
-                args = "-embedding spam /RegServer foo /UnregSERVER blabla".split()
-                opts, args = w_getopt(args, "regserver unregserver embedding".split())
-                self.assertEqual(
-                    opts, [("embedding", ""), ("regserver", ""), ("unregserver", "")]
-                )
-                self.assertEqual(args, ["spam", "foo", "blabla"])
-
-            def test_2(self):
-                args = "/TLB Hello.Tlb HELLO.idl".split()
-                opts, args = w_getopt(args, ["tlb:"])
-                self.assertEqual(opts, [("tlb", "Hello.Tlb")])
-                self.assertEqual(args, ["HELLO.idl"])
-
-            def test_3(self):
-                # Invalid option
-                self.assertRaises(
-                    GetoptError, w_getopt, "/TLIB hello.tlb hello.idl".split(), ["tlb:"]
-                )
-
-            def test_4(self):
-                # Missing argument
-                self.assertRaises(GetoptError, w_getopt, "/TLB".split(), ["tlb:"])
-
-        unittest.main()

comtypes-1.4.8/comtypes/test/test_comserver.py

@@ -1,239 +0,0 @@
-import sys
-import unittest
-
-import comtypes.test.TestComServer
-from comtypes.client import CreateObject
-from comtypes.server.register import register  # , unregister
-from comtypes.test import is_resource_enabled
-from comtypes.test.find_memleak import find_memleak
-
-
-def setUpModule():
-    raise unittest.SkipTest(
-        "This test requires the tests to be run as admin since it tries to "
-        "register the test COM server.  Is this a good idea?"
-    )
-
-    # If this test is ever NOT skipped, then this line needs to run.  Keeping it here for posterity.
-    register(comtypes.test.TestComServer.TestComServer)
-
-
-class TestInproc(unittest.TestCase):
-    def create_object(self):
-        return CreateObject(
-            "TestComServerLib.TestComServer", clsctx=comtypes.CLSCTX_INPROC_SERVER
-        )
-
-    def _find_memleak(self, func):
-        bytes = find_memleak(func)
-        self.assertFalse(bytes, "Leaks %d bytes" % bytes)
-
-    def test_mixedinout(self):
-        o = self.create_object()
-        self.assertEqual(o.MixedInOut(2, 4), (3, 5))
-
-    def test_getname(self):
-        from ctypes import pointer
-        from comtypes import BSTR
-
-        # This tests a tricky bug, introduced with this patch:
-        # http://www.python.org/sf/1643874
-        #
-        # Returning a BSTR as an [out] parameter from a server
-        # implementation must transfer the ownership to the caller.
-        # When this is not done, the BSTR instance is SysFreeString'd
-        # too early, and the memory is reused.
-        obj = self.create_object()
-        pb = pointer(BSTR())
-        # Get the BSTR from the server:
-        obj._ITestComServer__com__get_name(pb)
-        # Retrieve the value, but keep the pointer to the BSTR alive:
-        name = pb[0]
-        # Create sme BSTR's to reuse the memory in case it has been freed:
-        for i in range(10):
-            BSTR("f" * len(name))
-        # Make sure the pointer is still valid:
-        self.assertEqual(pb[0], name)
-
-    if is_resource_enabled("memleaks"):
-
-        def test_get_id(self):
-            obj = self.create_object()
-            self._find_memleak(lambda: obj.id)
-
-        def test_get_name(self):
-            obj = self.create_object()
-            self._find_memleak(lambda: obj.name)
-
-        def test_set_name(self):
-            obj = self.create_object()
-
-            def func():
-                obj.name = "abcde"
-
-            self._find_memleak(func)
-
-        def test_SetName(self):
-            obj = self.create_object()
-
-            def func():
-                obj.SetName("abcde")
-
-            self._find_memleak(func)
-
-        def test_eval(self):
-            obj = self.create_object()
-
-            def func():
-                return obj.eval("(1, 2, 3)")
-
-            self.assertEqual(func(), (1, 2, 3))
-            self._find_memleak(func)
-
-        def test_get_typeinfo(self):
-            obj = self.create_object()
-
-            def func():
-                obj.GetTypeInfo(0)
-                obj.GetTypeInfoCount()
-                obj.QueryInterface(comtypes.IUnknown)
-
-            self._find_memleak(func)
-
-
-if is_resource_enabled("ui"):
-
-    class TestLocalServer(TestInproc):
-        def create_object(self):
-            return CreateObject(
-                "TestComServerLib.TestComServer", clsctx=comtypes.CLSCTX_LOCAL_SERVER
-            )
-
-
-try:
-    from win32com.client import Dispatch
-except ImportError:
-    pass
-else:
-
-    class TestInproc_win32com(TestInproc):
-        def create_object(self):
-            return Dispatch("TestComServerLib.TestComServer")
-
-        # These tests make no sense with win32com, override to disable them:
-        def test_get_typeinfo(self):
-            pass
-
-        def test_getname(self):
-            pass
-
-        def test_mixedinout(self):
-            # Not sure about this; it raise 'Invalid Number of parameters'
-            # Is mixed [in], [out] args not compatible with IDispatch???
-            pass
-
-    if is_resource_enabled("ui"):
-
-        class TestLocalServer_win32com(TestInproc_win32com):
-            def create_object(self):
-                return Dispatch(
-                    "TestComServerLib.TestComServer",
-                    clsctx=comtypes.CLSCTX_LOCAL_SERVER,
-                )
-
-
-import doctest
-import comtypes.test.test_comserver
-
-
-class TestCase(unittest.TestCase):
-    def test(self):
-        doctest.testmod(comtypes.test.test_comserver, optionflags=doctest.ELLIPSIS)
-
-    # The following functions are never called, they only contain doctests:
-
-    if sys.version_info >= (3, 0):
-
-        def ShowEvents(self):
-            """
-            >>> from comtypes.client import CreateObject, ShowEvents
-            >>>
-            >>> o = CreateObject("TestComServerLib.TestComServer")
-            >>> con = ShowEvents(o)
-            # event found: ITestComServerEvents_EvalStarted
-            # event found: ITestComServerEvents_EvalCompleted
-            >>> result = o.eval("10. / 4")
-            Event ITestComServerEvents_EvalStarted(None, '10. / 4')
-            Event ITestComServerEvents_EvalCompleted(None, '10. / 4', VARIANT(vt=0x5, 2.5))
-            >>> result
-            2.5
-            >>>
-            """
-
-    else:
-
-        def ShowEvents(self):
-            """
-            >>> from comtypes.client import CreateObject, ShowEvents
-            >>>
-            >>> o = CreateObject("TestComServerLib.TestComServer")
-            >>> con = ShowEvents(o)
-            # event found: ITestComServerEvents_EvalStarted
-            # event found: ITestComServerEvents_EvalCompleted
-            >>> result = o.eval("10. / 4")
-            Event ITestComServerEvents_EvalStarted(None, u'10. / 4')
-            Event ITestComServerEvents_EvalCompleted(None, u'10. / 4', VARIANT(vt=0x5, 2.5))
-            >>> result
-            2.5
-            >>>
-            """
-
-        # The following test, if enabled, works but the testsuit
-        # crashes elsewhere.  Is there s problem with SAFEARRAYs?
-
-    if is_resource_enabled("CRASHES"):
-
-        def Fails(self):
-            """
-            >>> from comtypes.client import CreateObject, ShowEvents
-            >>>
-            >>> o = CreateObject("TestComServerLib.TestComServer")
-            >>> con = ShowEvents(o)
-            # event found: ITestComServerEvents_EvalStarted
-            # event found: ITestComServerEvents_EvalCompleted
-            >>> result = o.eval("['32'] * 2")
-            Event ITestComServerEvents_EvalStarted(None, u"['32'] * 2")
-            Event ITestComServerEvents_EvalCompleted(None, u"['32'] * 2", VARIANT(vt=0x200c, (u'32', u'32')))
-            >>> result
-            (u'32', u'32')
-            >>>
-            """
-
-    def GetEvents(self):
-        """
-        >>> from comtypes.client import CreateObject, GetEvents
-        >>>
-        >>> o =  CreateObject("TestComServerLib.TestComServer")
-        >>> class EventHandler(object):
-        ...     def EvalStarted(self, this, what):
-        ...         print("EvalStarted: %s" % what)
-        ...         return 0
-        ...     def EvalCompleted(self, this, what, result):
-        ...         print("EvalCompleted: %s = %s" % (what, result.value))
-        ...         return 0
-        ...
-        >>>
-        >>> con = GetEvents(o, EventHandler())
-        >>> o.eval("2 + 3")
-        EvalStarted: 2 + 3
-        EvalCompleted: 2 + 3 = 5
-        5
-        >>> del con
-        >>> o.eval("3 + 2")
-        5
-        >>>
-        """
-
-
-if __name__ == "__main__":
-    unittest.main()

comtypes-1.4.8/comtypes/test/test_dispinterface.py

@@ -1,137 +0,0 @@
-import unittest
-
-import comtypes.test.TestDispServer
-from comtypes.server.register import register  # , unregister
-from comtypes.test import is_resource_enabled
-
-
-def setUpModule():
-    raise unittest.SkipTest(
-        "This test requires the tests to be run as admin since it tries to "
-        "register the test COM server.  Is this a good idea?"
-    )
-
-    # If this test is ever NOT skipped, then this line needs to run.  Keeping it here for posterity.
-    register(comtypes.test.TestDispServer.TestDispServer)
-
-
-class Test(unittest.TestCase):
-    if is_resource_enabled("pythoncom"):
-
-        def test_win32com(self):
-            # EnsureDispatch is case-sensitive
-            from win32com.client.gencache import EnsureDispatch
-
-            d = EnsureDispatch("TestDispServerLib.TestDispServer")
-
-            self.assertEqual(d.eval("3.14"), 3.14)
-            self.assertEqual(d.eval("1 + 2"), 3)
-            self.assertEqual(d.eval("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            self.assertEqual(d.eval2("3.14"), 3.14)
-            self.assertEqual(d.eval2("1 + 2"), 3)
-            self.assertEqual(d.eval2("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            d.eval(
-                "__import__('comtypes.client').client.CreateObject('Scripting.Dictionary')"
-            )
-
-            server_id = d.eval("id(self)")
-            self.assertEqual(d.id, server_id)
-
-            self.assertEqual(d.name, "spam, spam, spam")
-
-            d.SetName("foo bar")
-            self.assertEqual(d.name, "foo bar")
-
-            d.name = "blah"
-            self.assertEqual(d.name, "blah")
-
-        def test_win32com_dyndispatch(self):
-            # dynamic Dispatch is case-IN-sensitive
-            from win32com.client.dynamic import Dispatch
-
-            d = Dispatch("TestDispServerLib.TestDispServer")
-
-            self.assertEqual(d.eval("3.14"), 3.14)
-            self.assertEqual(d.eval("1 + 2"), 3)
-            self.assertEqual(d.eval("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            self.assertEqual(d.eval2("3.14"), 3.14)
-            self.assertEqual(d.eval2("1 + 2"), 3)
-            self.assertEqual(d.eval2("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            d.eval(
-                "__import__('comtypes.client').client.CreateObject('Scripting.Dictionary')"
-            )
-
-            self.assertEqual(d.EVAL("3.14"), 3.14)
-            self.assertEqual(d.EVAL("1 + 2"), 3)
-            self.assertEqual(d.EVAL("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            self.assertEqual(d.EVAL2("3.14"), 3.14)
-            self.assertEqual(d.EVAL2("1 + 2"), 3)
-            self.assertEqual(d.EVAL2("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-            server_id = d.eval("id(self)")
-            self.assertEqual(d.id, server_id)
-            self.assertEqual(d.ID, server_id)
-
-            self.assertEqual(d.Name, "spam, spam, spam")
-            self.assertEqual(d.nAME, "spam, spam, spam")
-
-            d.SetName("foo bar")
-            self.assertEqual(d.Name, "foo bar")
-
-            # fails.  Why?
-            # d.name = "blah"
-            # self.assertEqual(d.Name, "blah")
-
-    def test_comtypes(self):
-        from comtypes.client import CreateObject
-
-        d = CreateObject("TestDispServerLib.TestDispServer")
-
-        self.assertEqual(d.eval("3.14"), 3.14)
-        self.assertEqual(d.eval("1 + 2"), 3)
-        self.assertEqual(d.eval("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-        self.assertEqual(d.eval2("3.14"), 3.14)
-        self.assertEqual(d.eval2("1 + 2"), 3)
-        self.assertEqual(d.eval2("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-        d.eval(
-            "__import__('comtypes.client').client.CreateObject('Scripting.Dictionary')"
-        )
-
-        self.assertEqual(d.EVAL("3.14"), 3.14)
-        self.assertEqual(d.EVAL("1 + 2"), 3)
-        self.assertEqual(d.EVAL("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-        self.assertEqual(d.EVAL2("3.14"), 3.14)
-        self.assertEqual(d.EVAL2("1 + 2"), 3)
-        self.assertEqual(d.EVAL2("[1 + 2, 'foo', None]"), (3, "foo", None))
-
-        server_id = d.eval("id(self)")
-        self.assertEqual(d.id, server_id)
-        self.assertEqual(d.ID, server_id)
-
-        self.assertEqual(d.Name, "spam, spam, spam")
-        self.assertEqual(d.nAME, "spam, spam, spam")
-
-        d.SetName("foo bar")
-        self.assertEqual(d.Name, "foo bar")
-
-        d.name = "blah"
-        self.assertEqual(d.Name, "blah")
-
-    def test_withjscript(self):
-        import os
-
-        jscript = os.path.join(os.path.dirname(__file__), "test_jscript.js")
-        errcode = os.system("cscript -nologo %s" % jscript)
-        self.assertEqual(errcode, 0)
-
-
-if __name__ == "__main__":
-    unittest.main()

comtypes-1.4.8/comtypes/test/test_propputref.py

@@ -1,40 +0,0 @@
-# There are also propputref tests in test_sapi.py!
-import unittest
-from comtypes.client import CreateObject
-from comtypes.automation import VARIANT
-
-
-class Test(unittest.TestCase):
-    @unittest.skip(
-        "Fails on creating `TestComServerLib.TestComServer`.  Figure out why."
-    )
-    def test(self, dynamic=False):
-        d = CreateObject("Scripting.Dictionary", dynamic=dynamic)
-        s = CreateObject("TestComServerLib.TestComServer", dynamic=dynamic)
-        s.name = "the value"
-
-        # This calls propputref, since we assign an Object
-        d.Item["object"] = s
-        # This calls propput, since we assing a Value
-        d.Item["value"] = s.name
-
-        self.assertEqual(d.Item["object"], s)
-        self.assertEqual(d.Item["object"].name, "the value")
-        self.assertEqual(d.Item["value"], "the value")
-
-        # Changing the default property of the object
-        s.name = "foo bar"
-        self.assertEqual(d.Item["object"], s)
-        self.assertEqual(d.Item["object"].name, "foo bar")
-        self.assertEqual(d.Item["value"], "the value")
-
-        # This also calls propputref since we assign an Object
-        d.Item["var"] = VARIANT(s)
-        self.assertEqual(d.Item["var"], s)
-
-    def test_dispatch(self):
-        return self.test(dynamic=True)
-
-
-if __name__ == "__main__":
-    unittest.main()