Ragel


Ragel is a finite-state machine compiler and a parser generator. Initially Ragel supported output for C, C++ and Assembly source code, was expanded to support several other languages including Objective C, D, Go, Ruby, and Java. Additional language support is also in development.
It supports the generation of table or control flow driven state machines from regular expressions and/or state charts and can also build lexical analysers via the longest-match method. Ragel specifically targets text parsing and input validation.

Overview

Ragel supports the generation of table or control flow driven state machines from regular expressions and/or state charts and can also build lexical analysers via the longest-match method.
A unique feature of Ragel is that user actions can be associated with arbitrary state machine transitions using operators that are integrated into the regular expressions. Ragel also supports visualization of the generated machine via graphviz.
The graph represents a state-machine that takes user input as a series of bytes representing ASCII characters and control codes. 48..57 is equivalent to the regular expression , so only sequences beginning with a digit can be recognised. If 10 is encountered, we're done. 46 is the decimal point, 43 and 45 are positive and negative signs and 69/101 is uppercase/lowercase 'e'. As such it will recognize the following properly:

45
055
46.
78.1
2e5
78.3e12
69.0e-3
3e+3

but not:

.3
-5
3.e2
2e5.1

Syntax

Ragel's input is a regular expression only in the sense that it describes a regular language; it is usually not written in a concise regular expression, but written out into multiple parts like in Extended Backus–Naur form. For example, instead of supporting POSIX character classes in regex syntax, Ragel implements them as built-in production rules. As with usual parser generators, Ragel allows for handling code for productions to be written with the syntax. The code yielding the above example from the official website is:

action dgt
action dec
action exp
action exp_sign
action number
  1. A floating-point number literal.
number = ?
?
) %number;
main := *;