Installation

Clap is available as an opam package:

opam install clap

To use it, add clap as a dependency in your dune file.

API Documentation

See src/clap.mli.

Example

See demo/demo.ml.

The Two Rules

One limitation of Clap is that you have to follow two rules which are not enforced by typing:

• read named arguments before unnamed arguments;
• call Clap.close before actually using arguments.

There are exceptions to these rules.

• You can read a named argument after an unnamed argument if you are ok that the named argument cannot appear before the unnamed argument. For instance, if the unnamed argument is a subcommand name and the named argument only exists for this subcommand, you can read the command name first and then decide whether or not to read the named argument. Users will not be able to specify the named argument before the command name but this behavior is usually ok for subcommands.
• If an argument cannot be invalid, i.e. it is not mandatory and all strings are valid values for it, then you can use its value before calling Clap.close.