Tamaki MES Script Library
The TamakiMES Perspective project ships a Jython project script library under
script-python/tamaki/mes. These are helper functions used throughout the project's views: for
opening popups and docks, formatting dates and durations, building dropdown options, comparing
configuration backups, handling permission exceptions, and displaying validation messages.
They are called from Perspective event scripts, component scripts, and runScript expression
bindings using their fully-qualified package path:
tamaki.mes.<package>.<function>(...)
Relationship to the system.mes.* Script API
This library is separate from the gateway Script API (system.mes.*).
The system.mes.* functions are implemented in the gateway module and form the primary,
permission-gated MES API. The tamaki.mes.* functions documented here are plain project scripts that
frequently call system.mes.* under the hood (for example to generate a ULID or run a backup).
Because they are ordinary Jython scripts, none of them require permissions, so the per-method pages
below omit the Permissions section used in the Script API docs.
Note: session scope: Many tamaki.mes.utils helpers (popups, docks, session variables) only work
inside a Perspective session. Call them from a component event such as a button's
onActionPerformed, not from the Designer script console or a pure gateway scope.
Packages
tamaki.mes.utils: general-purpose UI, formatting, and conversion helpers.tamaki.mes.validations: set and clear validation messages on Input components.tamaki.mes.permissions: detect and surface permission (access-denied) exceptions.tamaki.mes.apiResponse: format messages from API responses.tamaki.mes.backup.compare: configuration-backup comparison engine.