comtypes icon indicating copy to clipboard operation
comtypes copied to clipboard

Support named args for dispmethod

Open junkmd opened this issue 1 year ago • 2 comments

#371

I was trying to implement the #400 functionality. However, I realized that it is misleading to have a function annotation that allows named arguments to be accepted, since a dispmethod called via IDispatch.Invoke will raise an error when a named (with default value) argument is passed at runtime.

So, I improved the process of instantiating DISPPARAMS so that it can also accept named arguments in dispmethod. Using _argspec passed to IDispatch.Invoke, it completes default values for optional arguments that were not passed, to ensure that the passed argument names are correct.

This added functionality is only triggered when named arguments are passed to dispmethod. Same as before, when just only positional arguments are passed, the VARIANT array is assigned to DISPPARAMS.rgvarg in the reverse order. Therefore, this change does not break backward compatibility. In the case that an element of argspec is not what the newly added processing expects, and an error is raised when passing named arguments, it can be avoided by passing only positional arguments.

The bound_named_property has also been improved to allow passing named arguments.

As for testing, I used Excel to verify that it is possible to pass named arguments to a dispmethod. I have Excel in my development environment, so I can run this test and make sure it passes. However, AppVeyor CI does not have Excel, so I am not able to fully guarantee End2End operation with CI. Instead, I generously cover the test of DISPPARAMS instantiation process, which can be executed independent of Excel and the environment. commethod (and stdmethod) were originally designed to accept named arguments, but there were no tests to do so explicitly, so I added them.

If there is a dispmethod in an environment-independent library that can easily provide fixtures, I will try to test with that object as well, so I am looking for feedback.

junkmd avatar Jun 10 '23 13:06 junkmd

CIs are passed.

memo

https://ci.appveyor.com/project/cfarrow/comtypes/builds/47271940 https://github.com/enthought/comtypes/actions/runs/5230311902/jobs/9443793826?pr=486 https://ci.appveyor.com/project/pywinauto/pywinauto/builds/47271962

junkmd avatar Jun 10 '23 23:06 junkmd

@vasily-v-ryabov

Please review this.

Not to break backwards compatibility, but since this is more of a "feature addition to allow named arguments to be passed" than a "bug fix for not being able to pass named arguments", and since there are many lines of codebase changed.

If we decide not to incorporate this into the 1.3.0 like #475, I would move #400 and this from the 1.3.0 milestone to next version milestone.

junkmd avatar Jun 11 '23 04:06 junkmd