StateML 0.22

StateML is a State Machine Markup Language, with GraphViz and template-driven code generation.

SYNOPSIS

## See the stml command for command line use (recommended)

## Heres what a .stml file might look like:

< machine
id="main"
xmlns="http://slaysys.com/StateML/1.0"
xmlns:C="http://your.com/path/to/ns/for/C/code"
xmlns:Perl="http://your.com/path/to/ns/for/perl/code"
xmlns:Java="http://your.com/path/to/ns/for/Java/code"
...
>
< event id="init">
< C:api>void init_event_handler()< /C:api>
< /event>
< state id="#ALL" graphviz:style="dashed">
< arc event_id="init" goto="running">
< C:handler>init_device()< /C:handler>
< /arc>
< /state>
< state id="running"/>
< /machine>

use StateML;

my $machine = StateML->parse( $source ); ## filename, GLOB, etc.

StateML->parse( $source, $machine ); ## Add to existing machine

... process $machine as needed, see stml source for ideas...

WARNING: Alpha code. I use it in production, but you may want to limit your use to development only.

StateML is an XML dialect and a tool (stml) that reads this dialect (by default from files with a ".stml" extension) and converts it to source code using source code to a data structure.

It can then emit the data structure as a graphviz-generated image or graph specification or you may take the data structure and do what you want with it (bin/stml can pass it to template toolkit, for instance).
parse

my $m = StateML->parse( $StateML_string ) ;
my $m = StateML->parse( *F ) ;