TH.Utilities

Get the Name of a TyVarBndr

Breaks a type application like A b c into [A, b, c]. In other words, it descends leftwards down AppT constructors, and yields a list of the results.

Given a list of types, produce the type of a tuple of those types. This is analogous to tupE and tupP.

tupT [[t|Int|], [t|Char|], [t|Bool]] = [t| (Int, Char, Bool) |]

@since FIXME

Given a list of types, produce the type of a promoted tuple of those types. This is analogous to tupE and tupP.

promotedTupT [[t|3|], [t| 'True|], [t|Bool]] = [t| '(3, 'True, Bool) |]

@since FIXME

Given a Type, returns a Just value if it's a named type constructor applied to arguments. This value contains the name of the type and a list of arguments.

Expect the provided type to be an application of a regular type to one argument, otherwise fail with a message. This will also work if the name is a promoted data constructor (PromotedT).

Expect the provided type to be an application of a regular type to two arguments, otherwise fail with a message. This will also work if the name is a promoted data constructor (PromotedT).

Given a type, construct the expression (Proxy :: Proxy ty).

Like the everywhere generic traversal strategy, but skips over strings. This can aid performance of TH traversals quite a bit.

Like the everywhereM generic traversal strategy, but skips over strings. This can aid performance of TH traversals quite a bit.

Make a Name with a NameS or NameQ flavour, from a Name with any NameFlavour. This may change the meaning of names.

Construct a plain name (mkName) based on the given name. This is useful for cases where TH doesn't expect a unique name.

Apply dequalify to every type variable.

Get the free type variables of a Type.

Utility to conveniently handle change to InstanceD API in template-haskell-2.11.0

Utility to conveniently handle change to InstanceD API in template-haskell-2.11.0

Utility to convert Data.Typeable TypeRep to a Type. Note that this function is known to not yet work for many cases, but it does work for normal user datatypes. In future versions this function might have better behavior.

Hack to enable putting expressions inside lift-ed TH data. For example, you could do

    main = print $(lift [ExpLifter [e| 1 + 1 |],  ExpLifter [e| 2 |]])

Here, lift is working on a value of type [ExpLifter]. The code generated by lift constructs a list with the ExpLifter expressions providing the element values.

Without ExpLifter, lift tends to just generate code involving data construction. With ExpLifter, you can put more complicated expression into this construction.

Note that this cannot be used in typed quotes, because liftTyped will throw an exception. This is because this hack is incompatible with the type of liftTyped, as it would require the generated code to have type ExpLifter.

Print splices generated by a TH splice (the printing will happen during compilation, as a GHC warning). Useful for debugging.

For instance, you can dump splices generated with makeLenses by replacing a top-level invocation of makeLenses in your code with:

dumpSplices $ makeLenses ''Foo