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.

haskellDefaultPreprocessorExts :: [Text]

Extensions for modules that are preprocessed by common preprocessors.

stackProgName :: String

Name of the Stack program.

stackProgName' :: Text

Name of the Stack program.

nixProgName :: String

Name of the Nix package manager command

stackDotYaml :: Path Rel File

The filename used for the Stack project-level configuration file.

stackWorkEnvVar :: String

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

stackRootEnvVar :: String

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

stackXdgEnvVar :: String

Environment variable used to indicate XDG directories should be used.

stackRootOptionName :: String

Option name for the global Stack root.

stackGlobalConfigOptionName :: String

Option name for the global Stack configuration file.

pantryRootEnvVar :: String

Environment variable used to override the location of the Pantry store

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

The comment to 'see https://downloads.haskell.org/~ghc/7.10.1/docs/html/libraries/ghc/src/Module.html#integerPackageKey\' appears to be out of date.

See 'Note [About units]' and 'Wired-in units' at https://gitlab.haskell.org/ghc/ghc/-/blob/master/compiler/GHC/Unit.hs.

The 'wired-in packages' appear to have been replaced by those that have (e.g)

ghc-options: -this-unit-id ghc-prim

in their Cabal file because they are 'magic'.

cabalPackageName :: PackageName

Just to avoid repetition and magic strings.

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.

defaultUserConfigPath :: Path Abs Dir -> Path Abs File

Default user global configuration path. Normally, getDefaultUserConfigPath should be used instead.

defaultGlobalConfigPath :: Maybe (Path Abs File)

Default global config path. On Windows, by design, this will be Nothing.

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

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.

osIsMacOS :: Bool

False if using Windows.

osIsWindows :: Bool

True if using Windows.

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

relDirGhci :: Path Rel Dir

relDirGhciScript :: Path Rel Dir

relDirPantry :: Path Rel Dir

relDirPrograms :: Path Rel Dir

relDirRoot :: Path Rel Dir

relDirUpperPrograms :: Path Rel Dir

relDirStackProgName :: Path Rel Dir

relDirStackWork :: Path Rel Dir

relFileReadmeTxt :: Path Rel File

relDirScript :: Path Rel Dir

relDirScripts :: 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

htmlDirSuffix :: Path Rel Dir

Suffix applied to a path to get the html directory.

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

relDirClang32 :: Path Rel Dir

relDirClang64 :: Path Rel Dir

relDirClangArm64 :: Path Rel Dir

relDirUcrt64 :: 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

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

relFileLibcMuslx86_64So1 :: Path Rel File

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]

ghcBootScript :: Path Rel File

Relative paths inside a GHC repo to the boot script.

ghcConfigureScript :: Path Rel File

Relative paths inside a GHC repo to the configure script.

ghcConfigureWindows :: [String]

Command applicable to GHC's configure script on Windows. See: https://gitlab.haskell.org/ghc/ghc/-/blob/master/hadrian/README.md

ghcConfigureMacOS :: [String]

Command applicable to GHC's configure script on macOS. See: https://gitlab.haskell.org/ghc/ghc/-/blob/master/hadrian/README.md

ghcConfigurePosix :: [String]

Command applicable to GHC's configure script on non-Windows, non-macOS. See: https://gitlab.haskell.org/ghc/ghc/-/blob/master/hadrian/README.md

relDirHadrian :: Path Rel Dir

relFileHadrianStackDotYaml :: Path Rel File

hadrianScriptsWindows :: [Path Rel File]

Relative paths inside a GHC repo to the Hadrian build batch script. The second path is maintained for compatibility with older GHC versions.

hadrianScriptsPosix :: [Path Rel File]

Relative paths inside a GHC repo to the Hadrian build shell script The second path is maintained for compatibility with older GHC versions.

libDirs :: [Path Abs Dir]

Used in Stack.Setup for detecting libc.musl-x86_64.so.1, see comments at use site

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

stackDeveloperModeDefault :: Bool

What should the default be for stack-developer-mode

isStackUploadDisabled :: Bool

What should the default be for stack-developer-mode

globalFooter :: String

The footer to the help for Stack's subcommands

gitHubBasicAuthType :: ByteString

The type for GitHub REST API HTTP 'Basic' authentication.

gitHubTokenEnvVar :: String

Environment variable to hold credentials for GitHub REST API HTTP 'Basic' authentication.

altGitHubTokenEnvVar :: String

Alternate environment variable to hold credentials for GitHub REST API HTTP 'Basic' authentication.

hackageBaseUrl :: Text