Stack.Constants

Constants used throughout the project.

Documentation

buildPlanDir

Arguments

:: Path Abs Dir

Stack root

-> Path Abs Dir

Path where build plans are stored.

buildPlanCacheDir

Arguments

:: Path Abs Dir

Stack root

-> Path Abs Dir

Path where binary caches of the build plans are stored.

haskellFileExts :: [Text]

Extensions used for Haskell modules. Excludes preprocessor ones.

haskellPreprocessorExts :: [Text]

Extensions for modules that are preprocessed by common preprocessors.

stackDotYaml :: Path Rel File

The filename used for the stack config file.

stackWorkEnvVar :: String

Environment variable used to override the '.stack-work' relative dir.

stackRootEnvVar :: String

Environment variable used to override the '~/.stack' location.

stackRootOptionName :: String

Option name for the global stack root.

deprecatedStackRootOptionName :: String

Deprecated option name for the global stack root.

Deprecated since stack-1.1.0.

TODO: Remove occurences of this variable and use stackRootOptionName only after an appropriate deprecation period.

inContainerEnvVar :: String

Environment variable used to indicate stack is running in container.

inNixShellEnvVar :: String

Environment variable used to indicate stack is running in container. although we already have STACK_IN_NIX_EXTRA_ARGS that is set in the same conditions, it can happen that STACK_IN_NIX_EXTRA_ARGS is set to empty.

stackProgNameUpper :: String

Name of the stack program, uppercased

wiredInPackages :: Set PackageName

ghcjsBootPackages :: Set PackageName

cabalPackageName :: PackageName

Just to avoid repetition and magic strings.

implicitGlobalProjectDirDeprecated

Arguments

:: Path Abs Dir

Stack root.

-> Path Abs Dir

Deprecated implicit global project directory used when outside of a project.

implicitGlobalProjectDir

Arguments

:: Path Abs Dir

Stack root.

-> Path Abs Dir

Implicit global project directory used when outside of a project. Normally, getImplicitGlobalProjectDir should be used instead.

defaultUserConfigPathDeprecated :: Path Abs Dir -> Path Abs File

Deprecated default global config path.

defaultUserConfigPath :: Path Abs Dir -> Path Abs File

Default global config path. Normally, getDefaultUserConfigPath should be used instead.

defaultGlobalConfigPathDeprecated :: Maybe (Path Abs File)

Deprecated default global config path. Note that this will be Nothing on Windows, which is by design.

defaultGlobalConfigPath :: Maybe (Path Abs File)

Default global config path. Normally, getDefaultGlobalConfigPath should be used instead. Note that this will be Nothing on Windows, which is by design.

platformVariantEnvVar :: String

Environment variable that stores a variant to append to platform-specific directory names. Used to ensure incompatible binaries aren't shared between Docker builds and host

compilerOptionsCabalFlag :: WhichCompiler -> String

Provides --ghc-options for Ghc, and similarly, --ghcjs-options for Ghcjs.

ghcColorForceFlag :: String

The flag to pass to GHC when we want to force its output to be colorized.

minTerminalWidth :: Int

The minimum allowed terminal width. Used for pretty-printing.

maxTerminalWidth :: Int

The maximum allowed terminal width. Used for pretty-printing.

defaultTerminalWidth :: Int

The default terminal width. Used for pretty-printing when we can't automatically detect it and when the user doesn't supply one.

osIsWindows :: Bool

True if using Windows OS.

relFileSetupHs :: Path Rel File

relFileSetupLhs :: Path Rel File

relFileHpackPackageConfig :: Path Rel File

relDirGlobalAutogen :: Path Rel Dir

relDirAutogen :: Path Rel Dir

relDirLogs :: Path Rel Dir

relFileCabalMacrosH :: Path Rel File

relDirBuild :: Path Rel Dir

relDirBin :: Path Rel Dir

relDirPantry :: Path Rel Dir

relDirPrograms :: Path Rel Dir

relDirUpperPrograms :: Path Rel Dir

relDirStackProgName :: Path Rel Dir

relDirStackWork :: Path Rel Dir

relFileReadmeTxt :: Path Rel File

relDirScript :: Path Rel Dir

relFileConfigYaml :: Path Rel File

relDirSnapshots :: Path Rel Dir

relDirGlobalHints :: Path Rel Dir

relFileGlobalHintsYaml :: Path Rel File

relDirInstall :: Path Rel Dir

relDirCompilerTools :: Path Rel Dir

relDirHoogle :: Path Rel Dir

relFileDatabaseHoo :: Path Rel File

relDirPkgdb :: Path Rel Dir

relFileStorage :: Path Rel File

relDirLoadedSnapshotCache :: Path Rel Dir

bindirSuffix :: Path Rel Dir

Suffix applied to an installation root to get the bin dir

docDirSuffix :: Path Rel Dir

Suffix applied to an installation root to get the doc dir

relDirHpc :: Path Rel Dir

relDirLib :: Path Rel Dir

relDirShare :: Path Rel Dir

relDirLibexec :: Path Rel Dir

relDirEtc :: Path Rel Dir

setupGhciShimCode :: Builder

relDirSetupExeCache :: Path Rel Dir

relDirSetupExeSrc :: Path Rel Dir

relFileConfigure :: Path Rel File

relDirDist :: Path Rel Dir

relFileSetupMacrosH :: Path Rel File

relDirSetup :: Path Rel Dir

relFileSetupLower :: Path Rel File

relDirMingw :: Path Rel Dir

relDirMingw32 :: Path Rel Dir

relDirMingw64 :: Path Rel Dir

relDirLocal :: Path Rel Dir

relDirUsr :: Path Rel Dir

relDirInclude :: Path Rel Dir

relFileIndexHtml :: Path Rel File

relDirAll :: Path Rel Dir

relFilePackageCache :: Path Rel File

relFileDockerfile :: Path Rel File

relDirHaskellStackGhci :: Path Rel Dir

relFileGhciScript :: Path Rel File

relDirCombined :: Path Rel Dir

relFileHpcIndexHtml :: Path Rel File

relDirCustom :: Path Rel Dir

relDirPackageConfInplace :: Path Rel Dir

relDirExtraTixFiles :: Path Rel Dir

relDirInstalledPackages :: Path Rel Dir

backupUrlRelPath :: Path Rel File

relDirDotLocal :: Path Rel Dir

relDirDotSsh :: Path Rel Dir

relDirDotStackProgName :: Path Rel Dir

relDirUnderHome :: Path Rel Dir

relDirSrc :: Path Rel Dir

relFileLibtinfoSo5 :: Path Rel File

relFileLibtinfoSo6 :: Path Rel File

relFileLibncurseswSo6 :: Path Rel File

relFileLibgmpSo10 :: Path Rel File

relFileLibgmpSo3 :: Path Rel File

relDirNewCabal :: Path Rel Dir

relFileSetupExe :: Path Rel File

relFileSetupUpper :: Path Rel File

relFile7zexe :: Path Rel File

relFile7zdll :: Path Rel File

relFileMainHs :: Path Rel File

relFileStack :: Path Rel File

relFileStackDotExe :: Path Rel File

relFileStackDotTmpDotExe :: Path Rel File

relFileStackDotTmp :: Path Rel File

ghcShowOptionsOutput :: [String]

hadrianCmdWindows :: Path Rel File

Relative path inside a GHC repo to the Hadrian build batch script

hadrianCmdPosix :: Path Rel File

Relative path inside a GHC repo to the Hadrian build shell script

usrLibDirs :: [Path Abs Dir]

Used in Stack.Setup for detecting libtinfo, see comments at use site

testGhcEnvRelFile :: Path Rel File

Relative file path for a temporary GHC environment file for tests

relFileBuildLock :: Path Rel File

File inside a dist directory to use for locking