MoonSC is an execution environment for Harel statecharts following the W3C SCXML Recommendation, capable of running multiple concurrent SCXML sessions defined by statecharts written as Lua tables.
It runs on GNU/Linux and requires Lua (>=5.3). It should compile and run also on Windows (MSYS2/MinGW) and on MacOSX, but I've not tested this yet (any feedback is appreciated).
Author: Stefano Trettel
MIT/X11 license (same as Lua). See LICENSE.
See the Reference Manual.
Setup the build environment as described here, then:
$ git clone https://github.com/stetre/moonsc
$ cd moonsc
moonsc$ make
moonsc$ sudo make installThe example below defines a simple statechart and executes it.
Other examples can be found in the examples/ and the tests/ directories.
-- MoonSC 'Hello World' example - hello.lua
local moonsc = require("moonsc")
-- Import the element constructors:
moonsc.import_tags()
-- Define a statechart using them:
local helloworld = _scxml{ name="hello", initial="s1",
_script{ text=[[print("Hello, World!")]] },
_state{ id="s1",
_onentry{ _log{ expr="'entering state s1'" } },
_transition{ event="go", target="s2",
_log{ expr=[["received event '".._event.name.."'"]] }
},
_onexit{ _log{ expr="'exiting state s1'" } },
},
_final{ id="s2",
_onentry{ _log{ expr="'entering state s2'" } },
_onexit{ _log{ expr="'exiting'" } },
},
}
-- Set a callback to redirect <log> executions to stdout:
moonsc.set_log_callback(function(...) print(...) end)
-- Create a session with the statechart, start it, and send it an event:
moonsc.create("mysession", helloworld)
moonsc.start("mysession")
moonsc.send("mysession", "go")
-- Enter the main event loop:
while true do
if not moonsc.trigger() then break end
end
The script can be executed at the shell prompt with the standard Lua interpreter:
$ lua hello.lua