// SPDX-License-Identifier: GPL-3.0-only // ui_walk - regression tool for refactoring of the user interface: replays a fixed input script against // the real UI flow and the real controller (no window) and writes one fingerprint line per step. // // A new career is started from the setup screen like a player does it (default options, first manager), // with the given Watcom seed. Every script line is one input; its request is served by the production // controller (app::serve_flow_request) with all presenters absent, so nothing waits for a window. After // every step the tool writes // // picture state // // The values mean nothing by themselves: a change that must not alter the UI has to reproduce the file // written by the build before it, byte for byte. A step that throws or that the controller refuses is // recorded as "error " and the walk goes on (the same error must then appear again). // // The walk is not a faithful player: the SDL loop of the app also feeds timers and presentation // acknowledgements that this tool does not. Some screens therefore refuse their requests or cannot be // left; the script command "home" returns to the desk and, when that fails, starts the same career // again (deterministic), so one stuck screen does not end the coverage of the others. // // Usage: ui_walk