Safe Haskell	Safe-Inferred
Language	GHC2021

Stack.Ghci

Description

Types and functions related to Stack's ghci and repl commands.

Synopsis

data GhciOpts = GhciOpts {
- targets :: ![Text]
- args :: ![String]
- ghcOptions :: ![String]
- flags :: !(Map ApplyCLIFlag (Map FlagName Bool))
- ghcCommand :: !(Maybe FilePath)
- noLoadModules :: !Bool
- additionalPackages :: ![String]
- mainIs :: !(Maybe Text)
- loadLocalDeps :: !Bool
- hidePackages :: !(Maybe Bool)
- noBuild :: !Bool
- onlyMain :: !Bool
}
data GhciPkgInfo = GhciPkgInfo {
- name :: !PackageName
- opts :: ![(NamedComponent, BuildInfoOpts)]
- dir :: !(Path Abs Dir)
- modules :: !ModuleMap
- cFiles :: ![Path Abs File]
- mainIs :: !(Map NamedComponent [Path Abs File])
- targetFiles :: !(Maybe [Path Abs File])
- package :: !Package
}
data GhciException
data GhciPrettyException
- = GhciTargetParseException ![StyleDoc]
- | CandidatesIndexOutOfRangeBug
ghciCmd :: GhciOpts -> RIO Runner ()
ghci :: HasEnvConfig env => GhciOpts -> RIO env ()

Documentation

data GhciOpts Source #

Typre respresenting command line options for the stack ghci and stack repl commands.

Constructors

GhciOpts
Fields targets :: ![Text] args :: ![String] ghcOptions :: ![String] flags :: !(Map ApplyCLIFlag (Map FlagName Bool)) ghcCommand :: !(Maybe FilePath) noLoadModules :: !Bool additionalPackages :: ![String] mainIs :: !(Maybe Text) loadLocalDeps :: !Bool hidePackages :: !(Maybe Bool) noBuild :: !Bool onlyMain :: !Bool

Instances

Instances details

Show GhciOpts Source #
Instance details Defined in Stack.Ghci Methods showsPrec :: Int -> GhciOpts -> ShowS # show :: GhciOpts -> String # showList :: [GhciOpts] -> ShowS #

data GhciPkgInfo Source #

Type representing information required to load a package or its components.

NOTE: GhciPkgInfo has paths as list instead of a Set to preserve files order as a workaround for bug https://ghc.haskell.org/trac/ghc/ticket/13786

Constructors

GhciPkgInfo
Fields name :: !PackageName opts :: ![(NamedComponent, BuildInfoOpts)] dir :: !(Path Abs Dir) modules :: !ModuleMap cFiles :: ![Path Abs File] C files. mainIs :: !(Map NamedComponent [Path Abs File]) targetFiles :: !(Maybe [Path Abs File]) package :: !Package

Instances

Instances details

Show GhciPkgInfo Source #
Instance details Defined in Stack.Ghci Methods showsPrec :: Int -> GhciPkgInfo -> ShowS # show :: GhciPkgInfo -> String # showList :: [GhciPkgInfo] -> ShowS #

data GhciException Source #

Type representing exceptions thrown by functions exported by the Stack.Ghci module.

Constructors

InvalidPackageOption !String
LoadingDuplicateModules
MissingFileTarget !String
Can'tSpecifyFilesAndTargets
Can'tSpecifyFilesAndMainIs

Instances

Instances details

Exception GhciException Source #
Instance details Defined in Stack.Ghci Methods toException :: GhciException -> SomeException # fromException :: SomeException -> Maybe GhciException # displayException :: GhciException -> String #
Show GhciException Source #
Instance details Defined in Stack.Ghci Methods showsPrec :: Int -> GhciException -> ShowS # show :: GhciException -> String # showList :: [GhciException] -> ShowS #

data GhciPrettyException Source #

Type representing 'pretty' exceptions thrown by functions exported by the Stack.Ghci module.

Constructors

GhciTargetParseException ![StyleDoc]
CandidatesIndexOutOfRangeBug

Instances

Instances details

Exception GhciPrettyException Source #
Instance details Defined in Stack.Ghci Methods toException :: GhciPrettyException -> SomeException # fromException :: SomeException -> Maybe GhciPrettyException # displayException :: GhciPrettyException -> String #
Show GhciPrettyException Source #
Instance details Defined in Stack.Ghci Methods showsPrec :: Int -> GhciPrettyException -> ShowS # show :: GhciPrettyException -> String # showList :: [GhciPrettyException] -> ShowS #
Pretty GhciPrettyException Source #
Instance details Defined in Stack.Ghci Methods pretty :: GhciPrettyException -> StyleDoc #

ghciCmd :: GhciOpts -> RIO Runner () Source #

Function underlying the stack ghci and stack repl commands. Run GHCi in the context of a project.

ghci :: HasEnvConfig env => GhciOpts -> RIO env () Source #

Launch a GHCi session for the given project package targets with the given options and configure it with the load paths and extensions of those targets.