alexzhornyak/uscxml

SCXML interpreter and transformer/compiler written in C/C++ with bindings to Java, C#, Python and Lua

ArrayAsMap branch

General difference from original USCXML

1) Data array was changed from std::list<Data> to std::map<int,Data>

It means that data starts from 0, but arrays in some datamodels may start from 1 or other digit, or may be like 1,3,5 etc

2) Critical issues like #179 were corrected

Original USCXML master branch stopped support in 2017 but has critical issues like #179 and others

3) Full Windows Support

Original USCXML has poor Windows support but this branch is completely tested and has Windows as the only target.

Supported models

• null
• lua
• ecmascript (JavaScriptCore)

uSCXML ReadMe

Quick Links

• Building from source
• Tests passed
• Publications

What is it?

uSCXML is a platform to work with state-charts given as SCXML files. It consists of three principal components:

1. libuscxml: C++ library containing an interpreter and accompanying functionality.

2. uscxml-browser: A standards compliant command-line interpreter of SCXML documents.

3. uscxml-transform: A collection of transformation implementations to transpile SCXML, e.g. onto ANSI-C and VHDL.

The status of the various datamodels, bindings and generators with regard to the W3C IRP tests can be checked in the test table.

Installation

There are no installers yet and we do not feature any releases. Just check for open issues and build from source. If you did download and build locally, you can create installers via make packages though.

Documentation

Documentation is available at our github pages. It is created from inline comments in the source along with some dedicated markdown pages via doxygen. We try to keep it current and will update it ever again. For the most current documentation, you can run make docs in your build directory.

Licensing

uSCXML itself is distributed under the Simplified BSD license as in, do not sue us and do not misrepresent authorship. There are currently four additional libraries that are required to compile uSCXML.

Project	License	Comment
libcurl	MIT/X derivate	Used in uSCXML to fetch remote content
Xerces-C++	Apache v2	XML parser and DOM implementation
libevent	3-clause BSD	Delayed event queues
uriparser	New BSD	Referring and resolving URIs

At configure time, the uSCXML build-process will attempt to find and link several other libraries (e.g. Lua, v8) and additional licensing terms may apply.

Getting Started

For more detailled information, refer to the documentation.

Embedded as a Library

uscxml::Interpreter scxml = uscxml::Interpreter::fromURL("...");
while(scxml.step() != uscxml::USCXML_FINISHED) {
  ...
}

On the Command-line

# interpret state-chart from url
$ uscxml-browser https://raw.githubusercontent.com/tklab-tud/uscxml/master/test/w3c/null/test436.scxml

For Transformations

# transform given SCXML document into ANSI-C fragment
$ uscxml-transform -tc -i https://raw.githubusercontent.com/tklab-tud/uscxml/master/test/w3c/null/test436.scxml

uscxml's Issues

'SCXML-tutorial\testInvokePassParam.scxml' fails

Test testInvokePassParam.scxml fails with output:

[Warning]   Platform Event 
    "name": error.execution
    "data": {
      "cause":       "1:ReferenceError: Can't find variable: ID_SUB", 
      "description": "s_ID=ID_SUB", 
      "interpreter": "ScxmlSubTestInvokePassParam", 
      "xpath":       "//data[@id=\"s_ID\"]"
    }
[Log] Outcome: "fail"

[Scxml Validation] Incorrect validation error when initial has multiple targets

In page:
report__USCXML_2_0_0___msvc2015_32bit__Win7_1.md
about test 364 wrote Pass.

is correct, but when I open
https://github.com/alexzhornyak/SCXML-tutorial/blob/master/Tests/ecma/W3C/Mandatory/Auto/test364.scxml
in SCXML Editor and run it, I receive:
ERROR> 2023-Jun-18 21:03:14.750596 uscxml_tester.exe Issue (FATAL) at //state[@id="s2"]/initial[1]: Initial element must define exactly one transition