/parseargs

Haskell argument parsing library
  1. Haskell 98.8%
  2. Shell 1.2%
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
System/Console cleaned up warning from redundant constraint Dec 4, 2016
tests added a few simple tests Jun 8, 2016
.travis.yml added travis support Jun 8, 2016
COPYING updated license and copyright information Nov 27, 2015
README.md updated for version 0.2.0.4 Dec 16, 2015
Setup.hs cabalized the library Apr 1, 2007
parseargs-example.hs updated license and copyright information Nov 27, 2015
parseargs.cabal Fix test dependency on test executable Jan 7, 2019
test-parseargs.hs added a few simple tests Jun 8, 2016
test-parseargs.sh Fix test dependency on test executable Jan 7, 2019

README.md

parseargs: Command-line argument parsing for Haskell programs

Copyright (c) 2007 Bart Massey

This library provides System.Console.Parseargs, a module to assist in argument parsing for Haskell stand-alone command line programs.

The package provides a Haskell command-line argument "parser". You supply a specification of the arguments to your command-line program; parseargs reads the arguments and checks that they meet your spec. It then fills in a data structure that captures the relevant data, from which parsed arguments can be extracted as needed. See the Haddock documentation for the gory details.

I have used this code with ghc 6 and later on Linux. It is a fairly standard Hackage-ready package, to the extent I know how to construct such.

This library is not what I set out to build. It definitely could also use some work. However, I use it all the time for writing little programs. I thought others might find it useful, and I also have released other code that depends on it, so I put it out there.

Have fun with it, and let me know if there are problems.

Release History

  • The 0.1.2 release includes a typeclass for argument types for easier use.

  • The 0.1.3 release includes more uniform and usable error handling.

  • The various 0.1.3.x point releases include bug fixes and various extra-minor enhancements. See the Git log.

  • The 0.1.4 release includes the ability to mix optional and required positional arguments.

  • The 0.1.5 release includes the "soft dash" option, giving the ability to allow positional arguments to begin with a dash if possible.

  • The 0.1.5.1 release fixes some warnings and stuff.

  • The 0.1.5.2 release fixes some missing documentation.

  • The 0.2 release cleans up some namespace pollution by removing ArgRecord and the args accessor from the public namespace. This allows the use of the name args by the user to describe program arguments.

  • The 0.2.0.1 release cleans up a bunch of documentation nits and cleans up copyright notices and license information.

  • The 0.2.0.2 release fixes the botched release of 0.2.0.1. Sigh.

  • The 0.2.0.3 release fixes the missing Args constructor documentation of 0.2.0.2.

  • The 0.2.0.4 release suppresses a GHC 7.10 warning for Control.Monad.Safe.

License

This program is licensed under the "3-clause ('new') BSD License". Please see the file COPYING in this distribution for license terms.