exlab_wizard.tray.icon#

pystray icon construction. Backend Spec §4.3.2.

The tray icon’s menu has three top-level items per the §4.1 contract:

  • Open – spawns or focuses the window subprocess (the launcher routes this to WindowLauncher.open).

  • Status submenu – live state (formatted by tray.status) refreshed every 5 seconds.

  • Quit – triggers the graceful-shutdown protocol (the launcher routes this to QuitCoordinator.quit).

The icon image is a small in-memory PIL bitmap. We don’t ship a real icon file at this phase; the asset hookup lives with PyInstaller’s --add-data config in §15.1. The runtime image is generated from _default_icon_image() – a 64x64 navy square with a centered “E” glyph – which keeps the runtime self-contained and avoids relying on file-system paths during PyInstaller bundling.

Tests pass an injected pystray module (or a stand-in) via the pystray_module parameter so they can build the menu graph without the real backend.

Functions

build_icon(*, on_open, on_quit, status_provider)

Build the pystray icon with the §4.1 menu.

default_icon_image()

Return a small PIL.Image used as the tray icon bitmap.
exlab_wizard.tray.icon.build_icon(*, on_open, on_quit, status_provider, pystray_module=None, icon_image=None, icon_name='exlab-wizard', title='ExLab-Wizard')[source]#

Build the pystray icon with the §4.1 menu.

status_provider is invoked every time pystray re-renders the menu (pystray supports lazily-evaluated text via callable labels) so the operator sees live status without a separate refresh notification.

Parameters:
Return type:

Any

exlab_wizard.tray.icon.default_icon_image()[source]#

Return a small PIL.Image used as the tray icon bitmap.

Imported lazily so the rest of the module is import-safe even when Pillow is not yet installed (ie. minimal CI runs). On failure returns a one-byte bytes object the caller may pass straight to pystray; pystray accepts file-like objects too.

Return type:

Any