Safe Haskell	None
Language	Haskell2010

Development.IDE.Session

Description

The logic for setting up a ghcide session by tapping into hie-bios.

Synopsis

data SessionLoadingOptions = SessionLoadingOptions {
- findCradle :: FilePath -> IO (Maybe FilePath)
- loadCradle :: FilePath -> IO (Cradle Void)
- getCacheDirs :: String -> [String] -> IO CacheDirs
- getInitialGhcLibDir :: IO (Maybe LibDir)
- fakeUid :: InstalledUnitId
}
data CacheDirs = CacheDirs {
- hiCacheDir, hieCacheDir, oCacheDir :: Maybe FilePath
}
loadSession :: FilePath -> IO (Action IdeGhcSession)
loadSessionWithOptions :: SessionLoadingOptions -> FilePath -> IO (Action IdeGhcSession)
setInitialDynFlags :: SessionLoadingOptions -> IO (Maybe LibDir)
getHieDbLoc :: FilePath -> IO FilePath
runWithDb :: FilePath -> (HieDb -> IndexQueue -> IO ()) -> IO ()

Documentation

data SessionLoadingOptions Source #

Constructors

SessionLoadingOptions

Fields

findCradle :: FilePath -> IO (Maybe FilePath)
loadCradle :: FilePath -> IO (Cradle Void)
getCacheDirs :: String -> [String] -> IO CacheDirs
Given the project name and a set of command line flags, return the path for storing generated GHC artifacts, or Nothing to respect the cradle setting
getInitialGhcLibDir :: IO (Maybe LibDir)
Return the GHC lib dir to use for the unsafeGlobalDynFlags
fakeUid :: InstalledUnitId
unit id used to tag the internal component built by ghcide To reuse external interface files the unit ids must match, thus make sure to build them with `--this-unit-id` set to the same value as the ghcide fake uid

Instances

Instances details

Default SessionLoadingOptions Source #
Instance details Defined in Development.IDE.Session Methods def :: SessionLoadingOptions #

data CacheDirs Source #

Constructors

CacheDirs
Fields hiCacheDir, hieCacheDir, oCacheDir :: Maybe FilePath

loadSession :: FilePath -> IO (Action IdeGhcSession) Source #

Given a root directory, return a Shake Action which setups an IdeGhcSession given a file. Some of the many things this does:

Find the cradle for the file
Get the session options,
Get the GHC lib directory
Make sure the GHC compiletime and runtime versions match
Restart the Shake session

This is the key function which implements multi-component support. All components mapping to the same hie.yaml file are mapped to the same HscEnv which is updated as new components are discovered.

loadSessionWithOptions :: SessionLoadingOptions -> FilePath -> IO (Action IdeGhcSession) Source #

setInitialDynFlags :: SessionLoadingOptions -> IO (Maybe LibDir) Source #

Sets unsafeGlobalDynFlags on using the hie-bios cradle and returns the GHC libdir

getHieDbLoc :: FilePath -> IO FilePath Source #

runWithDb :: FilePath -> (HieDb -> IndexQueue -> IO ()) -> IO () Source #

Wraps withHieDb to provide a database connection for reading, and a HieWriterChan for writing. Actions are picked off one by one from the HieWriterChan and executed in serial by a worker thread using a dedicated database connection. This is done in order to serialize writes to the database, or else SQLite becomes unhappy