fetch_ph_gui

fetch_ph_gui

fetch_ph_gui.py - Install one Peter Hinch GUI into add_ons/gui/ and patch FrameBuffer checks.

Supported which values (full upstream repo names): micropython-nano-gui, micropython-micro-gui, micropython-touch

Only one gui/ tree is active at a time. If a different core is present, the directory is emptied before installing. Patches are in-memory only (no edits under gui/).

Callers must define SSD on their setup module before calling fetch, because gui.core.colors imports SSD from color_setup / hardware_setup / touch_setup.

Functions:

fetch_ph_gui

fetch_ph_gui(which, apply_patches=True)

Ensure which GUI is in add_ons/gui/ and optionally patched.

Returns True when ready. Pass apply_patches=False when pre-seeding (e.g. PyScript loader) before the setup module defines SSD — callers that import color_setup / hardware_setup / touch_setup will call again with patches enabled.

Uses mip.install (firmware on MicroPython; portable add_ons/mip.py on CPython / Pyodide / CircuitPython).