generic-deriving-1.14.5: Generic programming library for generalised deriving.

generic-deriving-1.14.5: Generic programming library for generalised deriving.

This package provides functionality for generalising the deriving mechanism in Haskell to arbitrary classes. It was first described in the paper:

  • A generic deriving mechanism for Haskell. Jose Pedro Magalhaes, Atze Dijkstra, Johan Jeuring, and Andres Loeh. Haskell'10.

The current implementation integrates with the new GHC Generics. See for more information. Template Haskell code is provided for supporting older GHCs.

This library is organized as follows:

It is worth emphasizing that these modules are primarly intended for educational purposes. Many of the classes in these modules resemble other commonly used classes—for example, GShow from Generics.Deriving.Show resembles Show from base—but in general, the classes that generic-deriving defines are not drop-in replacements. Moreover, the generic defaults that generic-deriving provide often make simplifying assumptions that may violate expectations of how these classes might work elsewhere. For example, the generic default for GShow does not behave exactly like deriving Show would.

If you are seeking GHC.Generics-based defaults for type classes in base, consider using the generic-data library.