uXMS
Utility app correctness tests for uXMS. These cases verify terminal scoping output for named variables, all/alll display, source/time/community columns, history, truncation, config-file variables, clean CLI overrides, filters, source selection, novirgins, connection aliases, refresh modes, shortcuts, and color mapping.
Stem Mission
The stem mission runs one MOOS community with uTimerScript publishing controlled mail and pMissionEval proving publisher readiness. The harness runs bounded uXMS terminal captures and grades required and forbidden display tokens.
Examples
Case Matrix
scoped_var_pass
Passes XMS_ALPHA as the only scoped variable, testing explicit command-line scope; passes when the capture contains XMS_ALPHA and its posted value alpha.
scoped_excludes_noise_pass
Scopes only XMS_ALPHA while the publisher also posts XMS_NOISE, testing exclusion of unrequested mail; passes when the capture contains XMS_ALPHA=alpha evidence and no XMS_NOISE token.
all_mode_pass
Runs with --all, testing the long option for database-wide scope; passes when the capture contains both the MOOSDB variable DB_UPTIME and scripted XMS_ALPHA.
all_shortcut_pass
Runs with -a, testing the short alias for database-wide scope; passes when the capture contains both DB_UPTIME and XMS_ALPHA.
show_source_pass
Runs --show=source for XMS_ALPHA, testing publication-source display; passes when the capture contains XMS_ALPHA and its publisher uTimerScript.
show_time_only_pass
Runs --show=time for XMS_ALPHA, testing the time-column option; passes when the XMS_ALPHA row contains a numeric timestamp and the exact alpha value.
show_community_only_pass
Runs --show=community for XMS_ALPHA, testing community display; passes when the capture contains XMS_ALPHA and shoreside.
show_time_community_pass
Runs --show=time,community for XMS_ALPHA, testing the combined column request; passes when one row contains XMS_ALPHA, a numeric timestamp, shoreside, and the exact alpha value in their displayed column order.
show_source_community_pass
Runs --show=source,community for XMS_ALPHA, testing both named columns together; passes when the capture contains XMS_ALPHA, uTimerScript, and shoreside.
history_var_pass
Starts --history=XMS_HIST before the scripted first, second, and third publications, testing collection and oldest-to-newest rendering of distinct history entries; passes when the capture contains all three values in that order.
trunc_long_payload_pass
Scopes a 62-character XMS_LONG value with --trunc=25, testing the long truncation option; passes when the capture contains abcdefghijklmnopqrstuvwxyz but not the complete payload.
clean_cli_scope_pass
Loads a mission file that configures XMS_ALPHA and XMS_SECONDARY, then runs --clean XMS_NUM, testing replacement of the complete file scope by CLI scope; passes when the capture contains XMS_NUM=42 evidence and neither configured variable appears.
config_var_pass
Loads the mission file without CLI variable names, testing its configured var=XMS_ALPHA and var=XMS_SECONDARY scope; passes when both variable names appear in the capture.
filter_prefix_pass
Combines --all with --filter=XMS_, testing prefix filtering of database-wide scope; passes when XMS_ALPHA and XMS_NUM appear and DB_UPTIME does not.
src_timer_pass
Uses --src=uTimerScript without explicit variable names, testing source-derived scope; passes when the capture includes the publisher's XMS_ALPHA and XMS_NUM variables.
novirgins_pass
Scopes posted XMS_ALPHA and never-posted XMS_MISSING with --novirgins, testing suppression of virgin variables; passes when XMS_ALPHA=alpha evidence appears and neither XMS_MISSING nor n/a appears.
novirgins_shortcut_pass
Repeats the posted and never-posted scope with -g, testing the short alias for virgin suppression; passes with the same XMS_ALPHA presence and XMS_MISSING/n/a absence checks.
shortcut_source_pass
Runs -s for XMS_ALPHA, testing the short alias for source display; passes when the capture contains XMS_ALPHA and uTimerScript.
shortcut_source_time_pass
Runs -st for XMS_ALPHA, testing the combined source-and-time shortcut; passes when one row contains XMS_ALPHA, uTimerScript, a numeric timestamp, and the exact alpha value in their displayed column order.
filter_specific_pass
Combines --all with the narrower --filter=XMS_A, testing selective prefix filtering; passes when XMS_ALPHA=alpha evidence appears and neither XMS_NUM nor DB_UPTIME appears.
filter_no_match_absent_pass
Combines --all with --filter=NO_SUCH_PREFIX, testing a filter with no matching variables; passes when a SCOPING report is produced without XMS_ALPHA or DB_UPTIME.
colorany_pass
Applies --colorany=XMS_ALPHA to the scoped variable, testing automatic color assignment; passes when the row contains the expected blue ANSI sequence around XMS_ALPHA and its alpha value.
paused_shortcut_pass
Starts -p after XMS_PAUSE=initial is present and posts XMS_PAUSE=later during capture, testing that paused mode does not refresh on new mail; passes when the display says PAUSED, shows initial, and never shows later.
shortcut_trunc_pass
Scopes the 62-character XMS_LONG value with -t, testing the --trunc=25 shortcut; passes when the capture contains abcdefghijklmnopqrstuvwxyz but not the complete payload.
alll_mode_pass
Runs with --alll, testing inclusion of variables that ordinary --all excludes; passes when the capture contains an actual APPCAST row alongside DB_UPTIME and XMS_ALPHA.
server_underscore_args_pass
Connects with --server_host=localhost and --server_port=<case-port>, testing the underscore server aliases; passes when the capture contains XMS_ALPHA and alpha from that database.
moos_alias_args_pass
Connects with --mooshost=localhost and --moosport=<case-port>, testing the compact MOOS aliases; passes when the capture contains XMS_ALPHA and alpha from that database.
moos_underscore_args_pass
Connects with --moos_host=localhost and --moos_port=<case-port>, testing the underscore MOOS aliases; passes when the capture contains XMS_ALPHA and alpha from that database.
alias_proc_name_pass
Runs with --alias=uXMS_ci while scoping XMS_ALPHA and DB_CLIENTS, testing custom MOOS client registration; passes when the DB_CLIENTS row contains uXMS_ci and the normal XMS_ALPHA=alpha evidence remains visible.
colormap_pair_pass
Applies --colormap=XMS_ALPHA,red to the scoped variable, testing explicit color assignment; passes when the row contains the expected red ANSI sequence around XMS_ALPHA and its alpha value.
clean_shortcut_scope_pass
Loads the mission-file scope, then runs -c XMS_NUM, testing the short alias for ignoring all configured variables; passes when the capture contains XMS_NUM=42 evidence and neither XMS_ALPHA nor XMS_SECONDARY appears.