Let checkers and IDEs know that pywintypes and pythoncom are actually dynamic modules

com/pythoncom.py

@@ -1,4 +1,13 @@
 # Magic utility that "redirects" to pythoncomXX.dll
+from typing import TYPE_CHECKING, Any
+
 import pywintypes
 
 pywintypes.__import_pywin32_system_module__("pythoncom", globals())
+
+# This module dynamically re-exports from a C-Extension.
+# Prevent attribute access issues with checkers and language servers (IDEs)
+# External usage should still prefer typeshed stubs
+if TYPE_CHECKING:
+
+    def __getattr__(name: str) -> Any: ...

com/win32com/server/exception.py

@@ -19,7 +19,7 @@
 
 # Note that we derive from com_error, which derives from builtin Exception
 # Also note that we don't support "self.args", as we don't support tuple-unpacking
-class COMException(pythoncom.com_error):  # type: ignore[name-defined] # Dynamic module
+class COMException(pythoncom.com_error):  # type: ignore[misc] # Dynamic module
     """An Exception object that is understood by the framework.
 
     If the framework is presented with an exception of type class,

pyrightconfig.json

@@ -6,7 +6,7 @@
   "enableTypeIgnoreComments": true,
   // Exclude from scanning when running pyright
   "exclude": [
-    ".git/",
+    ".git/", // Avoids scanning git branch names ending in ".py"
     "build/",
     // Vendored
     "Pythonwin/Scintilla/",
@@ -32,15 +32,12 @@
   "reportArgumentType": "none",
   "reportAttributeAccessIssue": "none",
   // FIXE: These all need to be fixed first and turned back to error
-  // some of the fixes need to be done in types-pywin32 from typeshed
   "reportCallIssue": "warning",
   "reportOperatorIssue": "warning",
   "reportOptionalCall": "warning",
   "reportOptionalIterable": "warning",
   "reportOptionalMemberAccess": "warning",
   "reportOptionalSubscript": "warning",
-  // Needs fixes in types-pywin32 and requires Python 3.8 to annotate ambiguous global variables
-  "reportUnnecessaryComparison": "warning",
   // Too many dynamically generated modules. This will require type stubs to properly fix.
   "reportMissingImports": "warning",
   // IDEM, but happens when pywin32 is not in site-packages but module is found from typeshed.
@@ -50,6 +47,6 @@
   "reportMissingModuleSource": "none",
   // External type stubs may not be completable, and this will require type stubs for dynamic modules.
   "reportMissingTypeStubs": "information",
-  // Use Flake8/Pycln/Ruff instead
+  // Use Pycln/Ruff instead
   "reportUnusedImport": "none",
 }

win32/Lib/pywintypes.py

@@ -3,6 +3,7 @@
 import importlib.util
 import os
 import sys
+from typing import TYPE_CHECKING, Any
 
 
 def __import_pywin32_system_module__(modname, globs):
@@ -122,3 +123,10 @@ def __import_pywin32_system_module__(modname, globs):
 
 
 __import_pywin32_system_module__("pywintypes", globals())
+
+# This module dynamically re-exports from a C-Extension.
+# Prevent attribute access issues with checkers and language servers (IDEs)
+# External usage should still prefer typeshed stubs
+if TYPE_CHECKING:
+
+    def __getattr__(name: str) -> Any: ...