importing the wrapper-module into the friendly-module using an abstracted name, __wrapper_module__ (enthought#493)

* add test

* add the `__wrapper_module__` to friendly modules

By doing so, it is possible to achieve a combination of friendly-modules
functionalities and improved access to the wrapper-modules.

Author: junkmd

comtypes/test/test_client.py

@@ -74,6 +74,10 @@ def test_no_replacing_Patch_namespace(self):
         # NOTE: `WindowsInstaller`, which has `Patch` definition in dll.
         comtypes.client.GetModule("msi.dll")
 
+    def test_abstracted_wrapper_module_in_friendly_module(self):
+        mod = comtypes.client.GetModule("scrrun.dll")
+        self.assertTrue(hasattr(mod, "__wrapper_module__"))
+
     def test_raises_typerror_if_takes_unsupported(self):
         with self.assertRaises(TypeError):
             comtypes.client.GetModule(object())

comtypes/tools/codegenerator.py

@@ -589,6 +589,7 @@ def generate_friendly_code(self, modname: str) -> str:
         Such as "comtypes.gen.stdole" and "comtypes.gen.Excel".
         """
         output = io.StringIO()
+        print(f"import {modname} as __wrapper_module__", file=output)
         txtwrapper = textwrap.TextWrapper(
             subsequent_indent="    ", initial_indent="    ", break_long_words=False
         )