multiarg: Command lines for options that take multiple arguments

[ bsd3, console, library, parsing ] [ Propose Tags ] [ Report a vulnerability ]

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]

Flags

Manual Flags

NameDescriptionDefault
programs

Build sample programs

Disabled

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

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.2.0.0, 0.4.0.0, 0.6.0.0, 0.8.0.0, 0.10.0.0, 0.12.0.0, 0.12.0.2, 0.14.0.0, 0.16.0.0, 0.18.0.0, 0.20.0.0, 0.22.0.0, 0.24.0.0, 0.24.0.2, 0.24.0.4, 0.26.0.0, 0.28.0.0, 0.30.0.0, 0.30.0.2, 0.30.0.4, 0.30.0.6, 0.30.0.8, 0.30.0.10
Change log ChangeLog
Dependencies base (>=4.7.0.0 && <5) [details]
License BSD-3-Clause
Copyright Copyright 2011-2015 Omari Norman
Author Omari Norman
Maintainer omari@smileystation.com
Category Console, Parsing
Home page https://github.com/massysett/multiarg
Bug tracker https://github.com/massysett/multiarg/issues
Source repo head: git clone https://github.com/massysett/multiarg.git
Uploaded by OmariNorman at 2015-09-10T01:56:51Z
Distributions LTSHaskell:0.30.0.10, Stackage:0.30.0.10
Reverse Dependencies 3 direct, 0 indirect [details]
Executables telly, grover
Downloads 19257 total (80 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-09-10 [all 1 reports]

Readme for multiarg-0.30.0.10

[back to package description]

Multiarg

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

For "released" code see Hackage:

http://hackage.haskell.org/package/multiarg

multiarg is on Github:

http://www.github.com/massysett/multiarg

Building

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

Versioning

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:

https://travis-ci.org/massysett/multiarg

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.