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.16.0.1@rev:1
LTS Haskell 20.24:	1.23.1
Stackage Nightly 2023-06-08:	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.16.0.1@sha256:0f3065177dbc54575d65f4c996c641bdc0299dd738d6edc12d3ee93e5a507b6e,4945

Module documentation for 1.16.0.1

Language
- Language.Haskell
  - Language.Haskell.Exts
    - Language.Haskell.Exts.Annotated
      - Language.Haskell.Exts.Annotated.Build
      - Language.Haskell.Exts.Annotated.ExactPrint
      - Language.Haskell.Exts.Annotated.Fixity
      - Language.Haskell.Exts.Annotated.Simplify
      - Language.Haskell.Exts.Annotated.Syntax
    - Language.Haskell.Exts.Build
    - Language.Haskell.Exts.Comments
    - Language.Haskell.Exts.Extension
    - Language.Haskell.Exts.Fixity
    - Language.Haskell.Exts.Lexer
    - Language.Haskell.Exts.Parser
    - Language.Haskell.Exts.Pretty
    - Language.Haskell.Exts.SrcLoc
    - Language.Haskell.Exts.Syntax

Depends on 5 packages(full list with versions):

array, base, cpphs, ghc-prim, pretty

Used by 14 packages in lts-0.7(full list with versions):

derive, diagrams-builder, diagrams-haddock, fay, ghc-mod, haskell-names, haskell-packages, haskell-src-meta, hlint, hoogle, hse-cpp, rest-gen, stylish-haskell, test-framework-th

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.