The multiarg package

[Tags: bsd3, library]

multiarg helps you build command-line parsers for programs with options that take more than one argument. See the documentation in the Multiarg module for details.

[Skip to ReadMe]


Change logChangeLog
Dependenciesbase (>= && <5) [details]
CopyrightCopyright 2011-2015 Omari Norman
AuthorOmari Norman
CategoryConsole, Parsing
Home page
Bug tracker
Source repositoryhead: git clone
Executablestelly, grover
UploadedThu Sep 10 01:56:51 UTC 2015 by OmariNorman
DistributionsLTSHaskell:, NixOS:, Stackage:
Downloads3914 total (92 in last 30 days)
0 []
StatusDocs available [build log]
Last success reported on 2015-09-10 [all 1 reports]




programsBuild sample programsDisabledManual

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainers' corner

For package maintainers and hackage trustees

Readme for multiarg-


This is multiarg, a library of combinators to parse command lines.

For "released" code see Hackage:

multiarg is on Github:


If you obtained this code through Hackage, just build it using the ordinary Cabal command:

cabal install

If you obtain this code on Github, you will first need to generate the Cabal file and generate the tests. This will require that you install two libraries:

cabal install cartel quickpull

Then run this script to generate the Cabal file and the tests:

sh generate


multiarg releases are numbered in accordance with the Haskell Package Versioning Policy.

Currently the multiarg library depends only on the "base" package, so multiarg should have wide compatibility with different compilers and sets of libraries. The tests have some additional dependencies.

Build history

If you're having trouble building multiarg, try looking at the travis-ci build history at:

It shows successful builds and the versions of any package dependencies that were installed when that build succeeded, so it might help you diagnose any dependency issues.

Build Status

Similar libraries

Of course there are many command-line parsing modules and libraries out there; here are some comparisons.

optparse-applicative: very featureful with a well thought-out interface. Builds help for you. I often use this if it meets my needs. From what I can tell, though, it strips out information about the relative ordering of the words from the command line; for instance, if the user typed "hello --opt1 --opt2", you cannot tell whether she entered "--opt1" before she entered "--opt2". Also, from what I can tell it cannot easily parse options that take more than one argument.

GetOpt: comes with the base libraries, so you don't have to install anything extra, which gives it a huge advantage. Keeps information about the relative ordering of the words from the command line. Cannot easily parse options that take more than one argument.

cmdargs: after multiple passes through the Haddocks I could never make any sense of this library at all, which must be a reflection of my level of Haskell ignorance.

More comparisons are at the Haskell Wiki.