haskell-src-meta-0.6.0.10: Parse source to template-haskell abstract syntax.

Safe HaskellNone
LanguageHaskell98

Language.Haskell.Meta.Utils

Description

This module is a staging ground for to-be-organized-and-merged-nicely code.

Synopsis

Documentation

cleanNames :: Data a => a -> a

pretty :: Show a => a -> String

The type passed in must have a Show instance which produces a valid Haskell expression. Returns an empty String if this is not the case. This is not TH-specific, but useful in general.

pp :: (Data a, Ppr a) => a -> String

ppDoc :: (Data a, Ppr a) => a -> Doc

gpretty :: Data a => a -> String

unsafeRunQ :: Q a -> a

unsafeRunQ = unsafePerformIO . runQ

(|$|) :: ExpQ -> ExpQ -> ExpQ infixr 0

(|.|) :: ExpQ -> ExpQ -> ExpQ infixr 9

(|->|) :: TypeQ -> TypeQ -> TypeQ infixr 9

myNames :: [Name]

Infinite list of names composed of lowercase letters

renameThings :: (t1 -> t2 -> t -> (a, t1, t2)) -> t1 -> t2 -> [a] -> [t] -> ([a], t1, t2)

Generalisation of renameTs

renameTs :: [(Name, Name)] -> [Name] -> [Type] -> [Type] -> ([Type], [(Name, Name)], [Name])

renameT applied to a list of types

renameT :: [(Name, Name)] -> [Name] -> Type -> (Type, [(Name, Name)], [Name])

Rename type variables in the Type according to the given association list. Normalise constructor names (remove qualification, etc.) If a name is not found in the association list, replace it with one from the fresh names list, and add this translation to the returned list. The fresh names list should be infinite; myNames is a good example.

normaliseName :: Name -> Name

Remove qualification, etc.

applyT :: Type -> Type -> Type

substT :: [(Name, Type)] -> [Name] -> Type -> Type

splitCon :: Con -> (Name, [Type])

conTypes :: Con -> [Type]

decCons :: Dec -> [Con]

unwindT :: Type -> [Type]

unwindE :: Exp -> [Exp]

arityT :: Type -> Int

The arity of a Type.

nameSpaceOf :: Name -> Maybe NameSpace

Randomly useful.

dataDCons :: Dec -> [Con]

mkFunD :: Name -> [Pat] -> Exp -> Dec

toExpQ :: Lift a => (String -> Q a) -> String -> ExpQ

The strategy for producing QuasiQuoters which this datatype aims to facilitate is as follows. Given a collection of datatypes which make up the to-be-quasiquoted languages AST, make each type in this collection an instance of at least Show and Lift. Now, assuming parsePat and parseExp, both of type String -> Q a (where a is the top level type of the AST), are the pair of functions you wish to use for parsing in pattern and expression context respectively, put them inside a Quoter datatype and pass this to quasify.

toPatQ :: Show a => (String -> Q a) -> String -> PatQ

showToPatQ :: Show a => a -> PatQ

eitherQ :: (e -> String) -> Either e a -> Q a

normalizeT :: Data a => a -> a