# NOTE - Still seems to be a leak here somewhere # gateway count doesn't hit zero. Hence the print statements! import sys sys.coinit_flags = 0 # Must be free-threaded! import datetime import decimal import os import time import pythoncom import win32com import win32com.test.util import win32timezone import winerror from win32api import CloseHandle, GetCurrentProcessId, OpenProcess from win32com.client import ( VARIANT, CastTo, DispatchBaseClass, Record, constants, gencache, register_record_class, ) from win32com.universal import RegisterInterfaces from win32process import GetProcessMemoryInfo # This test uses a Python implemented COM server - ensure correctly registered. win32com.test.util.RegisterPythonServer( os.path.join(os.path.dirname(__file__), "..", "servers", "test_pycomtest.py"), "Python.Test.PyCOMTest", ) try: gencache.EnsureModule( "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1, bForDemand=False ) except pythoncom.com_error as error: importMsg = """*** PyCOMTest is not installed *** PyCOMTest is a Python test specific COM client and server. It is likely this server is not installed on this machine To install the server, you must get the win32com sources and build it using MS Visual C++""" print(f"The PyCOMTest module can not be located or generated.\n{importMsg}\n") raise RuntimeError(importMsg) from error verbose = 0 # Subclasses of pythoncom.com_record. # Registration is performed in 'TestGenerated'. class TestStruct1(pythoncom.com_record): __slots__ = () TLBID = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}" MJVER = 1 MNVER = 1 LCID = 0 GUID = "{7A4CE6A7-7959-4E85-A3C0-B41442FF0F67}" class TestStruct2(pythoncom.com_record): __slots__ = () TLBID = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}" MJVER = 1 MNVER = 1 LCID = 0 GUID = "{78F0EA07-B7CF-42EA-A251-A4C6269F76AF}" class TestStruct3(pythoncom.com_record): __slots__ = () TLBID = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}" MJVER = 1 MNVER = 1 LCID = 0 GUID = "{865045EB-A7AE-4E88-B102-E2C5B97A64B6}" # We don't need to stick with the struct name in the TypeLibrary for the subclass name. # The following class has the same GUID as TestStruct2 from the TypeLibrary. class ArrayOfStructsTestStruct(pythoncom.com_record): __slots__ = () TLBID = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}" MJVER = 1 MNVER = 1 LCID = 0 GUID = "{78F0EA07-B7CF-42EA-A251-A4C6269F76AF}" class NotInTypeLibraryTestStruct(pythoncom.com_record): __slots__ = () TLBID = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}" MJVER = 1 MNVER = 1 LCID = 0 GUID = "{79BB6AC3-12DE-4AC5-88AC-225C29A58043}" def check_get_set(func, arg): got = func(arg) assert got == arg, f"{func} failed - expected {arg!r}, got {got!r}" def check_get_set_raises(exc, func, arg): try: got = func(arg) except exc as e: pass # what we expect! else: raise AssertionError( f"{func} with arg {arg!r} didn't raise {exc} - returned {got!r}" ) def progress(*args): if verbose: for arg in args: print(arg, end=" ") print() def TestApplyResult(fn, args, result): try: fnName = str(fn).split()[1] except: fnName = str(fn) progress("Testing ", fnName) pref = "function " + fnName rc = fn(*args) assert rc == result, f"{pref} failed - result not {result!r} but {rc!r}" def TestConstant(constName, pyConst): try: comConst = getattr(constants, constName) except: raise AssertionError(f"Constant {constName} missing") assert comConst == pyConst, ( f"Constant value wrong for {constName} - got {comConst}, wanted {pyConst}" ) def GetMemoryUsage(): pid = GetCurrentProcessId() PROCESS_QUERY_INFORMATION = 0x0400 PROCESS_VM_READ = 0x0010 hprocess = OpenProcess(PROCESS_QUERY_INFORMATION | PROCESS_VM_READ, False, pid) mem_info = GetProcessMemoryInfo(hprocess) CloseHandle(hprocess) return mem_info["WorkingSetSize"] # Simple handler class. This demo only fires one event. class RandomEventHandler: def _Init(self): self.fireds = {} def OnFire(self, no): try: self.fireds[no] += 1 except KeyError: self.fireds[no] = 0 def OnFireWithNamedParams(self, no, a_bool, out1, out2): # This test exists mainly to help with an old bug, where named # params would come in reverse. Missing = pythoncom.Missing if no is not Missing: # We know our impl called 'OnFire' with the same ID assert no in self.fireds assert no + 1 == out1, "expecting 'out1' param to be ID+1" assert no + 2 == out2, "expecting 'out2' param to be ID+2" # The middle must be a boolean. assert a_bool is Missing or isinstance(a_bool, bool), "middle param not a bool" return out1 + 2, out2 + 2 def _DumpFireds(self): if not self.fireds: print("ERROR: Nothing was received!") for firedId, no in self.fireds.items(): progress(f"ID {firedId} fired {no} times") # Test everything which can be tested using both the "dynamic" and "generated" # COM objects (or when there are very subtle differences) def TestCommon(o, is_generated): progress("Getting counter") counter = o.GetSimpleCounter() TestCounter(counter, is_generated) progress("Checking default args") rc = o.TestOptionals() assert rc[:-1] == ("def", 0, 1) and abs(rc[-1] - 3.14) <= 0.01, ( "Did not get the optional values correctly", rc, ) rc = o.TestOptionals("Hi", 2, 3, 1.1) assert rc[:-1] == ("Hi", 2, 3) and abs(rc[-1] - 1.1) <= 0.01, ( "Did not get the specified optional values correctly", rc, ) rc = o.TestOptionals2(0) assert rc == (0, "", 1), ("Did not get the optional2 values correctly", rc) rc = o.TestOptionals2(1.1, "Hi", 2) assert rc[1:] == ("Hi", 2) and abs(rc[0] - 1.1) <= 0.01, ( "Did not get the specified optional2 values correctly", rc, ) progress("Checking getting/passing IUnknown") check_get_set(o.GetSetUnknown, o) progress("Checking getting/passing IDispatch") # This might be called with either the interface or the CoClass - but these # functions always return from the interface. expected_class = o.__class__ # CoClass instances have `default_interface` expected_class = getattr(expected_class, "default_interface", expected_class) assert isinstance(o.GetSetDispatch(o), expected_class), ( f"GetSetDispatch failed: {o.GetSetDispatch(o)!r}" ) progress("Checking getting/passing IDispatch of known type") expected_class = o.__class__ expected_class = getattr(expected_class, "default_interface", expected_class) assert o.GetSetInterface(o).__class__ == expected_class, "GetSetDispatch failed" progress("Checking misc args") check_get_set(o.GetSetVariant, 4) check_get_set(o.GetSetVariant, "foo") check_get_set(o.GetSetVariant, o) # signed/unsigned. check_get_set(o.GetSetInt, 0) check_get_set(o.GetSetInt, -1) check_get_set(o.GetSetInt, 1) check_get_set(o.GetSetUnsignedInt, 0) check_get_set(o.GetSetUnsignedInt, 1) check_get_set(o.GetSetUnsignedInt, 0x80000000) # -1 is a special case - we accept a negative int (silently converting to unsigned) # but when getting it back we convert it to a long. assert o.GetSetUnsignedInt(-1) == 0xFFFFFFFF, "unsigned -1 failed" check_get_set(o.GetSetLong, 0) check_get_set(o.GetSetLong, -1) check_get_set(o.GetSetLong, 1) check_get_set(o.GetSetUnsignedLong, 0) check_get_set(o.GetSetUnsignedLong, 1) check_get_set(o.GetSetUnsignedLong, 0x80000000) # -1 is a special case - see above. assert o.GetSetUnsignedLong(-1) == 0xFFFFFFFF, "unsigned -1 failed" # We want to explicitly test > 32 bits. # 'maxsize+1' is no good on 64bit platforms as it's 65 bits! big = 2147483647 for l in big, big + 1, 1 << 65: check_get_set(o.GetSetVariant, l) progress("Checking structs") r = o.GetStruct() assert r.int_value == 99 and str(r.str_value) == "Hello from C++" assert o.DoubleString("foo") == "foofoo" progress("Checking var args") o.SetVarArgs("Hi", "There", "From", "Python", 1) assert o.GetLastVarArgs() == ( "Hi", "There", "From", "Python", 1, ), f"VarArgs failed -{o.GetLastVarArgs()}" progress("Checking arrays") l = [] TestApplyResult(o.SetVariantSafeArray, (l,), len(l)) l = [1, 2, 3, 4] TestApplyResult(o.SetVariantSafeArray, (l,), len(l)) TestApplyResult( o.CheckVariantSafeArray, ( ( 1, 2, 3, 4, ), ), 1, ) # and binary TestApplyResult(o.SetBinSafeArray, (memoryview(b"foo\0bar"),), 7) progress("Checking properties") o.LongProp = 3 assert o.LongProp == o.IntProp == 3, ( f"Property value wrong - got {o.LongProp}/{o.IntProp}" ) o.LongProp = o.IntProp = -3 assert o.LongProp == o.IntProp == -3, ( f"Property value wrong - got {o.LongProp}/{o.IntProp}" ) # This number fits in an unsigned long. Attempting to set it to a normal # long will involve overflow, which is to be expected. But we do # expect it to work in a property explicitly a VT_UI4. check = 3 * 10**9 o.ULongProp = check assert o.ULongProp == check, ( f"Property value wrong - got {o.ULongProp} (expected {check})" ) TestApplyResult(o.Test, ("Unused", 99), 1) # A bool function TestApplyResult(o.Test, ("Unused", -1), 1) # A bool function TestApplyResult(o.Test, ("Unused", True), 1) # A bool function TestApplyResult(o.Test, ("Unused", 0), 0) TestApplyResult(o.Test, ("Unused", False), 0) assert o.DoubleString("foo") == "foofoo" TestConstant("ULongTest1", 0xFFFFFFFF) TestConstant("ULongTest2", 0x7FFFFFFF) TestConstant("LongTest1", -0x7FFFFFFF) TestConstant("LongTest2", 0x7FFFFFFF) TestConstant("UCharTest", 255) TestConstant("CharTest", -1) # 'Hello World', but the 'r' is the "Registered" sign (\xae) TestConstant("StringTest", "Hello Wo\xaeld") progress("Checking dates and times") # For now *all* times passed must be tz-aware. now = win32timezone.now() # but conversion to and from a VARIANT loses sub-second... now = now.replace(microsecond=0) later = now + datetime.timedelta(seconds=1) TestApplyResult(o.EarliestDate, (now, later), now) # The below used to fail with `ValueError: microsecond must be in 0..999999` - see #1655 # https://planetcalc.com/7027/ says that float is: Sun, 25 Mar 1951 7:23:49 am assert o.MakeDate(18712.308206013888) == datetime.datetime.fromisoformat( "1951-03-25 07:23:49+00:00" ) progress("Checking currency") # currency. pythoncom.__future_currency__ = 1 assert o.CurrencyProp == 0, f"Expecting 0, got {o.CurrencyProp!r}" for val in ("1234.5678", "1234.56", "1234"): o.CurrencyProp = decimal.Decimal(val) assert o.CurrencyProp == decimal.Decimal(val), f"{val} got {o.CurrencyProp!r}" v1 = decimal.Decimal("1234.5678") TestApplyResult(o.DoubleCurrency, (v1,), v1 * 2) v2 = decimal.Decimal("9012.3456") TestApplyResult(o.AddCurrencies, (v1, v2), v1 + v2) progress("Checking decimal type") assert o.DecimalProp == 0, f"Expecting 0, got {o.DecimalProp!r}" for val in ( "1234", "123456789.1234", "-987654321.9876", "0.1234", "-0.1234", ): o.DecimalProp = decimal.Decimal(val) assert o.DecimalProp == decimal.Decimal(val), f"{val} got {o.DecimalProp!r}" v1 = decimal.Decimal("1234.5678") TestApplyResult(o.DoubleDecimal, (v1,), v1 * 2) v2 = decimal.Decimal("654.321") TestApplyResult(o.AddDecimals, (v1, v2), v1 + v2) TestTrickyTypesWithVariants(o, is_generated) progress("Checking win32com.client.VARIANT") TestPyVariant(o, is_generated) def TestTrickyTypesWithVariants(o, is_generated): # Test tricky stuff with type handling and generally only works with # "generated" support but can be worked around using VARIANT. if is_generated: got = o.TestByRefVariant(2) else: v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, 2) o.TestByRefVariant(v) got = v.value assert got == 4, "TestByRefVariant failed" if is_generated: got = o.TestByRefString("Foo") else: v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Foo") o.TestByRefString(v) got = v.value assert got == "FooFoo", "TestByRefString failed" # check we can pass ints as a VT_UI1 vals = [1, 2, 3, 4] if is_generated: arg = vals else: arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI1, vals) TestApplyResult(o.SetBinSafeArray, (arg,), len(vals)) # safearrays of doubles and floats vals = [0, 1.1, 2.2, 3.3] if is_generated: arg = vals else: arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R8, vals) TestApplyResult(o.SetDoubleSafeArray, (arg,), len(vals)) if is_generated: arg = vals else: arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R4, vals) TestApplyResult(o.SetFloatSafeArray, (arg,), len(vals)) vals = [1.1, 2.2, 3.3, 4.4] expected = (1.1 * 2, 2.2 * 2, 3.3 * 2, 4.4 * 2) if is_generated: TestApplyResult(o.ChangeDoubleSafeArray, (vals,), expected) else: arg = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_R8, vals) o.ChangeDoubleSafeArray(arg) assert arg.value == expected, "ChangeDoubleSafeArray got the wrong value" if is_generated: got = o.DoubleInOutString("foo") else: v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "foo") o.DoubleInOutString(v) got = v.value assert got == "foofoo", got val = decimal.Decimal("1234.5678") if is_generated: got = o.DoubleCurrencyByVal(val) else: v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_CY, val) o.DoubleCurrencyByVal(v) got = v.value assert got == val * 2 val = decimal.Decimal("123456789.1234") if is_generated: got = o.DoubleDecimalByVal(val) else: v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_DECIMAL, val) o.DoubleDecimalByVal(v) got = v.value assert got == val * 2 def TestDynamic(): progress("Testing Dynamic") import win32com.client.dynamic o = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest") TestCommon(o, False) counter = win32com.client.dynamic.DumbDispatch("PyCOMTest.SimpleCounter") TestCounter(counter, False) # Dynamic doesn't know this should be an int, so we get a COM # TypeMismatch error. try: check_get_set_raises(ValueError, o.GetSetInt, "foo") raise AssertionError("no exception raised") except pythoncom.com_error as exc: if exc.hresult != winerror.DISP_E_TYPEMISMATCH: raise arg1 = VARIANT(pythoncom.VT_R4 | pythoncom.VT_BYREF, 2.0) arg2 = VARIANT(pythoncom.VT_BOOL | pythoncom.VT_BYREF, True) arg3 = VARIANT(pythoncom.VT_I4 | pythoncom.VT_BYREF, 4) o.TestInOut(arg1, arg2, arg3) assert arg1.value == 4.0, arg1 assert arg2.value == False assert arg3.value == 8 # damn - props with params don't work for dynamic objects :( # o.SetParamProp(0, 1) # assert o.ParamProp(0) == 1, o.paramProp(0) def TestStructByref(o, r): progress("Checking struct byref as [ in, out ] parameter") mod_r = o.ModifyStruct(r) # If 'TestStruct1' was registered as an instantiable subclass # of pythoncom.com_record, the return value should have this type. if isinstance(r, TestStruct1): assert type(mod_r) is TestStruct1 else: assert type(mod_r) is pythoncom.com_record # We expect the input value to stay unchanged assert r.int_value == 99 and str(r.str_value) == "Hello from C++" # and the return value to reflect the modifications performed on the COM server side assert ( mod_r.int_value == 100 and str(mod_r.str_value) == "Nothing is as constant as change" ) def TestArrayOfStructs(o, test_rec): progress("Testing struct with SAFEARRAY(VT_RECORD) fields.") rec_list = [] for i in range(3): # If 'ArrayOfStructsTestStruct' and 'TestStruct1' were registered as instantiable # subclasses of pythoncom.com_record, we expect to work with these types. if isinstance(test_rec, ArrayOfStructsTestStruct): rec = TestStruct1() assert type(rec) is TestStruct1 else: rec = Record("TestStruct1", o) assert type(rec) is pythoncom.com_record rec.str_value = "This is record number" rec.int_value = i + 1 rec_list.append(rec) test_rec.array_of_records = rec_list test_rec.rec_count = i + 1 assert o.VerifyArrayOfStructs(test_rec) def TestNestedStructs(o): # Create an instance of a Record type with a nested Record field. outer = TestStruct3() # Initialize the Record fields including the fields of the nested Record. outer.id = 7.0 outer.a_struct_field.int_value = 33 outer.a_struct_field.str_value = "Fibonacci" outer.array_of_double = (1.0, 1.0, 2.0, 3.0, 5.0, 8.0, 13.0) # We expect the representation to include the nested Record instance field values. assert ( str(outer) == "com_struct(a_struct_field=com_struct(int_value=33, " "str_value='Fibonacci'), array_of_double=(1.0, 1.0, " "2.0, 3.0, 5.0, 8.0, 13.0), id=7.0)" ) # Create a seperate instance of the nested Record type. inner = TestStruct1() # Initialize it with the same values as the nested instance above. inner.int_value = 33 inner.str_value = "Fibonacci" # We expect the types of this instace and the nested instance to be equal. assert type(outer.a_struct_field) is TestStruct1 # We expect that their fields have the same values. assert outer.a_struct_field == inner # We expect that nevertheless they are different instance objects. assert outer.a_struct_field is not inner # Get a nested Record returned from a method. nested = o.GetNestedStruct() # We expect it to have the same field values as the 'outer' Record instance. assert nested == outer # Access the inner Record directly. assert nested.a_struct_field.int_value == inner.int_value assert nested.a_struct_field.str_value == inner.str_value def TestNestedArrays(o): # First we test the assignment of a nested sequence of Records # to a Record member attribute, followed by the retrieval of the # multidimensional SAFEARRAY from the Record member attribute. # Create a nested 3 dimensional tuple of COM Records. record_tuple = tuple( [ tuple([tuple([TestStruct1() for i in range(3)]) for j in range(5)]) for k in range(4) ] ) # Assign a different integer identifier to each Record in the nested tuple. for k in range(4): for j in range(5): for i in range(3): record_tuple[k][j][i].int_value = k * 15 + j * 3 + i # Create an instance of a COM Record that has a member of type # SAFEARRAY(TestStruct1) and assign the nested tuple to this member. rec_with_multidim_sa_of_rec = ArrayOfStructsTestStruct() rec_with_multidim_sa_of_rec.array_of_records = record_tuple # Now retrieve a tuple from the Record member and check that # it is equal to our input nested tuple but not the same object. tuple_retrieved_from_rec = rec_with_multidim_sa_of_rec.array_of_records assert tuple_retrieved_from_rec == record_tuple assert tuple_retrieved_from_rec is not record_tuple # Next we test passing a multidimensional SAFEARRAY of Records # to a COM method that modifies the Records in the SAFEARRAY. # The test seems a little convoluted. However, it should show # that we got the multidimensional indexing right. # First step: # We create a nested sequence of COM Records. record_tuple = tuple( [ tuple([tuple([TestStruct3() for i in range(3)]) for j in range(5)]) for k in range(4) ] ) # Second step: # We create a nested sequence of doubles. float_tuple = tuple( [ tuple( [tuple([float(i + 3 * j + 15 * k) for i in range(3)]) for j in range(5)] ) for k in range(4) ] ) # Third step: # We assign the nested sequence of doubles to the SAFEARRAY member attribute # in each of the Records in the nested Record sequence. # In addition we also assign a unique identifier to each of the Records. for k in range(4): for j in range(5): for i in range(3): record_tuple[k][j][i].id = float(k * 15 + j * 3 + i) record_tuple[k][j][i].array_of_double = float_tuple # Now we use the nested sequence of Records in the call to a COM method # that modifies the Records. Note that the array dimension sizes are # hard wired in the COM method. array_of_structs = o.ModifyArrayOfStructs(record_tuple) # The method should have multiplied each element of each of the # SAFEARRAY(double) Record members by the id of the respective Record. for k in range(4): for j in range(5): for i in range(3): rec = array_of_structs[k][j][i] for n in range(4): for m in range(5): for l in range(3): f = float_tuple[n][m][l] assert rec.array_of_double[n][m][l] == f * rec.id def TestGenerated(): # Create an instance of the server. from win32com.client.gencache import EnsureDispatch o = EnsureDispatch("PyCOMTest.PyCOMTest") TestCommon(o, True) counter = EnsureDispatch("PyCOMTest.SimpleCounter") TestCounter(counter, True) # This dance lets us get a CoClass even though it's not explicitly registered. # This is `CoPyComTest` from win32com.client.CLSIDToClass import GetClass coclass_o = GetClass("{8EE0C520-5605-11D0-AE5F-CADD4C000000}")() TestCommon(coclass_o, True) # Test the regression reported in #1753 assert bool(coclass_o) # This is `CoSimpleCounter` and the counter tests should work. coclass = GetClass("{B88DD310-BAE8-11D0-AE86-76F2C1000000}")() TestCounter(coclass, True) # Test plain pythoncom.com_record structs. progress("Testing baseclass pythoncom.com_record structs.") # Test pythoncom.com_record as an [out] parameter. r = o.GetOutStruct() assert type(r) is pythoncom.com_record assert r.int_value == 99 and str(r.str_value) == "Luftballons" # Test pythoncom.com_record as a retval: r = o.GetStruct() assert type(r) is pythoncom.com_record assert r.int_value == 99 and str(r.str_value) == "Hello from C++" TestStructByref(o, r) test_rec = Record("TestStruct2", o) assert type(test_rec) is pythoncom.com_record TestArrayOfStructs(o, test_rec) progress("Testing registration of pythoncom.com_record subclasses.") # Instantiating a pythoncom.com_record subclass, which has proper GUID attributes, # does raise a TypeError, as long as we have not registered it. try: r_sub = TestStruct1() except TypeError: pass except Exception as e: raise AssertionError from e else: raise AssertionError # Register the subclasses in pythoncom. register_record_class(TestStruct1) register_record_class(ArrayOfStructsTestStruct) register_record_class(TestStruct3) # Now the type of the instance is the registered subclass. r_sub = TestStruct1() assert type(r_sub) is TestStruct1 # Now also the 'Record' factory function returns an instance of the registered subtype. r_sub = Record("TestStruct1", o) assert type(r_sub) is TestStruct1 # It should not be possible to register multiple classes with the same GUID, e.g. # 'TestStruct2' has the same GUID class attribute value as 'ArrayOfStructsTestStruct'. check_get_set_raises(ValueError, register_record_class, TestStruct2) # Also registering a class with a GUID that is not in the TypeLibrary should fail. check_get_set_raises(TypeError, register_record_class, NotInTypeLibraryTestStruct) progress("Testing subclasses of pythoncom.com_record.") # Test assignment and retrieval of a Record field. member_struct = TestStruct1() member_struct.int_value = 42 member_struct.str_value = "The meaning of life, the universe and everything." parent_struct = TestStruct3() parent_struct.a_struct_field = member_struct retrieved_struct = parent_struct.a_struct_field assert retrieved_struct == member_struct # Test a pythoncom.com_record subclass as an [out] parameter. r = o.GetOutStruct() # After 'TestStruct1' was registered as an instantiable subclass # of pythoncom.com_record, the return value should have this type. assert type(r) is TestStruct1 assert r.int_value == 99 and str(r.str_value) == "Luftballons" # Perform the 'Byref' and 'ArrayOfStruct tests using the registered subclasses. r = o.GetStruct() # After 'TestStruct1' was registered as an instantiable subclass # of pythoncom.com_record, the return value should have this type. assert type(r) is TestStruct1 TestStructByref(o, r) test_rec = ArrayOfStructsTestStruct() assert type(test_rec) is ArrayOfStructsTestStruct TestArrayOfStructs(o, test_rec) progress("Testing nested Records.") TestNestedStructs(o) progress("Testing multidimensional SAFEARRAYS of Records and double.") TestNestedArrays(o) # Test initialization of registered pythoncom.com_record subclasses. progress("Testing initialization of pythoncom.com_record subclasses.") buf = o.GetStruct().__reduce__()[1][5] test_rec = TestStruct1(buf) assert test_rec.int_value == 99 and str(test_rec.str_value) == "Hello from C++" # XXX - this is failing in dynamic tests, but should work fine. i1, i2 = o.GetMultipleInterfaces() # Yay - is now an instance returned! assert isinstance(i1, DispatchBaseClass) and isinstance(i2, DispatchBaseClass), ( f"GetMultipleInterfaces did not return instances - got '{i1}', '{i2}'" ) del i1 del i2 # Generated knows to only pass a 32bit int, so should fail. check_get_set_raises(OverflowError, o.GetSetInt, 0x80000000) check_get_set_raises(OverflowError, o.GetSetLong, 0x80000000) # Generated knows this should be an int, so raises ValueError check_get_set_raises(ValueError, o.GetSetInt, "foo") check_get_set_raises(ValueError, o.GetSetLong, "foo") # Pass some non-sequence objects to our array decoder, and watch it fail. try: o.SetVariantSafeArray("foo") raise AssertionError("Expected a type error") except TypeError: pass try: o.SetVariantSafeArray(666) raise AssertionError("Expected a type error") except TypeError: pass o.GetSimpleSafeArray(None) TestApplyResult(o.GetSimpleSafeArray, (None,), tuple(range(10))) resultCheck = tuple(range(5)), tuple(range(10)), tuple(range(20)) TestApplyResult(o.GetSafeArrays, (None, None, None), resultCheck) l = [] TestApplyResult(o.SetIntSafeArray, (l,), len(l)) l = [1, 2, 3, 4] TestApplyResult(o.SetIntSafeArray, (l,), len(l)) ll = [1, 2, 3, 0x100000000] TestApplyResult(o.SetLongLongSafeArray, (ll,), len(ll)) TestApplyResult(o.SetULongLongSafeArray, (ll,), len(ll)) # check freeing of safe arrays mem_before = GetMemoryUsage() o.GetByteArray(50 * 1024 * 1024) mem_after = GetMemoryUsage() delta = mem_after - mem_before assert delta < 1024 * 1024, f"Memory not freed - delta {delta / (1024 * 1024)} MB" # Tell the server to do what it does! TestApplyResult(o.Test2, (constants.Attr2,), constants.Attr2) TestApplyResult(o.Test3, (constants.Attr2,), constants.Attr2) TestApplyResult(o.Test4, (constants.Attr2,), constants.Attr2) TestApplyResult(o.Test5, (constants.Attr2,), constants.Attr2) TestApplyResult(o.Test6, (constants.WideAttr1,), constants.WideAttr1) TestApplyResult(o.Test6, (constants.WideAttr2,), constants.WideAttr2) TestApplyResult(o.Test6, (constants.WideAttr3,), constants.WideAttr3) TestApplyResult(o.Test6, (constants.WideAttr4,), constants.WideAttr4) TestApplyResult(o.Test6, (constants.WideAttr5,), constants.WideAttr5) TestApplyResult(o.TestInOut, (2.0, True, 4), (4.0, False, 8)) o.SetParamProp(0, 1) assert o.ParamProp(0) == 1, o.paramProp(0) # Make sure CastTo works - even though it is only casting it to itself! o2 = CastTo(o, "IPyCOMTest") assert o == o2, "CastTo should have returned the same object" # Do the connection point thing... # Create a connection object. progress("Testing connection points") o2 = win32com.client.DispatchWithEvents(o, RandomEventHandler) TestEvents(o2, o2) # and a plain "WithEvents". handler = win32com.client.WithEvents(o, RandomEventHandler) TestEvents(o, handler) progress("Finished generated .py test.") def TestEvents(o, handler): sessions = [] handler._Init() try: for i in range(3): session = o.Start() sessions.append(session) time.sleep(0.5) finally: # Stop the servers for session in sessions: o.Stop(session) handler._DumpFireds() handler.close() def _TestPyVariant(o, is_generated, val, checker=None): if is_generated: vt, got = o.GetVariantAndType(val) else: # Gotta supply all 3 args with the last 2 being explicit variants to # get the byref behaviour. var_vt = VARIANT(pythoncom.VT_UI2 | pythoncom.VT_BYREF, 0) var_result = VARIANT(pythoncom.VT_VARIANT | pythoncom.VT_BYREF, 0) o.GetVariantAndType(val, var_vt, var_result) vt = var_vt.value got = var_result.value if checker is not None: checker(got) return # default checking. assert vt == val.varianttype, (vt, val.varianttype) # Handle our safe-array test - if the passed value is a list of variants, # compare against the actual values. if isinstance(val.value, (tuple, list)): check = [v.value if isinstance(v, VARIANT) else v for v in val.value] # pythoncom always returns arrays as tuples. got = list(got) else: check = val.value assert type(check) == type(got), (type(check), type(got)) assert check == got, (check, got) def _TestPyVariantFails(o, is_generated, val, exc): try: _TestPyVariant(o, is_generated, val) raise AssertionError(f"Setting {val!r} didn't raise {exc}") except exc: pass def TestPyVariant(o, is_generated): _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_UI1, 1)) _TestPyVariant( o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI4, [1, 2, 3]) ) _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_BSTR, "hello")) _TestPyVariant( o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_BSTR, ["hello", "there"]), ) def check_dispatch(got): assert isinstance(got._oleobj_, pythoncom.TypeIIDs[pythoncom.IID_IDispatch]) _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_DISPATCH, o), check_dispatch) _TestPyVariant( o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_DISPATCH, [o]) ) # an array of variants each with a specific type. v = VARIANT( pythoncom.VT_ARRAY | pythoncom.VT_VARIANT, [ VARIANT(pythoncom.VT_UI4, 1), VARIANT(pythoncom.VT_UI4, 2), VARIANT(pythoncom.VT_UI4, 3), ], ) _TestPyVariant(o, is_generated, v) # and failures _TestPyVariantFails(o, is_generated, VARIANT(pythoncom.VT_UI1, "foo"), ValueError) def TestCounter(counter, bIsGenerated): # Test random access into container progress(f"Testing counter {counter!r}") import random for i in range(50): num = int(random.random() * len(counter)) try: # XXX - this appears broken by commit 08a14d4deb374eaa06378509cf44078ad467b9dc - # We shouldn't need to do generated differently than dynamic. if bIsGenerated: ret = counter.Item(num + 1) else: ret = counter[num] assert ret == num + 1, ( f"Random access into element {num} failed - return was {ret!r}" ) except IndexError: raise AssertionError(f"** IndexError accessing collection element {num}") num = 0 if bIsGenerated: counter.SetTestProperty(1) counter.TestProperty = 1 # Note this has a second, default arg. counter.SetTestProperty(1, 2) assert counter.TestPropertyWithDef == 0, "Unexpected property set value!" assert counter.TestPropertyNoDef(1) == 1, "Unexpected property set value!" else: pass # counter.TestProperty = 1 counter.LBound = 1 counter.UBound = 10 if counter.LBound != 1 or counter.UBound != 10: print("** Error - counter did not keep its properties") if bIsGenerated: bounds = counter.GetBounds() assert bounds[0] == 1 and bounds[1] == 10, ( "** Error - counter did not give the same properties back" ) counter.SetBounds(bounds[0], bounds[1]) for item in counter: num += 1 assert num == len(counter), ( "*** Length of counter and loop iterations don't match ***" ) assert num == 10, "*** Unexpected number of loop iterations ***" try: counter = iter(counter)._iter_.Clone() # Test Clone() and enum directly except AttributeError: # *sob* - sometimes this is a real iterator and sometimes not :/ progress("Finished testing counter (but skipped the iterator stuff") return counter.Reset() num = 0 for item in counter: num += 1 assert num == 10, f"*** Unexpected number of loop iterations - got {num} ***" progress("Finished testing counter") def TestLocalVTable(ob): # Python doesn't fully implement this interface. assert ob.DoubleString("foo") == "foofoo", "couldn't foofoo" ############################### ## ## Some vtable tests of the interface ## def TestVTable(clsctx=pythoncom.CLSCTX_ALL): # Any vtable interfaces marked as dual *should* be able to be # correctly implemented as IDispatch. ob = win32com.client.Dispatch("Python.Test.PyCOMTest") TestLocalVTable(ob) # Now test it via vtable - use some C++ code to help here as Python can't do it directly yet. tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest") testee = pythoncom.CoCreateInstance( "Python.Test.PyCOMTest", None, clsctx, pythoncom.IID_IUnknown ) # check we fail gracefully with None passed. try: tester.TestMyInterface(None) except pythoncom.com_error as details: pass # and a real object. tester.TestMyInterface(testee) def TestVTable2(): # We once crashed creating our object with the native interface as # the first IID specified. We must do it _after_ the tests, so that # Python has already had the gateway registered from last run. ob = win32com.client.Dispatch("Python.Test.PyCOMTest") iid = pythoncom.InterfaceNames["IPyCOMTest"] clsid = "Python.Test.PyCOMTest" clsctx = pythoncom.CLSCTX_SERVER try: testee = pythoncom.CoCreateInstance(clsid, None, clsctx, iid) except TypeError: # Python can't actually _use_ this interface yet, so this is # "expected". Any COM error is not. pass def TestVTableMI(): clsctx = pythoncom.CLSCTX_SERVER ob = pythoncom.CoCreateInstance( "Python.Test.PyCOMTestMI", None, clsctx, pythoncom.IID_IUnknown ) # This inherits from IStream. ob.QueryInterface(pythoncom.IID_IStream) # This implements IStorage, specifying the IID as a string ob.QueryInterface(pythoncom.IID_IStorage) # IDispatch should always work ob.QueryInterface(pythoncom.IID_IDispatch) iid = pythoncom.InterfaceNames["IPyCOMTest"] try: ob.QueryInterface(iid) except TypeError: # Python can't actually _use_ this interface yet, so this is # "expected". Any COM error is not. pass def TestQueryInterface(long_lived_server=False, iterations=5): tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest") if long_lived_server: # Create a local server t0 = win32com.client.Dispatch( "Python.Test.PyCOMTest", clsctx=pythoncom.CLSCTX_LOCAL_SERVER ) # Request custom interfaces a number of time for i in range(iterations): progress( f"Testing QueryInterface " + ("with" if long_lived_server else "without") + f" long-lived local-server #{i + 1} of {iterations}..." ) tester.TestQueryInterface() class Tester(win32com.test.util.TestCase): def testRegisterInterfacesAfterGencache(self) -> None: # We had a bug where RegisterInterfaces would fail if gencache had # already been run - exercise that here RegisterInterfaces("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1) def testVTableInProc(self) -> None: # We used to crash running this the second time - do it a few times for i in range(3): progress(f"Testing VTables in-process #{(i + 1)}...") TestVTable(pythoncom.CLSCTX_INPROC_SERVER) def testVTableLocalServer(self) -> None: for i in range(3): progress(f"Testing VTables out-of-process #{(i + 1)}...") TestVTable(pythoncom.CLSCTX_LOCAL_SERVER) def testVTable2(self): for i in range(3): TestVTable2() def testVTableMI(self): for i in range(3): TestVTableMI() def testMultiQueryInterface(self): TestQueryInterface(False, 6) # When we use the custom interface in the presence of a long-lived # local server, i.e. a local server that is already running when # we request an instance of our COM object, and remains afterwards, # then after repeated requests to create an instance of our object # the custom interface disappears -- i.e. QueryInterface fails with # E_NOINTERFACE. Set the upper range of the following test to 2 to # pass this test, i.e. TestQueryInterface(True, 2) TestQueryInterface(True, 6) def testDynamic(self): TestDynamic() def testGenerated(self): TestGenerated() if __name__ == "__main__": # XXX - todo - Complete hack to crank threading support. # Should NOT be necessary def NullThreadFunc(): pass import _thread _thread.start_new(NullThreadFunc, ()) if "-v" in sys.argv: verbose = 1 win32com.test.util.testmain()