{-# LANGUAGE NoImplicitPrelude, CPP #-} module IHaskell.Eval.Util ( -- * Initialization initGhci, -- * Flags and extensions ** Set and unset flags. extensionFlag, setExtension, ExtFlag(..), setFlags, -- * Code Evaluation evalImport, removeImport, evalDeclarations, getType, getDescription, -- * Pretty printing doc, pprDynFlags, pprLanguages, -- * Monad-loops unfoldM, ) where import IHaskellPrelude import qualified Data.Text as T import qualified Data.Text.Lazy as LT import qualified Data.ByteString as BS import qualified Data.ByteString.Lazy as LBS import qualified Data.ByteString.Char8 as CBS -- GHC imports. import DynFlags import FastString import GHC import GhcMonad import HsImpExp import HscTypes import InteractiveEval import Module import Packages import RdrName import NameSet import Name import PprTyThing import InstEnv (ClsInst(..)) import Unify (tcMatchTys) import VarSet (mkVarSet) import qualified Pretty import qualified Outputable as O import Control.Monad (void) import Data.Function (on) import Data.List (nubBy) import StringUtils (replace) -- | A extension flag that can be set or unset. data ExtFlag = SetFlag ExtensionFlag | UnsetFlag ExtensionFlag -- | Find the extension that corresponds to a given flag. Create the corresponding 'ExtFlag' via -- @SetFlag@ or @UnsetFlag@. If no such extension exist, yield @Nothing@. extensionFlag :: String -- Extension name, such as @"DataKinds"@ -> Maybe ExtFlag extensionFlag ext = case find (flagMatches ext) xFlags of Just fs -> Just $ SetFlag $ flagSpecFlag fs -- If it doesn't match an extension name, try matching against disabling an extension. Nothing -> case find (flagMatchesNo ext) xFlags of Just fs -> Just $ UnsetFlag $ flagSpecFlag fs Nothing -> Nothing where -- Check if a FlagSpec matches an extension name. flagMatches ext fs = ext == flagSpecName fs -- Check if a FlagSpec matches "No". In that case, we disable the extension. flagMatchesNo ext fs = ext == "No" ++ flagSpecName fs #if !MIN_VERSION_ghc(7,10,0) flagSpecName (name, _, _) = name flagSpecFlag (_, flag, _) = flag #endif -- | Pretty-print dynamic flags (taken from 'InteractiveUI' module of `ghc-bin`) pprDynFlags :: Bool -- ^ Whether to include flags which are on by default -> DynFlags -> O.SDoc pprDynFlags show_all dflags = O.vcat [ O.text "GHCi-specific dynamic flag settings:" O.$$ O.nest 2 (O.vcat (map (setting opt) ghciFlags)) , O.text "other dynamic, non-language, flag settings:" O.$$ O.nest 2 (O.vcat (map (setting opt) others)) , O.text "warning settings:" O.$$ O.nest 2 (O.vcat (map (setting wopt) DynFlags.fWarningFlags)) ] where #if MIN_VERSION_ghc(7,8,0) opt = gopt #else opt = dopt #endif setting test flag | quiet = O.empty :: O.SDoc | is_on = fstr name :: O.SDoc | otherwise = fnostr name :: O.SDoc where name = flagSpecName flag f = flagSpecFlag flag is_on = test f dflags quiet = not show_all && test f default_dflags == is_on default_dflags = defaultDynFlags (settings dflags) fstr, fnostr :: String -> O.SDoc fstr str = O.text "-f" O.<> O.text str fnostr str = O.text "-fno-" O.<> O.text str (ghciFlags, others) = partition (\f -> flagSpecFlag f `elem` flgs) DynFlags.fFlags flgs = concat [flgs1, flgs2, flgs3] flgs1 = [Opt_PrintExplicitForalls] #if MIN_VERSION_ghc(7,8,0) flgs2 = [Opt_PrintExplicitKinds] #else flgs2 = [] #endif flgs3 = [Opt_PrintBindResult, Opt_BreakOnException, Opt_BreakOnError, Opt_PrintEvldWithShow] -- | Pretty-print the base language and active options (taken from `InteractiveUI` module of -- `ghc-bin`) pprLanguages :: Bool -- ^ Whether to include flags which are on by default -> DynFlags -> O.SDoc pprLanguages show_all dflags = O.vcat [ O.text "base language is: " O.<> case language dflags of Nothing -> O.text "Haskell2010" Just Haskell98 -> O.text "Haskell98" Just Haskell2010 -> O.text "Haskell2010" , (if show_all then O.text "all active language options:" else O.text "with the following modifiers:") O.$$ O.nest 2 (O.vcat (map (setting xopt) DynFlags.xFlags)) ] where setting test flag | quiet = O.empty | is_on = O.text "-X" O.<> O.text name | otherwise = O.text "-XNo" O.<> O.text name where name = flagSpecName flag f = flagSpecFlag flag is_on = test f dflags quiet = not show_all && test f default_dflags == is_on default_dflags = defaultDynFlags (settings dflags) `lang_set` case language dflags of Nothing -> Just Haskell2010 other -> other -- | Set an extension and update flags. Return @Nothing@ on success. On failure, return an error -- message. setExtension :: GhcMonad m => String -> m (Maybe String) setExtension ext = do flags <- getSessionDynFlags case extensionFlag ext of Nothing -> return $ Just $ "Could not parse extension name: " ++ ext Just flag -> do setSessionDynFlags $ case flag of SetFlag ghcFlag -> xopt_set flags ghcFlag UnsetFlag ghcFlag -> xopt_unset flags ghcFlag return Nothing -- | Set a list of flags, as per GHCi's `:set`. This was adapted from GHC's InteractiveUI.hs -- (newDynFlags). It returns a list of error messages. setFlags :: GhcMonad m => [String] -> m [String] setFlags ext = do -- Try to parse flags. flags <- getSessionDynFlags (flags', unrecognized, warnings) <- parseDynamicFlags flags (map noLoc ext) -- First, try to check if this flag matches any extension name. let restorePkg x = x { packageFlags = packageFlags flags } let restoredPkgs = flags' { packageFlags = packageFlags flags } GHC.setProgramDynFlags restoredPkgs GHC.setInteractiveDynFlags restoredPkgs -- Create the parse errors. let noParseErrs = map (("Could not parse: " ++) . unLoc) unrecognized allWarns = map unLoc warnings ++ ["-package not supported yet" | packageFlags flags /= packageFlags flags'] warnErrs = map ("Warning: " ++) allWarns return $ noParseErrs ++ warnErrs -- | Convert an 'SDoc' into a string. This is similar to the family of 'showSDoc' functions, but -- does not impose an arbitrary width limit on the output (in terms of number of columns). Instead, -- it respsects the 'pprCols' field in the structure returned by 'getSessionDynFlags', and thus -- gives a configurable width of output. doc :: GhcMonad m => O.SDoc -> m String doc sdoc = do flags <- getSessionDynFlags unqual <- getPrintUnqual let style = O.mkUserStyle unqual O.AllTheWay let cols = pprCols flags d = O.runSDoc sdoc (O.initSDocContext flags style) return $ Pretty.fullRender Pretty.PageMode cols 1.5 string_txt "" d where string_txt :: Pretty.TextDetails -> String -> String string_txt (Pretty.Chr c) s = c : s string_txt (Pretty.Str s1) s2 = s1 ++ s2 string_txt (Pretty.PStr s1) s2 = unpackFS s1 ++ s2 string_txt (Pretty.LStr s1 _) s2 = unpackLitString s1 ++ s2 -- | Initialize the GHC API. Run this as the first thing in the `runGhc`. This initializes some dyn -- flags (@ExtendedDefaultRules@, -- @NoMonomorphismRestriction@), sets the target to interpreted, link in -- memory, sets a reasonable output width, and potentially a few other -- things. It should be invoked before other functions from this module. -- -- We also require that the sandbox PackageConf (if any) is passed here -- as setSessionDynFlags will read the package database the first time -- (and only the first time) it is called. initGhci :: GhcMonad m => Maybe String -> m () initGhci sandboxPackages = do -- Initialize dyn flags. Start with -XExtendedDefaultRules and -XNoMonomorphismRestriction. originalFlags <- getSessionDynFlags let flag = flip xopt_set unflag = flip xopt_unset dflags = flag Opt_ExtendedDefaultRules . unflag Opt_MonomorphismRestriction $ originalFlags pkgConfs = case sandboxPackages of Nothing -> extraPkgConfs originalFlags Just path -> let pkg = PkgConfFile path in (pkg :) . extraPkgConfs originalFlags void $ setSessionDynFlags $ dflags { hscTarget = HscInterpreted , ghcLink = LinkInMemory , pprCols = 300 , extraPkgConfs = pkgConfs } -- | Evaluate a single import statement. If this import statement is importing a module which was -- previously imported implicitly (such as `Prelude`) or if this module has a `hiding` annotation, -- the previous import is removed. evalImport :: GhcMonad m => String -> m () evalImport imports = do importDecl <- parseImportDecl imports context <- getContext -- If we've imported this implicitly, remove the old import. let noImplicit = filter (not . implicitImportOf importDecl) context -- If this is a `hiding` import, remove previous non-`hiding` imports. oldImps = if isHiddenImport importDecl then filter (not . importOf importDecl) context else noImplicit -- Replace the context. setContext $ IIDecl importDecl : oldImps where -- Check whether an import is the same as another import (same module). importOf :: ImportDecl RdrName -> InteractiveImport -> Bool importOf _ (IIModule _) = False importOf imp (IIDecl decl) = ((==) `on` (unLoc . ideclName)) decl imp && not (ideclQualified decl) -- Check whether an import is an *implicit* import of something. implicitImportOf :: ImportDecl RdrName -> InteractiveImport -> Bool implicitImportOf _ (IIModule _) = False implicitImportOf imp (IIDecl decl) = ideclImplicit decl && imp `importOf` IIDecl decl -- Check whether an import is hidden. isHiddenImport :: ImportDecl RdrName -> Bool isHiddenImport imp = case ideclHiding imp of Just (True, _) -> True _ -> False removeImport :: GhcMonad m => String -> m () removeImport moduleName = do flags <- getSessionDynFlags ctx <- getContext let ctx' = filter (not . (isImportOf $ mkModuleName moduleName)) ctx setContext ctx' where isImportOf :: ModuleName -> InteractiveImport -> Bool isImportOf name (IIModule modName) = name == modName isImportOf name (IIDecl impDecl) = name == unLoc (ideclName impDecl) -- | Evaluate a series of declarations. Return all names which were bound by these declarations. evalDeclarations :: GhcMonad m => String -> m [String] evalDeclarations decl = do names <- runDecls decl cleanUpDuplicateInstances flags <- getSessionDynFlags return $ map (replace ":Interactive." "" . O.showPpr flags) names cleanUpDuplicateInstances :: GhcMonad m => m () cleanUpDuplicateInstances = modifySession $ \hscEnv -> let -- Get all class instances ic = hsc_IC hscEnv (clsInsts, famInsts) = ic_instances ic -- Remove duplicates clsInsts' = nubBy instEq clsInsts in hscEnv { hsc_IC = ic { ic_instances = (clsInsts', famInsts) } } where instEq :: ClsInst -> ClsInst -> Bool #if MIN_VERSION_ghc(7,8,0) -- Only support replacing instances on GHC 7.8 and up instEq c1 c2 | ClsInst { is_tvs = tpl_tvs, is_tys = tpl_tys, is_cls = cls } <- c1, ClsInst { is_tys = tpl_tys', is_cls = cls' } <- c2 = let tpl_tv_set = mkVarSet tpl_tvs in cls == cls' && isJust (tcMatchTys tpl_tv_set tpl_tys tpl_tys') #else instEq _ _ = False #endif -- | Get the type of an expression and convert it to a string. getType :: GhcMonad m => String -> m String getType expr = do result <- exprType expr flags <- getSessionDynFlags let typeStr = O.showSDocUnqual flags $ O.ppr result return typeStr -- | This is unfoldM from monad-loops. It repeatedly runs an IO action until it return Nothing, and -- puts all the Justs in a list. If you find yourself using more functionality from monad-loops, -- just add the package dependency instead of copying more code from it. unfoldM :: IO (Maybe a) -> IO [a] unfoldM f = maybe (return []) (\r -> (r :) <$> unfoldM f) =<< f -- | A wrapper around @getInfo@. Return info about each name in the string. getDescription :: GhcMonad m => String -> m [String] getDescription str = do names <- parseName str maybeInfos <- mapM getInfo' names -- Filter out types that have parents in the same set. GHCi also does this. let infos = catMaybes maybeInfos allNames = mkNameSet $ map (getName . getType) infos hasParent info = case tyThingParent_maybe (getType info) of Just parent -> getName parent `elemNameSet` allNames Nothing -> False filteredOutput = filter (not . hasParent) infos -- Print nicely mapM (doc . printInfo) filteredOutput where #if MIN_VERSION_ghc(7,8,0) getInfo' = getInfo False #else getInfo' = getInfo #endif #if MIN_VERSION_ghc(7,8,0) getType (theType, _, _, _) = theType #else getType (theType, _, _) = theType #endif #if MIN_VERSION_ghc(7,8,0) printInfo (thing, fixity, classInstances, famInstances) = pprTyThingInContextLoc thing O.$$ showFixity thing fixity O.$$ O.vcat (map GHC.pprInstance classInstances) O.$$ O.vcat (map GHC.pprFamInst famInstances) #else printInfo (thing, fixity, classInstances) = pprTyThingInContextLoc False thing O.$$ showFixity thing fixity O.$$ O.vcat (map GHC.pprInstance classInstances) #endif showFixity thing fixity = if fixity == GHC.defaultFixity then O.empty else O.ppr fixity O.<+> pprInfixName (getName thing)