nvda
565a6680 - Fix generation of developer documentation for modules which rely on our generated comInterfaces (#14016)

Commit
3 years ago
Fix generation of developer documentation for modules which rely on our generated comInterfaces (#14016) one of the prerequisites for eventual further work on #12971 Summary of the issue: When trying to generate developer documentation various modules cannot be imported, and as a result it is impossible to generate any documentation from their docstrings. In most cases this is caused by the fact that they try to import various com interfaces from our comInterfaces package, which cannot work since we set its path in a particular way at runtime. The example error for one of the modules is as follows: WARNING: autodoc: failed to import module 'IAccessibleHandler'; the following exception was raised: cannot import name '_CE3F726E_D1D3_44FE_B995_FF1DB3B48B2B_0_1_3' from 'comtypes.gen' (D:\my_repos\nvda\.venv\lib\site-packages\comtypes\gen\__init__.py) Description of user facing changes None Description of development approach During developer documentation build our com interfaces directory is appended to the comtypes.gen search path, to match the behavior at runtime.
Author
Parents
Loading