event
)Event driven programming for shell scripts
Create or destroy an event interrupt,
Each event will have subtly different behaviour depending on the event itself due to the differing roles of each event system. Therefore it is recommended that you read the docs on each event to understand its behaviour.
However while they might differ, the event
API does try
to retain a level of external consistency. For example each event in
defined via name=interrupt
where name is a
user defined handle (like a variable or function would have a name) and
interrupt is a system state you wish the event to be
fired on.
Each event function will have a payload sent via stdin which would look a little like the following:
{
"Name": "",
"Interrupt": {}
}
Name will always refer to the name you passed when defining the event. And Interrupt will carry any event specific metadata that might be useful to the event function. Thus the value of Interrupt will vary from one event to another.
event event-type name=interrupt { code block }
!event event-type name
event onSecondsElapsed autoquit=60 {
out "Your 60 second timeout has elapsed. Quitting murex"
exit 1
}
!event onSecondsElapsed autoquit
The interrupt
field in the CLI supports ANSI constants.
eg
event onKeyPress f1={F1-VT100} {
tout qs HintText="Key F1 Pressed"
}
To list compiled event types:
» runtime --events -> formap event ! { out $event }
onCommandCompletion
onFileSystemChange
onKeyPress
onPrompt
onSecondsElapsed
event
!event
formap
): Iterate through a map or other collection of
dataopen
):
Open a file with a preferred handlerprivate
): Define a private function blockfunction
): Define a function blockruntime
): Returns runtime information on the internal
state of MurexThis document was generated from builtins/events/events_doc.yaml.
This site's content is rebuilt automatically from murex's source code after each merge to the master
branch. Downloadable murex binaries are also built with the website.
Last built on Wed Jul 2 22:12:32 UTC 2025 against commit bb72b6fbb72b6fdd502f835172d7d06207ba4ec2c70886c.
Current version is 7.0.2107 (develop) which has been verified against tests cases.