multiarg: Command lines for options that take multiple arguments
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]
Modules
[Index]
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| programs | Build sample programs | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- multiarg-0.30.0.10.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
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 | 19263 total (33 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.
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.