ghc-tcplugins-extra-0.3: Utilities for writing GHC type-checker plugins

Copyright(C) 2015-2016 University of Twente
LicenseBSD2 (see the file LICENSE)
MaintainerChristiaan Baaij <christiaan.baaij@gmail.com>
Safe HaskellNone
LanguageHaskell2010
Extensions
  • Cpp
  • DisambiguateRecordFields
  • RecordWildCards
  • LambdaCase
  • PatternSynonyms

GHC.TcPluginM.Extra

Contents

Description

 
Synopsis

Create new constraints

newWanted :: CtLoc -> PredType -> TcPluginM CtEvidence Source #

Create a new [W]anted constraint.

newGiven :: CtLoc -> PredType -> EvTerm -> TcPluginM CtEvidence Source #

Create a new [G]iven constraint, with the supplied evidence. This must not be invoked from tcPluginInit or tcPluginStop, or it will panic.

newDerived :: CtLoc -> PredType -> TcPluginM CtEvidence Source #

Create a new [D]erived constraint.

Creating evidence

evByFiat Source #

Arguments

:: String

Name the coercion should have

-> Type

The LHS of the equivalence relation (~)

-> Type

The RHS of the equivalence relation (~)

-> EvTerm 

The EvTerm equivalent for unsafeCoerce

Lookup

lookupModule Source #

Arguments

:: ModuleName

Name of the module

-> FastString

Name of the package containing the module

-> TcPluginM Module 

Find a module

Trace state of the plugin

tracePlugin :: String -> TcPlugin -> TcPlugin Source #

Print out extra information about the initialisation, stop, and every run of the plugin when -ddump-tc-trace is enabled.

Substitutions (GHC 8.4+)

flattenGivens :: [Ct] -> [Ct] Source #

Flattens evidence of constraints by substituting each others equalities.

NB: Should only be used on [G]iven constraints!

NB: Doesn't flatten under binders

NB: Only available on GHC 8.4+

mkSubst :: Ct -> Maybe ((TcTyVar, TcType), Ct) Source #

Create simple substitution from type equalities

NB: Only available on GHC 8.4+

mkSubst' :: [Ct] -> [((TcTyVar, TcType), Ct)] Source #

Create flattened substitutions from type equalities, i.e. the substitutions have been applied to each others right hand sides.

NB: Only available on GHC 8.4+

substType :: [(TcTyVar, TcType)] -> TcType -> TcType Source #

Apply substitutions in Types

NB: Doesn't substitute under binders

NB: Only available on GHC 8.4+

substCt :: [(TcTyVar, TcType)] -> Ct -> Ct Source #

Apply substitution in the evidence of Cts

NB: Only available on GHC 8.4+