Declarative command-line option parsing and documentation library.
|Latest on Hackage:||0.2.3|
This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.
CmdTheLine aims to remove tedium from the definition of command-line programs, producing usage and help with little effort.
The inspiration was found in Daniel Bunzli's http://erratique.ch/software/cmdliner library.
CmdTheLine uses applicative functors to provide a declarative, compositional mechanism for defining command-line programs by lifting regular Haskell functions over argument parsers.
A tutorial can be found at http://elifrey.com/2012/07/23/CmdTheLine-Tutorial/.
Suggestions, comments, and bug reports are appreciated. Please see the bug and issue tracker at http://github.com/eli-frey/cmdtheline.
Changes since 0.1:
More type safety: Types in CmdTheLine.Arg have been made more explicit to disalow unwanted behavior. Positional argument information and optional argument information are distinguished from each other. As well
Args must be transformed into
Termbefore use, as some operations make since to perform on
Argbut not on
ArgVal has only one method:
pphave been fused into a tuple, so that instantiation of
ArgValcan be simplified for all parties.
Err is an instance of MonadIO: The
Errmonad now supports IO action.
File and Directory path validation: Taking advantage of new
Errcapabilities, the library provides new functions for validating
Strings inside of
Terms as being valid/existent file/directory paths.
Changes since 0.2.0:
unwrapfunctions: To allow the testing of terms, there are now two new functions exported with System.Console.CmdTheLine.Term,
unwrapChoice. As well a datatype representing cause of early exit,
Changes since 0.2.1
Added adapter for interfacing with Getopt in module