haskell-src-exts

Manipulating Haskell source: abstract syntax, lexer, parser, and pretty-printer

https://github.com/haskell-suite/haskell-src-exts

Version on this page:1.17.1@rev:2
LTS Haskell 22.39:1.23.1
Stackage Nightly 2024-10-31:1.23.1
Latest on Hackage:1.23.1

See all snapshots haskell-src-exts appears in

BSD-3-Clause licensed by Niklas Broberg
Maintained by Niklas Broberg, Roman Cheplyaka
This version can be pinned in stack with:haskell-src-exts-1.17.1@sha256:1b3943df8a71dbd6b8e938e267b9c84d56455a2d5243d7c561d16c27faa63edf,5062

Module documentation for 1.17.1

Haskell Source Extensions

haskell-src-exts is a package for handling and manipulating Haskell source code. It is a descendant of the haskell-src package that is part of the standard libraries, but extends this to support a number of syntactic extensions, e.g. MPTCs, fundeps, GADTs, TH etc. The aim is to support all extensions recognized by the community, as determined by what is implemented in compilers and tools.

Apart from the more standard extensions supported by e.g. GHC, haskell-src-exts provides support for HaRP (Haskell Regular Patterns) and HSX (Haskell Source with XML) syntax.

Package structure

The modules that comprise haskell-src-exts all reside in the hierarchic namespace Language.Haskell.Exts, or its more feature-rich sibling Language.Haskell.Exts.Annotated. Notable exposed modules include:

  • Language.Haskell.Exts[.Annotated] - Imports and re-exports all the below, and also defines some functions that combine functionality from several modules.
  • Language.Haskell.Exts[.Annotated].Syntax - The abstract syntax tree that the other modules work on.
  • Language.Haskell.Exts[.Annotated].Build - Combinators for building abstract syntax.
  • Language.Haskell.Exts[.Annotated].Parser - Functions for parsing Haskell source code into an abstract syntax representation.

Non-comprehensive list of supported extensions

  • Multi-parameter type classes (MPTCs)
  • Functional dependencies
  • Associated types, type families
  • Liberal class and instance heads
  • Implicit parameters (ghc and hugs)
  • Explicit kind signatures
  • Pattern guards
  • Generalized algebraic data types (GADTs)
  • Template Haskell (TH)
  • Universal and existential quantification (forall)
  • Empty data type declarations
  • Unboxed tuples (# #)
  • Standalone deriving
  • Regular patterns
  • Haskell XML, HSX style
  • Pragmas

License

The haskell-src-exts Package is distributed under a derived BSD-style license. It derives from several sources, all of which are distributable under BSD-style or compatible licenses. See the file LICENSE for the complete license text.