Convert your docopt usage text into a Ragel FSM
Project description
docopt2ragel makes command line interface parsing easy!
docopt2ragel parses docopt USAGE text and outputs a Ragel finite state machine for parsing the CLI.
You can then use Ragel to output the finite state machine into C source code.
Example
Create a USAGE file using docopt’s declarative format. See below for example contents:
dq - a command line tool for duraqueue the dead simple queue
Usage:
dq info <queue_file>
dq --help
Options:
-h --help Prints a short usage summary.
Convert the USAGE file into a Ragel file:
docopt2ragel.py USAGE > usage.rl
Convert the Ragel file into a C file:
ragel usage.rl
Import the generated file into your source:
#include "usage.c"
int main(int argc, char **argv)
{
int e;
options_t opts;
e = parse_options(argc, argv, &opts);
if (-1 == e)
{
exit(-1);
}
void *qu = NULL;
if (opts.help)
{
show_usage();
exit(0);
}
else if (opts.info)
{
qu = dqueuer_open(opts.queue_file);
}
if (qu)
printf("Item count: %d\n", dqueue_count(qu));
return 1;
}
For real life examples see:
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
docopt2ragel-0.1.4.tar.gz
(4.9 kB
view hashes)
Built Distribution
Close
Hashes for docopt2ragel-0.1.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0444717ef228fcd7e56768e2a13c0aedc7f5e8a610c71894b559ded7f57297c3 |
|
MD5 | 03da17c21e8d0d95e6ca425f52b087df |
|
BLAKE2b-256 | d958a903f6787f1c54c769c0b3973580d88bf48a497f2cc3a0700294e8b18e3c |