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.0.tar.gz
(4.8 kB
view hashes)
Built Distribution
Close
Hashes for docopt2ragel-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7cd2e6eb8a3d8ec98aecf9ad6bf88ace88991b7dcff4280e93ea1206a8174a69 |
|
MD5 | 5bc9d0992e6c7733c3a51e171f9f918a |
|
BLAKE2b-256 | 8918d60fe9d0f68f97f6c922bc0323d2b99b80ef6086f06b90726461c94eaca5 |