VirtualDesktop 1.4.0__tar.gz → 1.4.1__tar.gz

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VirtualDesktop
-Version: 1.4.0
+Version: 1.4.1
 Summary: Multi-window virtual-display workspaces on Windows: one pip install bootstraps the virtual display driver, hosts programs on a virtual or private desktop, keeps them off the physical screens, and hands out real window handles for automation and PrintWindow capture.
 Author: VirtualDesktop contributors
 License: MIT License
@@ -47,6 +47,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: Pillow>=9.0
+Requires-Dist: comtypes>=1.2.0
 Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == "test"
 Provides-Extra: build
@@ -78,7 +79,8 @@ pip install VirtualDesktop        # pip
 uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 ```
 
-运行时依赖只有 **Pillow**。若国内镜像同步滞后导致找不到最新版，加
+运行时依赖：**Pillow**（帧图像）与 **comtypes**（UI Automation 是 COM API）。不需要 pywin32——
+库访问 Win32 全部走 ctypes。若国内镜像同步滞后导致找不到最新版，加
 `--default-index https://pypi.org/simple`（uv）或 `-i https://pypi.org/simple`（pip）。
 
 | | 私有桌面 | 虚拟显示器 |
@@ -145,7 +147,7 @@ uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 | 系统 | Windows 10 / 11（无 IddCx 版本要求） |
 | 权限 | 当前用户即可，**不提权** |
 | 驱动 | 不需要 |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 基本用法
 
@@ -214,7 +216,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | `agent.exec("python 代码")` | 在桌面内跑任意 Python，返回打印内容 |
 
 `exec` 是逃生舱：里面的代码能 `import VirtualDesktop`、能用 `list_windows()`、`CaptureEngine`，
-也能用你自己装的任何库。代理本身只依赖 ctypes，不需要额外安装。
+也能用你自己装的任何库。代理本身只依赖 ctypes 与 comtypes。
 
 ### 私有桌面不能截图
 
@@ -296,7 +298,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | 系统 | **Windows 10 1809 (build 17763) 或更高**（更低版本没有 IddCx 框架） |
 | 权限 | 安装/卸载驱动需要管理员，弹**一次 UAC** |
 | 驱动 | 首次使用时自动下载安装（也可预先装好） |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 装驱动
 

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/README.md

@@ -22,7 +22,8 @@ pip install VirtualDesktop        # pip
 uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 ```
 
-运行时依赖只有 **Pillow**。若国内镜像同步滞后导致找不到最新版，加
+运行时依赖：**Pillow**（帧图像）与 **comtypes**（UI Automation 是 COM API）。不需要 pywin32——
+库访问 Win32 全部走 ctypes。若国内镜像同步滞后导致找不到最新版，加
 `--default-index https://pypi.org/simple`（uv）或 `-i https://pypi.org/simple`（pip）。
 
 | | 私有桌面 | 虚拟显示器 |
@@ -89,7 +90,7 @@ uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 | 系统 | Windows 10 / 11（无 IddCx 版本要求） |
 | 权限 | 当前用户即可，**不提权** |
 | 驱动 | 不需要 |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 基本用法
 
@@ -158,7 +159,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | `agent.exec("python 代码")` | 在桌面内跑任意 Python，返回打印内容 |
 
 `exec` 是逃生舱：里面的代码能 `import VirtualDesktop`、能用 `list_windows()`、`CaptureEngine`，
-也能用你自己装的任何库。代理本身只依赖 ctypes，不需要额外安装。
+也能用你自己装的任何库。代理本身只依赖 ctypes 与 comtypes。
 
 ### 私有桌面不能截图
 
@@ -240,7 +241,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | 系统 | **Windows 10 1809 (build 17763) 或更高**（更低版本没有 IddCx 框架） |
 | 权限 | 安装/卸载驱动需要管理员，弹**一次 UAC** |
 | 驱动 | 首次使用时自动下载安装（也可预先装好） |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 装驱动
 

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/VirtualDesktop/__init__.py

@@ -1,135 +1,135 @@
-"""``VirtualDesktop`` – an offscreen window workstation for Windows.
-
-The public surface is deliberately small:
-
-* :class:`~VirtualDesktop.session.OffscreenSession` – mount, capture, restore.
-* :func:`~VirtualDesktop.session.probe_environment` – diagnostics without side effects.
-* :class:`~VirtualDesktop.driver.DriverInstaller` – explicit driver control.
-* :mod:`VirtualDesktop.errors` – every exception, each with a ``code`` and a ``hint``.
-
-Typical use::
-
-    from VirtualDesktop import OffscreenSession
-
-    with OffscreenSession(target_window_title="WeChat") as session:
-        session.mount()
-        frame = session.capture()          # PIL image
-        frame.image.save("wechat.png")
-
-Nothing is installed until ``mount()`` actually needs a virtual display, and nothing is
-moved until a target window has been found, so a failed call leaves the machine as it was.
-"""
-
-from __future__ import annotations
-
-from ._log import enable_debug_logging, get_logger
-from ._winapi import (
-    IS_WINDOWS,
-    MonitorInfo,
-    enumerate_monitors,
-    is_admin,
-    list_windows,
-    select_virtual_monitor,
-)
-from .capture import DEFAULT_METHODS, CaptureEngine, Frame, analyze_image
-from .config import DriverConfig, SessionConfig
-from .desktop import DesktopBinding, current_desktop_name, ensure_default_desktop
-from .driver import DriverInstaller, InstallReport, virtual_display_present
-from .errors import (
-    AmbiguousWindowError,
-    CaptureError,
-    ConfigError,
-    DesktopBindError,
-    DownloadError,
-    DriverInstallError,
-    DriverNotFoundError,
-    DriverVerificationError,
-    ElevationDenied,
-    ElevationRequired,
-    ExtractionError,
-    IntegrityError,
-    MissingDependencyError,
-    OffscreenMountError,
-    SessionStateError,
-    UnsupportedPlatformError,
-    WindowMountError,
-    WindowNotFoundError,
-)
-from .manifest import load_manifest
-from .session import OffscreenSession, probe_environment
-from .desktop_session import DesktopProcess, VirtualDesktop, current_desktop_name
-from .window import WindowMounter, WindowRecord, find_window, window_diagnostics
-from .workspace import SHARED, VirtualWorkspace, WorkspaceWindow
-from .agent import AgentProcess, AgentSession
-from .display_setup import configure_virtual_display, current_primary_dpi, current_primary_size
-
-__version__ = "1.4.0"
-
-__all__ = [
-    "__version__",
-    # session
-    "OffscreenSession",
-    "probe_environment",
-    # drivers
-    "DriverInstaller",
-    "InstallReport",
-    "virtual_display_present",
-    "load_manifest",
-    # windows and displays
-    "WindowMounter",
-    "WindowRecord",
-    "find_window",
-    "window_diagnostics",
-    "enumerate_monitors",
-    "select_virtual_monitor",
-    "MonitorInfo",
-    "list_windows",
-    "ensure_default_desktop",
-    "current_desktop_name",
-    "DesktopBinding",
-    # private virtual desktop (no admin, no driver)
-    "VirtualDesktop",
-    "DesktopProcess",
-    # multi-window virtual-display workspace (externally controllable)
-    "VirtualWorkspace",
-    "WorkspaceWindow",
-    "SHARED",
-    # in-desktop agent (for isolated workspaces / private desktops)
-    "AgentSession",
-    "AgentProcess",
-    # virtual display geometry
-    "configure_virtual_display",
-    "current_primary_size",
-    "current_primary_dpi",
-    # capture
-    "CaptureEngine",
-    "Frame",
-    "analyze_image",
-    "DEFAULT_METHODS",
-    # configuration
-    "DriverConfig",
-    "SessionConfig",
-    # platform helpers
-    "IS_WINDOWS",
-    "is_admin",
-    "enable_debug_logging",
-    # errors
-    "OffscreenMountError",
-    "UnsupportedPlatformError",
-    "MissingDependencyError",
-    "ConfigError",
-    "IntegrityError",
-    "DownloadError",
-    "ExtractionError",
-    "ElevationRequired",
-    "ElevationDenied",
-    "DriverInstallError",
-    "DriverNotFoundError",
-    "DriverVerificationError",
-    "DesktopBindError",
-    "WindowNotFoundError",
-    "AmbiguousWindowError",
-    "WindowMountError",
-    "CaptureError",
-    "SessionStateError",
-]
+"""``VirtualDesktop`` 鈥?an offscreen window workstation for Windows.
+
+The public surface is deliberately small:
+
+* :class:`~VirtualDesktop.session.OffscreenSession` 鈥?mount, capture, restore.
+* :func:`~VirtualDesktop.session.probe_environment` 鈥?diagnostics without side effects.
+* :class:`~VirtualDesktop.driver.DriverInstaller` 鈥?explicit driver control.
+* :mod:`VirtualDesktop.errors` 鈥?every exception, each with a ``code`` and a ``hint``.
+
+Typical use::
+
+    from VirtualDesktop import OffscreenSession
+
+    with OffscreenSession(target_window_title="WeChat") as session:
+        session.mount()
+        frame = session.capture()          # PIL image
+        frame.image.save("wechat.png")
+
+Nothing is installed until ``mount()`` actually needs a virtual display, and nothing is
+moved until a target window has been found, so a failed call leaves the machine as it was.
+"""
+
+from __future__ import annotations
+
+from ._log import enable_debug_logging, get_logger
+from ._winapi import (
+    IS_WINDOWS,
+    MonitorInfo,
+    enumerate_monitors,
+    is_admin,
+    list_windows,
+    select_virtual_monitor,
+)
+from .capture import DEFAULT_METHODS, CaptureEngine, Frame, analyze_image
+from .config import DriverConfig, SessionConfig
+from .desktop import DesktopBinding, current_desktop_name, ensure_default_desktop
+from .driver import DriverInstaller, InstallReport, virtual_display_present
+from .errors import (
+    AmbiguousWindowError,
+    CaptureError,
+    ConfigError,
+    DesktopBindError,
+    DownloadError,
+    DriverInstallError,
+    DriverNotFoundError,
+    DriverVerificationError,
+    ElevationDenied,
+    ElevationRequired,
+    ExtractionError,
+    IntegrityError,
+    MissingDependencyError,
+    OffscreenMountError,
+    SessionStateError,
+    UnsupportedPlatformError,
+    WindowMountError,
+    WindowNotFoundError,
+)
+from .manifest import load_manifest
+from .session import OffscreenSession, probe_environment
+from .desktop_session import DesktopProcess, VirtualDesktop, current_desktop_name
+from .window import WindowMounter, WindowRecord, find_window, window_diagnostics
+from .workspace import SHARED, VirtualWorkspace, WorkspaceWindow
+from .agent import AgentProcess, AgentSession
+from .display_setup import configure_virtual_display, current_primary_dpi, current_primary_size
+
+__version__ = "1.4.1"
+
+__all__ = [
+    "__version__",
+    # session
+    "OffscreenSession",
+    "probe_environment",
+    # drivers
+    "DriverInstaller",
+    "InstallReport",
+    "virtual_display_present",
+    "load_manifest",
+    # windows and displays
+    "WindowMounter",
+    "WindowRecord",
+    "find_window",
+    "window_diagnostics",
+    "enumerate_monitors",
+    "select_virtual_monitor",
+    "MonitorInfo",
+    "list_windows",
+    "ensure_default_desktop",
+    "current_desktop_name",
+    "DesktopBinding",
+    # private virtual desktop (no admin, no driver)
+    "VirtualDesktop",
+    "DesktopProcess",
+    # multi-window virtual-display workspace (externally controllable)
+    "VirtualWorkspace",
+    "WorkspaceWindow",
+    "SHARED",
+    # in-desktop agent (for isolated workspaces / private desktops)
+    "AgentSession",
+    "AgentProcess",
+    # virtual display geometry
+    "configure_virtual_display",
+    "current_primary_size",
+    "current_primary_dpi",
+    # capture
+    "CaptureEngine",
+    "Frame",
+    "analyze_image",
+    "DEFAULT_METHODS",
+    # configuration
+    "DriverConfig",
+    "SessionConfig",
+    # platform helpers
+    "IS_WINDOWS",
+    "is_admin",
+    "enable_debug_logging",
+    # errors
+    "OffscreenMountError",
+    "UnsupportedPlatformError",
+    "MissingDependencyError",
+    "ConfigError",
+    "IntegrityError",
+    "DownloadError",
+    "ExtractionError",
+    "ElevationRequired",
+    "ElevationDenied",
+    "DriverInstallError",
+    "DriverNotFoundError",
+    "DriverVerificationError",
+    "DesktopBindError",
+    "WindowNotFoundError",
+    "AmbiguousWindowError",
+    "WindowMountError",
+    "CaptureError",
+    "SessionStateError",
+]

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/VirtualDesktop/_desktop_runtime.py

@@ -242,6 +242,12 @@ def _uia_tree(hwnd: int, *, depth: int = 8, max_nodes: int = 500, view: str = "R
     """
     try:
         import comtypes.client
+
+        # ``comtypes.gen.UIAutomationClient`` is generated on first use from the type library, so
+        # importing it directly fails on a machine that has never spoken to UIA (measured: a fresh
+        # venv dies with "cannot import name 'UIAutomationClient' from 'comtypes.gen'").  GetModule
+        # generates it if needed, and is what makes this work out of the box.
+        comtypes.client.GetModule("UIAutomationCore.dll")
         from comtypes.gen import UIAutomationClient as UIA
     except Exception as exc:  # noqa: BLE001 - comtypes is optional
         return {

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/VirtualDesktop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VirtualDesktop
-Version: 1.4.0
+Version: 1.4.1
 Summary: Multi-window virtual-display workspaces on Windows: one pip install bootstraps the virtual display driver, hosts programs on a virtual or private desktop, keeps them off the physical screens, and hands out real window handles for automation and PrintWindow capture.
 Author: VirtualDesktop contributors
 License: MIT License
@@ -47,6 +47,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: Pillow>=9.0
+Requires-Dist: comtypes>=1.2.0
 Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == "test"
 Provides-Extra: build
@@ -78,7 +79,8 @@ pip install VirtualDesktop        # pip
 uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 ```
 
-运行时依赖只有 **Pillow**。若国内镜像同步滞后导致找不到最新版，加
+运行时依赖：**Pillow**（帧图像）与 **comtypes**（UI Automation 是 COM API）。不需要 pywin32——
+库访问 Win32 全部走 ctypes。若国内镜像同步滞后导致找不到最新版，加
 `--default-index https://pypi.org/simple`（uv）或 `-i https://pypi.org/simple`（pip）。
 
 | | 私有桌面 | 虚拟显示器 |
@@ -145,7 +147,7 @@ uv add VirtualDesktop             # uv（写入 pyproject.toml 并锁定）
 | 系统 | Windows 10 / 11（无 IddCx 版本要求） |
 | 权限 | 当前用户即可，**不提权** |
 | 驱动 | 不需要 |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 基本用法
 
@@ -214,7 +216,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | `agent.exec("python 代码")` | 在桌面内跑任意 Python，返回打印内容 |
 
 `exec` 是逃生舱：里面的代码能 `import VirtualDesktop`、能用 `list_windows()`、`CaptureEngine`，
-也能用你自己装的任何库。代理本身只依赖 ctypes，不需要额外安装。
+也能用你自己装的任何库。代理本身只依赖 ctypes 与 comtypes。
 
 ### 私有桌面不能截图
 
@@ -296,7 +298,7 @@ with VirtualWorkspace("lab") as space, space.agent() as agent:
 | 系统 | **Windows 10 1809 (build 17763) 或更高**（更低版本没有 IddCx 框架） |
 | 权限 | 安装/卸载驱动需要管理员，弹**一次 UAC** |
 | 驱动 | 首次使用时自动下载安装（也可预先装好） |
-| 依赖 | 仅 Pillow |
+| 依赖 | Pillow + comtypes |
 
 ## 装驱动
 

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/VirtualDesktop.egg-info/requires.txt

@@ -1,4 +1,5 @@
 Pillow>=9.0
+comtypes>=1.2.0
 
 [build]
 build>=1.0

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/pyproject.toml

@@ -1,64 +1,69 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "VirtualDesktop"
-version = "1.4.0"
-description = "Multi-window virtual-display workspaces on Windows: one pip install bootstraps the virtual display driver, hosts programs on a virtual or private desktop, keeps them off the physical screens, and hands out real window handles for automation and PrintWindow capture."
-readme = "README.md"
-requires-python = ">=3.9"
-license = { file = "LICENSE" }
-authors = [{ name = "VirtualDesktop contributors" }]
-keywords = ["windows", "virtual-display", "idd", "printwindow", "automation", "screenshot", "ocr"]
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Environment :: Win32 (MS Windows)",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: Microsoft :: Windows :: Windows 10",
-    "Operating System :: Microsoft :: Windows :: Windows 11",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: System :: Systems Administration",
-    "Typing :: Typed",
-]
-# The library talks to Win32 exclusively through ``ctypes``; it does not import ``pywin32``.
-# Declaring it would force every user to install a large wheel they never use, so the only hard
-# dependency is Pillow, which is needed to build and save the captured frames.
-dependencies = [
-    "Pillow>=9.0",
-]
-
-[project.optional-dependencies]
-test = ["pytest>=7.0"]
-build = ["build>=1.0", "twine>=5.0"]
-
-[project.scripts]
-VirtualDesktop = "VirtualDesktop.cli:main"
-
-[project.urls]
-Documentation = "https://github.com/Luofeng-Cloud/VirtualDesktop#readme"
-Source = "https://github.com/Luofeng-Cloud/VirtualDesktop"
-Issues = "https://github.com/Luofeng-Cloud/VirtualDesktop/issues"
-
-[tool.setuptools]
-packages = ["VirtualDesktop"]
-
-[tool.setuptools.package-data]
-# Both files are load-bearing at runtime: the manifest pins every digest that is downloaded, and
-# the PowerShell script is the Authenticode verifier used before a driver is installed (its
-# absence degrades to an inline copy, but shipping it keeps the verified path).
-VirtualDesktop = ["driver_manifest.json", "_sigcheck.ps1"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-addopts = "-ra -q"
-markers = [
-    "integration: needs a real interactive Windows desktop",
-    "destructive: installs or removes a system driver (never run in CI)",
-]
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "VirtualDesktop"
+version = "1.4.1"
+description = "Multi-window virtual-display workspaces on Windows: one pip install bootstraps the virtual display driver, hosts programs on a virtual or private desktop, keeps them off the physical screens, and hands out real window handles for automation and PrintWindow capture."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+authors = [{ name = "VirtualDesktop contributors" }]
+keywords = ["windows", "virtual-display", "idd", "printwindow", "automation", "screenshot", "ocr"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows :: Windows 10",
+    "Operating System :: Microsoft :: Windows :: Windows 11",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Systems Administration",
+    "Typing :: Typed",
+]
+# The library talks to Win32 exclusively through ``ctypes``; it does not import ``pywin32``.
+# Declaring it would force every user to install a large wheel they never use.
+#
+# ``comtypes`` is a hard dependency because UI Automation is a COM API and the library now offers
+# ``agent.uia_tree()`` as a first-class capability: shipping it unusable by default would make the
+# documented feature silently return an empty tree.  comtypes is a small pure-Python package with
+# no pywin32 dependency.
+dependencies = [
+    "Pillow>=9.0",
+    "comtypes>=1.2.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7.0"]
+build = ["build>=1.0", "twine>=5.0"]
+
+[project.scripts]
+VirtualDesktop = "VirtualDesktop.cli:main"
+
+[project.urls]
+Documentation = "https://github.com/Luofeng-Cloud/VirtualDesktop#readme"
+Source = "https://github.com/Luofeng-Cloud/VirtualDesktop"
+Issues = "https://github.com/Luofeng-Cloud/VirtualDesktop/issues"
+
+[tool.setuptools]
+packages = ["VirtualDesktop"]
+
+[tool.setuptools.package-data]
+# Both files are load-bearing at runtime: the manifest pins every digest that is downloaded, and
+# the PowerShell script is the Authenticode verifier used before a driver is installed (its
+# absence degrades to an inline copy, but shipping it keeps the verified path).
+VirtualDesktop = ["driver_manifest.json", "_sigcheck.ps1"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"
+markers = [
+    "integration: needs a real interactive Windows desktop",
+    "destructive: installs or removes a system driver (never run in CI)",
+]

{virtualdesktop-1.4.0 → virtualdesktop-1.4.1}/tests/test_packaging.py

@@ -124,10 +124,11 @@ def test_wheel_metadata_and_console_script():
         metadata = archive.read(metadata_name).decode("utf-8")
         entry = archive.read(entry_name).decode("utf-8")
     assert "Requires-Python: >=3.9" in metadata
-    # Pillow is the only hard dependency: the library reaches Win32 exclusively through ctypes,
-    # so declaring pywin32 would force every user to install a wheel that is never imported.
+    # Pillow (frame images) and comtypes (UI Automation, a COM API) are the hard dependencies.
+    # pywin32 must not appear: the library reaches Win32 exclusively through ctypes.
     requires = [line for line in metadata.splitlines() if line.startswith("Requires-Dist:")]
     assert any(line.startswith("Requires-Dist: Pillow>=") for line in requires), requires
+    assert any(line.startswith("Requires-Dist: comtypes>=") for line in requires), requires
     assert not any("pywin32" in line for line in requires), (
         f"pywin32 must not be a runtime dependency: {requires}"
     )