clig --- Command Line Interpreter Generator

For the impatient and those who know

You can download the gzipped PostScript documentation or the latest release as clig-|VERSION|.tar.gz or as clig-|VERSION|-0.noarch.rpm, which includes the documentation.

If you know clig already, you may be interested in the changes since the last release.

You can also download older versions of clig.

Remark: clig is not CLIG. If you were looking for the Clig Grapher for linguistic data structures by Karsten Konrad, you should go to the CLIG homepage . Both tools don't have anything to do with each other. They share their names only due to a historical coincidence.

What is clig?

Clig creates for your C-Program or lets you use in your Tcl-script

a command line interpreter with those features:
- Flag, Float, Int or String options
- of parameters of options can be specified
- can be specified for the numerical options
- can have defaults
- an be mandatory (not really optional then :-)
The command line interpreter will check for your C-program or Tcl-script the existence of mandatory options, correct range of numerical option arguments and correct number of arguments. Violation results in readable error messages. Parsed results are delivered to your C-program in a custum-built structure or as directly accessible variables to your Tcl-script.
a readable, up-to-date usage-message
a basic manual page

Clig takes as input a simple description file.

Clig generates standard C (well, I tried as hard as I can :-) It is reported to work well with C++. Within a Tcl-script, code generation is not necessary. Just declare your command line arguments and then run the parser.

The resulting code is self contained and does not depend on a library (except for libc, of course).

Clig is written in Tcl (nevertheless, (4) applies!)

Clig is free software. Its licence is the GPL.

An Example

Consider the following specification: Int -rgb rgb \ "specifies a color by its red, green and blue components"\ -c 3 3 \ -r 0 255 It shows most of the features available in clig. Here an option -rgb is declared with parameters of type int. Within the C-program or Tcl-script, it will be called rgb. The next line contains in quotes a usage string to be displayed by the generated usage()-function. The line -c 3 3 specifies that the option -rgb must be followed by exactly 3 integer values. Finally the allowed range for the three values is specified.

An example demonstrating most features of clig is also available.

Currently, clig understands the following option types:

Flag: is a boolean option (or flag) without parameters.
Float: is an option with zero or more floating point parameters.
Int: accepts zero or more integer parameters.
String: allows arbitrary strings as parameters.

For floating point, integer and string valued options a range can be specified for the number of allowed parameters. The allowed range for floating point and integer option values can also be specified.

Features missing on my todo-list

neural net type command line parser,
fuzzy logic command line parser,
inheritance hierarchy for command line options,
visual basic support,
command lines shorter than 128 characters,
generation of WINDOS program group,
Ole, Nils or Jens support,
InactiveX-aware buzzword-recognition.

Requirements

Clig is implemented in Tcl and you will not be able to make it work without. The generated C-code is Tcl-free.

Please send comments and suggestions to Harald Kirsch. Flames expressing the opinion that getopt() is the only way to go are silently ignored.