[junkmd]

Summary

• Clarify CodeGenerator type annotations and centralize explicit dispatch
• Mark applicable type-description classes as final
• Replace exact type comparisons with isinstance
• Model IUnknown and IDispatch as simplified ComInterface definitions in tlbparser
• Remove the Typedef[None] alias and related special handling

Background and purpose

CodeGenerator previously obtained type names dynamically and invoked generation methods through getattr. As a result, the types accepted as input and their corresponding handlers were not clearly visible to the type system.
By explicitly annotating the types accepted by generate and dispatching supported types explicitly, invalid type handling can be detected earlier.

The dispatch logic was also duplicated across multiple paths, including interface generation.
Centralizing it ensures that the same type is handled consistently regardless of the path used, making the code-generation flow easier to follow and reducing the risk of missing updates when types are added or changed.

The existing type(...) is ... comparisons triggered E721 violations in static analysis. Replacing them directly with isinstance would potentially allow subclasses and change the intended behavior.
Marking the concrete types produced by tlbparser and handled by CodeGenerator as final preserves the original intent of accepting only the supported concrete types while allowing isinstance to be used safely.

tlbparser previously represented IUnknown and IDispatch as empty typedefs. This did not reflect the interfaces used by the generated type descriptions.
Defining simplified ComInterface models with the practical COM members required by their use cases makes the mapping more accurate without attempting to reproduce every detail from stdole.
Because Typedef no longer contains None, the Typedef[None] alias and its related special handling also be removed.

Verification points

• Each type produced by tlbparser is dispatched to the correct generation method
• Unsupported types are reported as TypeError instead of being invoked implicitly
• Existing code-generation results remain unchanged for interfaces, structures, pointers, and related types
• IUnknown and IDispatch are mapped to the expected practical interface definitions
• Typedef no longer requires support for None
• Static-analysis issues, including E721, are resolved

[codecov-commenter]

Codecov Report

❌ Patch coverage is 96.84211% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 89.61%. Comparing base (b8e3b31) to head (3cf2e3c).

Files with missing lines	Patch %	Lines
comtypes/tools/codegenerator/codegenerator.py	95.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #975      +/-   ##
==========================================
+ Coverage   89.57%   89.61%   +0.04%     
==========================================
  Files         143      143              
  Lines       14175    14247      +72     
==========================================
+ Hits        12697    12768      +71     
- Misses       1478     1479       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.