optparse-generic

Auto-generate a command-line parser for your datatype

LTS Haskell 24.17:1.5.2@rev:3
Stackage Nightly 2025-10-31:1.5.2@rev:3
Latest on Hackage:1.5.2@rev:3

See all snapshots optparse-generic appears in

BSD-3-Clause licensed by Gabriella Gonzalez
Maintained by [email protected]
This version can be pinned in stack with:optparse-generic-1.5.2@sha256:2e4ee3731d9d6bedc8e45fcbac02ea779675681da538d6aadf692a7ac9e2ae66,2337

Module documentation for 1.5.2

Used by 3 packages in nightly-2025-10-31(full list with versions):
github-release, optparse-generic, rzk

This library auto-generates an optparse-applicative-compatible Parser from any data type that derives the Generic interface.

See the documentation in Options.Generic for an example of how to use this library

Changes

1.5.2

1.5.1

1.5.0

1.4.9

1.4.8

1.4.7

1.4.6

  • Use readField in default implementation of parseField

1.4.5

1.4.4

  • readIntegralBounded: use metavar in error message

1.4.3

  • Export internal readIntegralBounded utility
  • Build against optparse-applicative-0.16.0.0

1.4.2

  • New unwrap function
    • This is the underlying utility that powers unwrap{Record,RecordPure,WithHelp}

1.4.1

  • Fix broken haddocks

1.4.0

  • BREAKING CHANGE: Add support for type-level default values
    • This is a breaking change because the various parse* typeclass methods now take an additional argument to support this feature

1.3.1

  • Export GenericParseRecord and getRecord{,PureWith}

1.3.0

  • BREAKING CHANGE: New metavar method for ParseField class
    • This field simplifies customizing ParseField instances
      • Now you usually only need to override metavar now or possibly also readField, whereas the default behavior for parseField should work more often
    • This is only a breaking change for data types that use the default implementation of ParseField but do not derive Typeable
    • You can migrate existing code that doesn’t compile by just explicitly specifying what the metavar field should be