The multiarg package

[Tags:bsd3, library, test]

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 log ChangeLog
Dependencies base (>= && <5) [details]
License BSD3
Copyright Copyright 2011-2015 Omari Norman
Author Omari Norman
Category Console, Parsing
Home page
Bug tracker
Source repository head: git clone
Uploaded Thu Sep 10 01:56:51 UTC 2015 by OmariNorman
Distributions LTSHaskell:, NixOS:, Stackage:, Tumbleweed:
Downloads 5296 total (48 in the last 30 days)
0 []
Status Docs available [build log]
Last success reported on 2015-09-10 [all 1 reports]
Hackage Matrix CI




programsBuild sample programsDisabledManual

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


Maintainer's Corner

For package maintainers and hackage trustees

Readme for multiarg

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.